Standardmäßig gibt die Routes API die Route default zurück, d. h. eine Route ohne Kraftstoff- oder Energieeffizienz. Wenn Sie das spritsparende Routing aktivieren, wird in der Antwort weiterhin die Standardroute angegeben. Außerdem wird eine spritsparende Route angezeigt, die die kraftstoff- oder energieeffizienteste Route für den Motortyp Ihres Fahrzeugs zeigt.
Die von der Routes API zurückgegebene spritsparende Route ist für einen geringeren Kraftstoffverbrauch auf der gesamten Route optimiert. Die API wählt den Motortyp des Fahrzeugs sowie andere Faktoren wie Verkehrs- und Straßenverhältnisse in Echtzeit aus, um die spritsparende Route auszuwählen. Je kraftstoff- oder energieeffizienter die Route ist, desto geringer sind der Kraftstoff-/Energieverbrauch und die CO2-Emissionen Ihres Autos.
Der relative Kraftstoffverbrauch eines Dieselfahrzeugs ist beispielsweise bei Autobahnfahrten im Allgemeinen am größten. Hybrid- und Elektrofahrzeuge bieten in der Regel bei Stop-and-go-Nutzung in der Stadt und bei hügeligen Fahrumgebungen zunehmend mehr Effizienz, wo sie intensiv genutzt und von der regenerativen Bremsung profitieren können.
Sie können auch anfordern, dass die API den geschätzten Kraftstoffverbrauch für die gesamte Route zurückgibt. Verwenden Sie die Schätzungen zum Kraftstoffverbrauch, um verschiedene Routen zu vergleichen, und nicht als genaue Kraftstoffschätzungen für Ihr Fahrzeug.
So schätzt Google Maps die Kraftstoffeffizienz
Die Routes API schätzt die Kraftstoffeffizienz anhand von Erkenntnissen des National Renewable Energy Laboratory (Nationales Labor für erneuerbare Energien) des US-amerikanischen Energieministeriums und Daten der Europäischen Umweltagentur. Diese Berechnung berücksichtigt Faktoren, die sich auf Ihren Kraftstoff- und Energieverbrauch sowie Ihre CO2-Emissionen auswirken. Dazu gehören:
- Durchschnittlicher Kraftstoff- oder Energieverbrauch für Fahrzeuge in Ihrer Region
- Steilheit von Erhebungen auf Ihrer Route
- Stop-and-go-Verkehrsmuster
- Straßentypen, etwa Landstraßen oder Autobahnen
Die Routes API gibt die kraftstoff- oder energieeffizienteste Route zurück, wenn sie ungefähr die gleiche Ankunftszeit wie die Standardroute hat. Wenn Kraftstoff- oder Energieeinsparungen zu gering sind oder die Fahrzeit erheblich verlängert, zeigt die API die relativen Kraftstoff- oder Energieeinsparungen zwischen Routen an, damit Sie sie vergleichen können.
Weitere Informationen zur kraftstoffsparenden Routenplanung (PDF in englischer Sprache)
Voraussetzungen
So verwenden Sie die spritsparende Routenplanung oder schätzen den Kraftstoffverbrauch:
Sie müssen
TRAFFIC_AWARE_OPTIMAL
als Routingeinstellung angeben. In diesem Modus führt der Server eine umfassendere Suche im Straßennetz durch, um die optimale Route zu ermitteln. Weitere Informationen finden Sie unter Qualität oder Latenz konfigurieren.Sie müssen
travelMode
aufDRIVE
festlegen. Bei Anfragen für andere Mobilitätsformen wird ein Fehler zurückgegeben.Sie müssen einen Standort für den Ausgangswegpunkt in einer unterstützten Region festlegen. Andernfalls gibt die API einen Fehler zurück.
Die Route darf keinen Wegpunkt enthalten.
Abrechnung
In der Regel fallen bei der Google Maps Platform keine Gebühren für die Nutzung einer Funktion in der Vorabversion an. Da für die kraftstoffsparende Routenplanung und die Schätzung des Kraftstoffverbrauchs jedoch TRAFFIC_AWARE_OPTIMAL
als Routingpräferenz angegeben werden muss, werden Ihnen die Kosten anhand der SKU: Routes Advanced berechnet.
Weitere Informationen zur Abrechnung für die Routes API
Kraftstoffsparende Route anfordern
Legen Sie für eine Anfrage zur Berechnung einer umweltfreundlichen Route die folgenden Attribute fest:
Geben Sie
emissionType
für das Fahrzeug mit den in VehicleEmissionType definierten Werten an:DIESEL
,GASOLINE
,ELECTRIC
oderHYBRID
. Der Standardwert istGASOLINE
.Setzen Sie
requestedReferenceRoutes
aufFUEL_EFFICIENT
.Legen Sie eine Antwortfeldmaske fest, mit der die Antwortattribute zurückgegeben werden sollen, die mit einer spritsparenden Route verknüpft sind:
routes.routeLabels:
: Kennzeichnet jede Route alsDEFAULT_ROUTE
,FUEL_EFFICIENT
oderDEFAULT_ROUTE_ALTERNATE
.routes.routeToken:
: Ein Routentoken, das Sie an das Navigation SDK übergeben können, um eine benutzerdefinierte Route abzurufen.
Beispiel für einen Antrag auf umweltfreundliche Werbung
Der folgende Code zeigt eine Anfrage für eine spritsparende Route. In diesem Beispiel verwenden Sie die Antwortfeldmaske, um Antwortattribute zurückzugeben, die einer spritsparenden Route zugeordnet sind, zusammen mit den Attributen routes.distanceMeters
und 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'
Beispiel für eine umweltbewusste Reaktion
Der obige computeRoutes
-Aufruf generiert eine JSON-Antwort, die zwei Routen enthält: die Standardroute und die spritsparende Route. In der Antwort:
Für die Standardroute enthält das Arrayattribut
routeLabels
DEFAULT_ROUTE
.Für die spritsparende Route enthält das Array-Attribut
routeLabels
den WertFUEL_EFFICIENT
.Wenn Sie
computeAlternativeRoutes
in der Anfrage auftrue
festlegen, um alternative Routen zu berechnen, enthält das ArrayattributrouteLabels
DEFAULT_ROUTE_ALTERNATE
.
{ "routes": [ { "distanceMeters": 138939, "duration": "5412s", "routeToken": "CoYJCpoIC…0n9S1cu", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 116887, "duration": "5631s", "routeToken": "CuEHCu0G…xqm", "routeLabels": [ "FUEL_EFFICIENT" ] } ] }
Aufgrund der aktuellen Fahrbedingungen und anderer Faktoren kann die Standardroute und die spritsparende Route identisch sein. In diesem Fall enthält routeLabels
die beiden Labels DEFAULT_ROUTE
und FUEL_EFFICIENT
:
{ "routes": [ { "distanceMeters": 45875, "duration": "2655s", "routeToken": "CvcDCos…6I40", "routeLabels": [ "DEFAULT_ROUTE", "FUEL_EFFICIENT" ] } ] }
Den Kraftstoffverbrauch für die Route schätzen
Sie können die Methode anfordern, um den geschätzten Kraftstoffverbrauch für die gesamte Route in Mikroliter zurückzugeben. So fügen Sie der Antwort den geschätzten Kraftstoffverbrauch für eine Route hinzu:
Legen Sie das Array-Feld
extraComputations
aufFUEL_CONSUMPTION
fest, um die Berechnung des Kraftstoffverbrauchs zu aktivieren.Geben Sie
emissionType
für das Fahrzeug mit den in VehicleEmissionType definierten Werten an:DIESEL
,GASOLINE
,ELECTRIC
oderHYBRID
. Der Standardwert istGASOLINE
.Wenn
emissionType
aufHYBRID
gesetzt ist, wandelt die API den Strom- und Kraftstoffverbrauch in Mikroliter Kraftstoff um.Wenn
emissionType
aufELECTRIC
gesetzt ist, wandelt die API den Stromverbrauch in Mikroliter Kraftstoff um.Legen Sie eine Antwortfeldmaske fest, die angibt, dass die Antwortattribute im Zusammenhang mit der Kraftstoffnutzung zurückgegeben werden sollen:
routes.travelAdvisory.fuelConsumptionMicroliters
.
Im folgenden Beispiel wird der geschätzte Kraftstoffverbrauch im Rahmen einer Anfrage angefordert, die auch die spritsparende Route umfasst:
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'
Die Antwort enthält den geschätzten Kraftstoffverbrauch sowohl für die Standardroute als auch für die spritsparende Route:
{ "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" ] } ] }
Unterstützte Regionen
Das Google Maps Platform-Team arbeitet kontinuierlich daran, die internationale Abdeckung unserer API-Dienste zu verbessern. Die folgende Liste enthält aktuelle Informationen zur spritsparenden Routenplanung in den einzelnen Ländern:
- Albanien (AL)
- Österreich (AT)
- Belgien (BE)
- Bosnien und Herzegowina (BA)
- Bulgarien (BG)
- Kanada (CA)
- Kroatien (HR)
- Zypern (CY)
- Tschechien (CZ)
- Dänemark (DK)
- Estland (EE)
- Finnland (FI)
- Frankreich (FR)
- Deutschland (DE)
- Griechenland (GR)
- Ungarn (HU)
- Island (IS)
- Irland (IE)
- Italien (IT)
- Kosovo (XK)
- Lettland (LV)
- Liechtenstein (LI)
- Litauen (LT)
- Luxemburg (LU)
- Malta (MT)
- Montenegro (ME)
- Niederlande (NL)
- Nordmazedonien (MK)
- Norwegen (NO)
- Polen (PL)
- Portugal (PT)
- Rumänien (RO)
- Serbien (RS)
- Slowakei (SK)
- Slowenien (SI)
- Spanien (ES)
- Schweden (SE)
- Schweiz (CH)
- Türkei (TR)
- Großbritannien (GB)
- USA (US)