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 die verbrauchsarme Routenplanung aktivieren, wird in der Antwort weiterhin die Standardroute zurückgegeben. Außerdem erhalten Sie eine verbrauchsarme Routenplanung, die je nach Motortyp Ihres Fahrzeugs die kraftstoff- oder energieeffizienteste Route zeigt.

Die von der Routes API zurückgegebene verbrauchsarme Route ist für einen geringeren Kraftstoffverbrauch auf der gesamten Route optimiert. Die API verwendet den Motortyp Ihres Fahrzeugs zusammen mit anderen Faktoren wie Echtzeitverkehr und Straßenbedingungen, um die verbrauchsarme Route auszuwählen. Je kraftstoff- oder energieeffizienter die Route ist, desto geringer sind der Kraftstoff- bzw. Stromverbrauch und die CO₂-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. Verwenden Sie die Schätzungen des Kraftstoffverbrauchs, um verschiedene Routen zu vergleichen, und nicht als explizite Schätzungen des Kraftstoffverbrauchs für Ihr genaues Fahrzeug.

So wird die Kraftstoffeffizienz in Google Maps geschätzt

Die Routes API schätzt 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. Diese Berechnung berücksichtigt Faktoren, die sich auf den Kraftstoff- und Energieverbrauch und die CO₂-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 energiesparendste 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 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 verwenden 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 im Vergleich zur Latenz konfigurieren.

  • Sie müssen travelMode auf DRIVE oder TWO_WHEELER setzen. Anfragen für andere Mobilitätsformen geben einen Fehler zurück. Die verbrauchsarme Routenplanung für TWO_WHEELER wird nur in einigen Ländern unterstützt.

  • Sie müssen einen Standort für den Ausgangswegpunkt in einer unterstützten Region festlegen. Andernfalls gibt die API einen Fehler zurück.

  • Für TWO_WHEELER müssen Sie einen Standort für den Start-Wegpunkt in einer unterstützten Region für Zweiräder festlegen. Andernfalls gibt die API einen Fehler zurück.

  • Die Route darf keinen Zwischenwegpunkt enthalten.

Abrechnung

In der Regel fallen für die Nutzung einer Funktion in der Vorabversion keine Kosten an. Da für die verbrauchsarme Routenplanung und die Schätzung des Kraftstoffverbrauchs jedoch TRAFFIC_AWARE_OPTIMAL als Routenpräferenz angegeben werden muss, wird Ihnen die SKU: Compute Routes Pro in Rechnung gestellt.

Weitere Informationen zur Abrechnung für die Routes API

Verbrauchsarme Route anfordern

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

  • Geben Sie emissionType für das Fahrzeug an. Verwenden Sie dazu die in VehicleEmissionType definierten Werte: DIESEL, GASOLINE, ELECTRIC oder HYBRID. Der Standardwert ist GASOLINE.

  • Setzen Sie requestedReferenceRoutes auf FUEL_EFFICIENT.

  • Legen Sie eine Antwortfeldmaske fest, die angibt, dass die Antwortattribute zurückgegeben werden sollen, die mit einer verbrauchsarmen Route verknüpft sind:

    • routes.routeLabels: Identifiziert 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 verbrauchsarme Route. In diesem Beispiel verwenden Sie die Antwortfeldmaske, um Antwortattribute zurückzugeben, die mit einer verbrauchsarmen Route verknüpft sind, sowie die Attribute 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 obige computeRoutes-Aufruf generiert eine JSON-Antwort, die zwei Routen enthält: die Standardroute und die spritsparende Route. Die Antwort sieht so aus:

  • Für die Standardroute enthält das Array-Attribut routeLabels den Wert DEFAULT_ROUTE.

  • Für die verbrauchsarme Routenplanung 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 den Wert 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 Verkehrsbedingungen und anderer Faktoren können die Standardroute und die verbrauchsarme 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 die Methode so anfordern, dass der geschätzte Kraftstoffverbrauch für die gesamte Route in Mikrolitern zurückgegeben wird. So fügen Sie der Antwort den geschätzten Kraftstoffverbrauch für eine Route hinzu:

  • Legen Sie das Arrayfeld extraComputations auf FUEL_CONSUMPTION fest, um die Berechnung des Kraftstoffverbrauchs zu aktivieren.

  • Geben Sie emissionType für das Fahrzeug an. Verwenden Sie dazu die in VehicleEmissionType definierten Werte: DIESEL, GASOLINE, ELECTRIC oder HYBRID. Der Standardwert ist GASOLINE.

    Wenn der emissionType HYBRID ist, rechnet die API den Strom- und Kraftstoffverbrauch in Mikroliter Kraftstoff um.

    Wenn der emissionType ELECTRIC ist, wandelt die API den Stromverbrauch in Mikroliter Kraftstoff um.

  • Legen Sie eine Antwortfeldmaske fest, die angibt, dass die Antwortattribute für den Kraftstoffverbrauch zurückgegeben werden sollen: routes.travelAdvisory.fuelConsumptionMicroliters.

Im folgenden Beispiel wird der geschätzte Kraftstoffverbrauch im Rahmen einer Anfrage angefordert, die auch die verbrauchsarme 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 API-Dienste in noch mehr Ländern verfügbar zu machen. In der folgenden Liste finden Sie aktuelle Informationen dazu, in welchen Ländern die verbrauchsarme Routenplanung verfügbar ist:

  • 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)

Regionen, in denen Zweiräder unterstützt werden

In der folgenden Liste finden Sie die aktuellen Abdeckungsdetails für die verbrauchsarme Routenplanung für Zweiräder nach Ländern:

  • Indien (IN)
  • Indonesien (ID)