Eine umweltfreundliche Route erhalten

Standardmäßig gibt die Routes API die Standardroute zurück, d. h. eine Route ohne Berücksichtigung von Kraftstoff- oder Energieeffizienz. Wenn Sie die spritsparende Routenplanung aktivieren, erhalten Sie weiterhin die Standardroute in der Antwort. Außerdem erhalten Sie eine spritsparende Route mit der kraftstoff- oder energieeffizientesten Route für den Motortyp Ihres Fahrzeugs.

Die umweltfreundliche Route, die von der Routes API zurückgegeben wird, ist für einen niedrigeren Kraftstoffverbrauch auf der gesamten Route optimiert. Die API wählt den Motortyp deines Fahrzeugs und andere Faktoren wie Verkehrs- und Straßenverhältnisse in Echtzeit aus, um die spritsparende Route zu wählen. Je kraftstoff- oder energieeffizienter die Route ist, desto geringer sind der Kraftstoff-/Energieverbrauch und die CO2-Emissionen Ihres Autos.

Beispielsweise ist der relative Kraftstoffverbrauch eines Dieselfahrzeugs bei Autobahnen in der Regel am größten. Hybrid- und Elektrofahrzeuge sind in der Regel immer effizienter bei Stop-and-go-Fahrten in der Stadt und in hügeligen Fahrumgebungen, wo sie regenerative Bremsen umfassend nutzen und davon 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 als Möglichkeit, verschiedene Routen zu vergleichen, 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 Informationen des National Renewable Energy Laboratory (Nationales Labor für erneuerbare Energien) des US-amerikanischen Energieministeriums und anhand von Daten der Europäischen Umweltagentur. Diese Berechnung berücksichtigt Faktoren, die sich auf den Kraftstoff- und Energieverbrauch sowie die CO2-Emissionen auswirken, darunter:

  • 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 die Ankunftszeit ungefähr gleich ist wie bei der Standardroute. Wenn Kraftstoff- oder Energieeinsparungen zu gering sind oder die Fahrzeit erheblich verlängert wird, zeigt die API die relativen Kraftstoff- oder Energieeinsparungen zwischen den 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 die Schätzung des Kraftstoffverbrauchs:

  • 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 festlegen. Bei Anfragen für andere Mobilitätsformen wird ein Fehler zurückgegeben.

  • Sie müssen für den Start-Wegpunkt einen Standort 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 bei der Nutzung der Vorabversion der Google Maps Platform keine Gebühren an. Da Sie jedoch TRAFFIC_AWARE_OPTIMAL als Routeneinstellung für die spritsparende Routenplanung und die Schätzung des Kraftstoffverbrauchs angeben müssen, werden Ihnen die Kosten nach SKU: Routes Advanced berechnet.

Weitere Informationen zur Abrechnung für die Routes API

Umweltfreundliche Route anfordern

Wenn Sie eine Anfrage zur Berechnung einer spritsparenden Route stellen möchten, legen Sie die folgenden Attribute in der Anfrage fest:

  • Geben Sie emissionType für das Fahrzeug mit den unter 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 einer umweltfreundlichen Route zurückgegeben werden sollen:

    • routes.routeLabels: gibt jede Route als DEFAULT_ROUTE, FUEL_EFFICIENT oder DEFAULT_ROUTE_ALTERNATE an.

    • routes.routeToken: Ein Routentoken, das Sie an das Navigation SDK übergeben können, um eine benutzerdefinierte Route abzurufen.

Beispiel für eine Anfrage zur umweltfreundlichen Verwendung

Der folgende Code zeigt eine Anfrage für eine spritsparende Route. In diesem Beispiel verwenden Sie die Antwortfeldmaske, um Antwortattribute, die mit einer umweltfreundlichen Route verknüpft sind, zusammen mit den Attributen routes.distanceMeters und routes.duration zurückzugeben:

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 Reaktion

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

  • Bei der Standardroute enthält das Arrayattribut routeLabels den Wert DEFAULT_ROUTE.

  • Für die umweltfreundliche 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 das Arrayattribut 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 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 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:

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

  • Geben Sie emissionType für das Fahrzeug mit den unter VehicleEmissionType definierten Werten an: DIESEL, GASOLINE, ELECTRIC oder HYBRID. Der Standardwert ist GASOLINE.

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

    Wenn emissionType den Wert ELECTRIC hat, wandelt die API den Stromverbrauch in Mikroliter Kraftstoff um.

  • Legen Sie eine Antwortfeldmaske fest, die angibt, dass die Antwortattribute im Zusammenhang mit dem Kraftstoffverbrauch 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 ständig daran, die internationale Abdeckung unserer API-Dienste zu verbessern. In der folgenden Liste finden Sie 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)