Cette page a été traduite par l'API Cloud Translation.

Obtenir un itinéraire économe en carburant

Par défaut, l'API Routes renvoie la route par défaut, c'est-à-dire une route sans tenir compte de l'efficacité énergétique ou du carburant. Quand vous activez les applications routage, vous obtenez toujours la route par défaut dans la réponse. En outre, vous avez aussi obtenez un itinéraire économe en carburant ou en énergie en fonction du type de moteur de votre véhicule.

L'itinéraire économe en carburant renvoyé par l'API Routes est optimisé pour de baisse de la consommation de carburant sur l'ensemble de l'itinéraire. L'API utilise le moteur de votre véhicule ainsi que d'autres facteurs tels que le trafic en temps réel et les conditions de circulation choisissez l'itinéraire économe en carburant. Plus l'itinéraire est économe en carburant ou en énergie, réduire la consommation de carburant et d'énergie et les émissions de CO2 de votre voiture.

Par exemple, l'avantage d'un véhicule diesel en termes de consommation de carburant relative est généralement sur autoroute. Les véhicules hybrides et électriques ont tendance à offrir L'efficacité des trajets en ville en ville et sur les routes vallonnées est progressivement plus efficace des environnements dans lesquels ils peuvent exploiter et tirer pleinement parti le freinage.

Vous pouvez également demander à l'API de renvoyer l'estimation de la consommation de carburant pour l'intégralité de la route. Utiliser les estimations de consommation de carburant pour comparer et non des estimations explicites de la consommation de carburant pour votre véhicule.

Comment Google Maps estime la consommation de carburant

L'API Routes estime la consommation de carburant à l'aide d'insights provenant des États-Unis Ministère de l'Énergie Laboratoire national des énergies renouvelables et les données de l'Agence européenne pour l'environnement. Ce calcul tient compte de facteurs qui ont une incidence sur votre consommation de carburant et d'énergie, ainsi que sur les émissions de CO2, par exemple:

la consommation moyenne de carburant ou d'énergie des véhicules de votre région ;
l'inclinaison des pentes sur votre trajet ;
les tendances de circulation en accordéon ;
le type de route (départementale ou autoroute, par exemple).

L'API Routes renvoie l'itinéraire le plus économe en carburant ou en énergie lorsqu'elle à peu près à la même heure d'arrivée que l'itinéraire par défaut. Dans les cas où le carburant ou d'économies d'énergie trop faibles ou qui augmentent considérablement le temps de trajet, l'API affiche les économies relatives en carburant ou en énergie entre les itinéraires pour vous aider à les comparer.

En savoir plus sur la technologie de calcul d'itinéraires économes en carburant (PDF)

Prérequis

Pour utiliser les itinéraires économes en carburant ou estimer la consommation de carburant:

Vous devez spécifier TRAFFIC_AWARE_OPTIMAL comme préférence de routage. Dans ce le serveur effectue une recherche plus exhaustive du réseau routier trouver l’itinéraire optimal. Pour en savoir plus, consultez Configurez la qualité ou la latence.
Vous devez définir travelMode sur DRIVE. Demandes concernant tout autre mode de transport renvoie une erreur.
Vous devez définir l'emplacement du point de cheminement de départ dans une région où le service est disponible. Sinon, l'API renvoie une erreur.
L'itinéraire ne peut pas contenir de point de cheminement intermédiaire.

Facturation

En règle générale, Google Maps Platform ne facture pas l'utilisation d'une version preview . Cependant, comme les itinéraires économes en carburant et la consommation estimée de carburant nécessite de spécifier TRAFFIC_AWARE_OPTIMAL comme préférence de routage, sont facturés en fonction du SKU: Routes Paramètres avancés.

En savoir plus sur la facturation de l'API Routes.

Demander un itinéraire économe en carburant

Pour demander le calcul d'un itinéraire économe en carburant, définissez les propriétés suivantes dans la requête:

Spécifiez emissionType pour le véhicule en utilisant les valeurs définies dans VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC ou HYBRID. La valeur par défaut est GASOLINE
Définissez requestedReferenceRoutes sur FUEL_EFFICIENT.
Définir un masque de champ de réponse spécifiant qu'il faut renvoyer les propriétés de la réponse associé à un itinéraire économe en carburant:
- routes.routeLabels: identifie chaque itinéraire en tant que DEFAULT_ROUTE, FUEL_EFFICIENT ou DEFAULT_ROUTE_ALTERNATE.
- routes.routeToken: : jeton de route que vous pouvez transmettre au le SDK Navigation pour récupérer route personnalisée.

