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 das spritsparende Routing aktivieren, wird in der Antwort weiterhin die Standardroute angegeben. Außerdem erhalten Sie eine umweltfreundliche Route, die die Route mit dem niedrigsten Kraftstoff- oder Energieverbrauch basierend auf dem Motortyp Ihres Fahrzeugs anzeigt.

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 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 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 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 wird für die Nutzung einer Vorabversion der Google Maps Platform kein Aufpreis berechnet. Da für die spritsparende Routenplanung und die Schätzung des Kraftstoffverbrauchs TRAFFIC_AWARE_OPTIMAL als Routing-Einstellung angegeben werden muss, 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:: Kennzeichnet jede Route als DEFAULT_ROUTE, FUEL_EFFICIENT oder DEFAULT_ROUTE_ALTERNATE.

    • routes.routeToken: Ein Routen-Token, 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 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 Fahrbedingungen und anderer Faktoren kann die Standardroute und die spritsparende 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"
      ]
    }
  ]
}

Geschätzten Kraftstoffverbrauch für die Route berechnen

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)