Diese Seite wurde von der Cloud Translation API übersetzt.

Eine umweltfreundliche Route erhalten

Entwickler im Europäischen Wirtschaftsraum (EWR)

Standardmäßig gibt die Routes API die Standardroute zurück, d. h. eine Route, bei der der Kraftstoff- oder Energieverbrauch nicht berücksichtigt wird. Wenn Sie kraftstoffsparende Routen aktivieren, erhalten Sie in der Antwort weiterhin die Standardroute. Außerdem erhalten Sie eine umweltfreundliche Route, die auf dem Motortyp Ihres Fahrzeugs basiert und die Route mit dem niedrigsten Kraftstoff- oder Energieverbrauch anzeigt.

Die von der Routes API zurückgegebene spritsparende Route ist für einen geringeren Kraftstoffverbrauch auf der gesamten Strecke optimiert. Bei der Auswahl der umweltfreundlichen Route werden neben anderen Faktoren wie Verkehrs- und Straßenverhältnissen in Echtzeit auch der Motortyp Ihres Fahrzeugs berücksichtigt. Je kraftstoff- oder energieeffizienter die Route ist, desto geringer sind der Kraftstoff- bzw. Stromverbrauch und die CO2-Emissionen.

So ist beispielsweise der relative Kraftstoffverbrauch von Dieselfahrzeugen im Allgemeinen für Autobahnfahrten am besten geeignet. Hybrid- und Elektrofahrzeuge sind in der Regel viel effizienter bei Stop-and-go-Verkehr in der Stadt und bei hügeligen Straßen, wo die Nutzbremsung sehr intensiv genutzt wird.

Sie können auch anfordern, dass die API den geschätzten Kraftstoffverbrauch für die gesamte Route zurückgibt. Die Schätzungen zum Kraftstoffverbrauch sollten Sie als Vergleichsmöglichkeit für verschiedene Routen und nicht als genaue Schätzungen für Ihr Fahrzeug verwenden.

So schätzt Google Maps die Kraftstoffeffizienz

In der Routes API wird die Kraftstoffeffizienz anhand von Erkenntnissen des National Renewable Energy Laboratory (Nationales Labor für erneuerbare Energien) des US-Energieministeriums und Daten der Europäischen Umweltagentur geschätzt. Diese Berechnung berücksichtigt Faktoren, die sich auf den Kraftstoff- und Energieverbrauch und die 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 energiesparende Route zurück, wenn für sie ungefähr die gleiche Ankunftszeit wie für die Standardroute gilt. Wenn Kraftstoff- oder Energieeinsparungen zu gering sind oder die Fahrzeit erheblich länger ist, werden in der API relative Kraftstoff- oder Energieeinsparungen verschiedener Routen angezeigt, damit Sie sie vergleichen können.

Weitere Informationen zur verbrauchsarmen Routenplanung (PDF in englischer Sprache)

Vorbereitung

So nutzen Sie die verbrauchsarme 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 finden. Weitere Informationen finden Sie unter Qualität und Latenz konfigurieren.
Sie müssen travelMode auf DRIVE setzen. Anfragen für andere Verkehrsmittel geben einen Fehler zurück.
Sie müssen einen Standort für den Start-Waypoint in einer unterstützten Region festlegen. Andernfalls gibt die API einen Fehler zurück.
Die Route darf keinen Zwischenwegpunkt enthalten.

Abrechnung

In der Regel werden für die Nutzung einer Vorabfunktion der Google Maps Platform keine Gebühren berechnet. Da für die spritsparende Routenplanung und die Schätzung des Kraftstoffverbrauchs jedoch TRAFFIC_AWARE_OPTIMAL als Routing-Präferenz angegeben werden muss, werden Ihnen die Kosten basierend auf der SKU: Compute Routes Pro berechnet.

Weitere Informationen zur Abrechnung für die Routes API

Verbrauchsarme Route anfordern

Wenn Sie eine Anfrage zum Berechnen einer umweltfreundlichen Route stellen möchten, legen Sie die folgenden Attribute in der Anfrage fest:

