Eine umweltfreundliche Route erhalten

Standardmäßig gibt die Routes API die Standardroute zurück, also eine Route, bei der Kraftstoff- oder Energieeffizienz nicht berücksichtigt werden. Wenn Sie die umweltfreundliche Routenplanung aktivieren, wird in der Antwort weiterhin die Standardroute zurückgegeben. Außerdem wird eine umweltfreundliche Route angezeigt, die auf dem Motortyp Ihres Fahrzeugs basiert und die Route mit dem niedrigsten Kraftstoff- oder Energieverbrauch enthält.

Die von der Routes API zurückgegebene umweltfreundliche Route ist für einen geringeren Kraftstoffverbrauch auf der gesamten Route optimiert. Die API verwendet den Motortyp Ihres Fahrzeugs sowie andere Faktoren wie die Verkehrs- und Straßenverhältnisse in Echtzeit, um die umweltfreundliche 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 geschätzten Kraftstoffverbräuche, um verschiedene Routen zu vergleichen, nicht als explizite Schätzungen des Kraftstoffverbrauchs für Ihr genaues Fahrzeug.

So wird die Kraftstoffeffizienz in Google Maps berechnet

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 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 Route mit dem niedrigsten Kraftstoff- oder Energieverbrauch zurück, wenn sie ungefähr dieselbe 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 kraftstoffsparenden Routenplanung (PDF in englischer Sprache)

Vorbereitung

So nutzen 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 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 Startpunkt in einer unterstützten Region 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 Vorabversion der Google Maps Platform keine Kosten an. Da Sie für die spritsparende Routenplanung und die Schätzung des Kraftstoffverbrauchs jedoch TRAFFIC_AWARE_OPTIMAL als Routing-Einstellung angeben müssen, wird Ihnen die SKU: Routes Advanced in Rechnung gestellt.

Weitere Informationen zur Abrechnung für die Routes API

Eine umweltfreundliche Route anfordern

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

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

  • Setzen Sie requestedReferenceRoutes auf FUEL_EFFICIENT.

  • Legen Sie eine Antwortfeldmaske fest, die angibt, dass die Antworteigenschaften für eine umweltfreundliche Route zurückgegeben werden sollen:

    • routes.routeLabels: Jede Route wird als DEFAULT_ROUTE, FUEL_EFFICIENT oder DEFAULT_ROUTE_ALTERNATE gekennzeichnet.

    • routes.routeToken: Ein Routen-Token, 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 Antworteigenschaften zurückzugeben, die mit einer umweltfreundlichen Route verknüpft sind, zusammen mit den Eigenschaften 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 mit zwei Routen: der Standardroute und der Route mit dem geringsten Kraftstoffverbrauch. In der Antwort:

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

  • Für die umweltfreundliche Route enthält die Array-Property routeLabels den Wert FUEL_EFFICIENT.

  • Wenn Sie computeAlternativeRoutes in der Anfrage auf true festlegen, um alternative Routen zu berechnen, enthält die Array-Property 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 Verkehrsbedingungen 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 die Methode anfordern, um den geschätzten Kraftstoffverbrauch für die gesamte Route in Mikrolitern zurückzugeben. So fügen Sie der Antwort den geschätzten Kraftstoffverbrauch für eine Route hinzu:

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

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

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

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

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

Im folgenden Beispiel wird der geschätzte Kraftstoffverbrauch als Teil 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 umweltfreundliche 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 die einzelnen Länder für umweltfreundliche Routen:

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