Eine umweltfreundliche Route erhalten

Standardmäßig gibt die Routes API die Route default zurück, d. h. eine Route ohne Kraftstoff- oder Energieeffizienz. Wenn Sie das spritsparende Routing aktivieren, wird in der Antwort weiterhin die Standardroute angegeben. Außerdem wird eine spritsparende Route angezeigt, die die kraftstoff- oder energieeffizienteste Route für den Motortyp Ihres Fahrzeugs zeigt.

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

Der relative Kraftstoffverbrauch eines Dieselfahrzeugs ist beispielsweise bei Autobahnfahrten im Allgemeinen am größten. Hybrid- und Elektrofahrzeuge bieten in der Regel bei Stop-and-go-Nutzung in der Stadt und bei hügeligen Fahrumgebungen zunehmend mehr Effizienz, wo sie intensiv genutzt und von der regenerativen Bremsung 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, um verschiedene Routen zu vergleichen, und nicht als genaue Kraftstoffschätzungen für Ihr Fahrzeug.

So schätzt Google Maps die Kraftstoffeffizienz

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 Ihren Kraftstoff- und Energieverbrauch sowie Ihre 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 energieeffizienteste 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 verlängert, zeigt die API die relativen Kraftstoff- oder Energieeinsparungen zwischen 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 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 oder Latenz konfigurieren.

  • Sie müssen travelMode auf DRIVE festlegen. Bei Anfragen für andere Mobilitätsformen wird ein Fehler zurückgegeben.

  • 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 fallen bei der Google Maps Platform keine Gebühren für die Nutzung einer Funktion in der Vorabversion an. Da für die kraftstoffsparende Routenplanung und die Schätzung des Kraftstoffverbrauchs jedoch TRAFFIC_AWARE_OPTIMAL als Routingpräferenz angegeben werden muss, werden Ihnen die Kosten anhand der SKU: Routes Advanced berechnet.

Weitere Informationen zur Abrechnung für die Routes API

Kraftstoffsparende Route anfordern

Legen Sie für eine Anfrage zur Berechnung einer umweltfreundlichen Route die folgenden Attribute 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 zurückgegeben werden sollen, die mit einer spritsparenden Route verknüpft sind:

    • 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 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 umweltbewusste Reaktion

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

  • Für die Standardroute enthält das Arrayattribut routeLabels DEFAULT_ROUTE.

  • Für die spritsparende Route enthält das Array-Attribut routeLabels den Wert FUEL_EFFICIENT.

  • Wenn Sie computeAlternativeRoutes in der Anfrage auf true festlegen, um alternative Routen zu berechnen, enthält das Arrayattribut 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 die beiden Labels DEFAULT_ROUTE und FUEL_EFFICIENT:

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

Den Kraftstoffverbrauch für die Route schätzen

Sie können die Methode anfordern, um den geschätzten Kraftstoffverbrauch für die gesamte Route in Mikroliter 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 mit den in VehicleEmissionType definierten Werten an: DIESEL, GASOLINE, ELECTRIC oder HYBRID. Der Standardwert ist GASOLINE.

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

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

  • Legen Sie eine Antwortfeldmaske fest, die angibt, dass die Antwortattribute im Zusammenhang mit der Kraftstoffnutzung 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 kontinuierlich daran, die internationale Abdeckung unserer API-Dienste zu verbessern. Die folgende Liste enthält 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)