Geben Sie emissionType für das Fahrzeug mit den in VehicleEmissionType definierten Werten an: DIESEL, GASOLINE, ELECTRIC oder HYBRID. Der Standardwert ist GASOLINE.
Setzen Sie requestedReferenceRoutes auf FUEL_EFFICIENT.
Legen Sie eine Antwortfeldmaske fest, mit der die Antwortattribute angegeben werden, die für eine umweltfreundliche Route zurückgegeben werden sollen:
- routes.routeLabels:: Kennzeichnet jede Route als DEFAULT_ROUTE, FUEL_EFFICIENT oder DEFAULT_ROUTE_ALTERNATE.
- routes.routeToken: Ein Routentoken, das Sie an das Navigation SDK übergeben können, um eine benutzerdefinierte Route abzurufen.

Beispiel für eine umweltfreundliche Anfrage

Der folgende Code zeigt eine Anfrage für eine umweltfreundliche Route. In diesem Beispiel verwenden Sie die Antwortfeldmaske, um Antwortattribute zurückzugeben, die einer umweltfreundlichen 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 umweltfreundliche Antwort

Der computeRoutes-Aufruf oben generiert eine JSON-Antwort, die zwei Routen enthält: die Standardroute und die kraftstoffsparende Route. In der Antwort:

Für die Standardroute enthält das Array-Attribut routeLabels den Wert DEFAULT_ROUTE.
Bei der umweltfreundlichen Route enthält das Array-Attribut routeLabels den Wert FUEL_EFFICIENT.
Wenn Sie computeAlternativeRoutes in der Anfrage auf true setzen, um alternative Routen zu berechnen, enthält die Array-Eigenschaft routeLabels 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 können die Standardroute und die umweltfreundliche Route identisch sein. In diesem Fall enthält routeLabels beide Labels: DEFAULT_ROUTE und FUEL_EFFICIENT:

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

Kraftstoffverbrauch für die Route schätzen

Sie können anfordern, dass die Methode die geschätzte Kraftstoffmenge für die gesamte Route in Mikrolitern zurückgibt. So fügen Sie der Antwort die geschätzte Kraftstoffnutzung für eine Route hinzu:

Legen Sie das extraComputations-Arrayfeld auf FUEL_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 oder HYBRID. Der Standardwert ist GASOLINE.

Wenn emissionType HYBRID ist, werden Strom- und Kraftstoffverbrauch in Mikroliter Kraftstoff umgerechnet.

Wenn emissionType gleich ELECTRIC ist, wandelt die API den Stromverbrauch in Mikroliter Kraftstoff um.
Legen Sie eine Antwortfeldmaske fest, mit der die Antwort-Properties für den Kraftstoffverbrauch zurückgegeben werden: routes.travelAdvisory.fuelConsumptionMicroliters.

Im folgenden Beispiel wird der geschätzte Kraftstoffverbrauch im Rahmen einer Anfrage angefordert, die auch die umweltfreundliche Route enthält:

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 verbrauchsarme 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 weltweite Abdeckung der API-Dienste zu verbessern. In der folgenden Liste finden Sie die aktuellen Abdeckungsdetails für umweltfreundliche Routen in den einzelnen Ländern:

Albanien (AL)
Australien (AU)
Österreich (AT)
Belgien (BE)
Bosnien und Herzegowina (BA)
Bulgarien (BG)
Kanada (CA)
Kroatien (HR)
Zypern (CY)
Tschechien (CZ)
Dänemark (DK)
Ägypten (EG)
Estland (EE)
Finnland (FI)
Frankreich (FR)
Deutschland (DE)
Griechenland (GR)
Ungarn (HU)
Island (IS)
Indien (IN)
Indonesien (ID)
Irland (IE)
Italien (IT)
Kosovo (XK)
Lettland (LV)
Liechtenstein (LI)
Litauen (LT)
Luxemburg (LU)
Malta (MT)
Mexiko (MX)
Montenegro (ME)
Niederlande (NL)
Nordmazedonien (MK)
Norwegen (NO)
Polen (PL)
Portugal (PT)
Rumänien (RO)
Saudi-Arabien (SA)
Serbien (RS)
Slowakei (SK)
Slowenien (SI)
Spanien (ES)
Schweden (SE)
Schweiz (CH)
Türkei (TR)
Vereinigte Arabische Emirate (AE)
Großbritannien (GB)
USA (US)