Exemple de demande écoresponsable

Le code suivant montre une demande d'itinéraire économe en carburant. Dans cet exemple, vous utilisez le masque de champ de réponse pour renvoyer les propriétés de réponse associées à un itinéraire plus économe en carburant le long du routes.distanceMeters et Propriétés routes.duration:

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "routeModifiers": {
    "vehicleInfo": {
      "emissionType": "GASOLINE"
    }
  },
  "travelMode":"DRIVE",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL",
  "requestedReferenceRoutes": ["FUEL_EFFICIENT"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Exemple de réponse écoresponsable

L'appel computeRoutes ci-dessus génère une réponse JSON contenant deux itinéraires: l'itinéraire par défaut et l'itinéraire économe en carburant. Dans la réponse :

Pour la route par défaut, la propriété de tableau routeLabels contient DEFAULT_ROUTE
Pour l'itinéraire économe en carburant, la propriété de tableau routeLabels contient FUEL_EFFICIENT
Si vous définissez computeAlternativeRoutes dans la requête pour true afin de calculer routes alternatives, la propriété de tableau routeLabels contient DEFAULT_ROUTE_ALTERNATE.

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

En fonction des conditions de conduite actuelles et d'autres facteurs, l'itinéraire par défaut et l'itinéraire écoresponsable peut être le même. Dans ce cas, routeLabels contient les deux étiquettes: DEFAULT_ROUTE et FUEL_EFFICIENT:

{
  "routes": [
    {
      "distanceMeters": 45875,
      "duration": "2655s",
      "routeToken": "CvcDCos…6I40",
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ]
    }
  ]
}

Estimer la consommation de carburant de l'itinéraire

Vous pouvez demander à la méthode d'obtenir une estimation de la consommation de carburant pour l'intégralité en microlitres. Pour ajouter une estimation de la consommation de carburant d'un itinéraire vers réponse:

Définissez le champ de tableau extraComputations sur FUEL_CONSUMPTION pour activer le la consommation de carburant.
Spécifiez emissionType pour le véhicule en utilisant les valeurs définies dans VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC ou HYBRID. La valeur par défaut est GASOLINE

Si emissionType est défini sur HYBRID, l'API convertit l'électricité et le carburant. en microlitres de carburant.

Si emissionType est ELECTRIC, l'API convertit l'électricité en microlitres de carburant.
Définit un masque de champ de réponse spécifiant à renvoyer les propriétés de la réponse. associées à la consommation de carburant: routes.travelAdvisory.fuelConsumptionMicroliters

L'exemple suivant demande une estimation de la consommation de carburant dans le cadre d'une requête comprend également l'itinéraire économe en carburant:

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "routeModifiers": {
    "vehicleInfo": {
      "emissionType": "GASOLINE"
    }
  },
  "travelMode":"DRIVE",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL",
  "extraComputations": ["FUEL_CONSUMPTION"],
  "requestedReferenceRoutes": ["FUEL_EFFICIENT"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken,routes.travelAdvisory.fuelConsumptionMicroliters' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

La réponse contient une estimation de la consommation de carburant pour l'itinéraire par défaut et pour l'itinéraire économe en carburant:

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "travelAdvisory": {
                "fuelConsumptionMicroliters": "11019554"
            },
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "travelAdvisory": {
                "fuelConsumptionMicroliters": "9572436"
            },
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

Régions où le service est disponible

L'équipe Google Maps Platform s'efforce en permanence d'améliorer l'internationalisation pour nos services d'API. La liste suivante présente les dernières actualités pays par pays, pour mettre en place des itinéraires économes en carburant:

Albanie (AL)
Autriche (AT)
Belgique (BE)
Bosnie-Herzégovine (BA)
Bulgarie (BG)
Canada (CA)
Croatie (HR)
Chypre (CY)
Tchéquie (CZ)
Danemark (DK)
Estonie (EE)
Finlande (FI)
France (FR)
Allemagne (DE)
Grèce (GR)
Hongrie (HU)
Islande (IS)
Irlande (IE)
Italie (IT)
Kosovo (XK)
Lettonie (LV)
Liechtenstein (LI)
Lituanie (LT)
Luxembourg (LU)
Malte (MT)
Monténégro (ME)
Pays-Bas (NL)
Macédoine du Nord (MK)
Norvège (NO)
Pologne (PL)
Portugal (PT)
Roumanie (RO)
Serbie (RS)
Slovaquie (SK)
Slovénie (SI)
Espagne (ES)
Suède (SE)
Suisse (CH)
Turquie (TR)
Royaume-Uni (GB)
États-Unis (US)