Eine umweltfreundliche Route erhalten

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

Die umweltfreundliche Route, die von der Routes API zurückgegeben wird, ist für einen geringeren Kraftstoffverbrauch auf der gesamten Route optimiert. Die API wählt die umweltfreundliche Route anhand des Motortyps Ihres Fahrzeugs und anderer Faktoren wie Verkehrs- und Straßenverhältnisse in Echtzeit aus. Je kraftstoff- oder energieeffizienter die Route ist, desto geringer sind der Kraftstoff- und Energieverbrauch und die CO2-Emissionen.

Beispielsweise ist der relative Kraftstoffverbrauch eines Dieselfahrzeugs bei Autobahnfahrten in der Regel am größten. Hybrid- und Elektrofahrzeuge bieten in der Regel eine schrittweise höhere Effizienz in Stop-and-go-Verkehr in der Stadt und in hügeligen Fahrumgebungen, in denen die regenerative Bremskraft umfassend 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 zum Kraftstoffverbrauch als Möglichkeit für den Vergleich verschiedener Routen und nicht als explizite Schätzungen zum Kraftstoffverbrauch für Ihr genaues Fahrzeug.

So schätzt Google Maps die Kraftstoffeffizienz

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, wie z. B.:

  • 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 länger ist, zeigt die API relative 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 eine kraftstoffsparende 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 festlegen. Anfragen für eine andere Mobilitätsform geben einen Fehler zurück.

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

  • Die Route darf keinen Zwischenwegpunkt enthalten.

Abrechnung

In der Regel erhebt die Google Maps Platform keine Gebühren für die Nutzung einer Funktion in der Vorabversion. Da Sie jedoch für eine kraftstoffsparende Routenplanung und Schätzung des Kraftstoffverbrauchs TRAFFIC_AWARE_OPTIMAL als Routenpräferenz angeben müssen, werden Ihnen die Kosten auf Grundlage der SKU: Routes Advanced berechnet.

Weitere Informationen zur Abrechnung für die Routes API

Umweltfreundliche Route anfordern

Wenn Sie eine Anfrage zur Berechnung einer kraftstoffsparenden 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 zurückgegeben werden, die einer umweltfreundlichen Route zugeordnet 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 eine umweltfreundliche Anfrage

Der folgende Code zeigt eine Anfrage für eine spritsparende Route. In diesem Beispiel verwenden Sie die Antwortfeldmaske, um Antwortattribute, die einer umweltfreundlichen Route zugeordnet 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: 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 kraftstoffsparende Route. In der Antwort:

  • Für die 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 Array-Attribut 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 in Mikrolitern für die gesamte Route 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 ermöglichen.

  • 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 des Kraftstoffs um.

    Wenn emissionType den Wert ELECTRIC hat, wandelt die API den Energieverbrauch in Mikroliter Brennstoff um.

  • Legen Sie eine Antwortfeldmaske fest, mit der die mit dem Kraftstoffverbrauch verknüpften Antwortattribute zurückgegeben werden: routes.travelAdvisory.fuelConsumptionMicroliters.

Im folgenden Beispiel wird der geschätzte Kraftstoffverbrauch im Rahmen einer Anfrage angefordert, die auch die kraftstoffsparende 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: 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 ständig daran, die internationale Abdeckung unserer API-Dienste zu verbessern. Die folgende Liste enthält die neuesten Details zur kraftstoffsparenden 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)