Diese Seite wurde von der Cloud Translation API übersetzt.

Umweltfreundliche Routen konfigurieren

Standardmäßig wird von der Routes die Standardroute zurückgegeben, also eine Route ohne Berücksichtigung der Kraftstoff- oder Energieeffizienz. Wenn Sie umweltfreundliches Routing aktivieren, wird in der Antwort immer noch die Standardroute angezeigt. Darüber hinaus erhalten Sie eine umweltfreundliche Route, die die kraftstoff- oder energieeffizienteste Route auf Basis des Motortyps Ihres Fahrzeugs zeigt.

Die von der Routes API zurückgegebene umweltfreundliche Route ist für einen niedrigeren Kraftstoffverbrauch über die gesamte Route optimiert. Bei der Wahl der API wird die umweltfreundliche Route zusammen mit anderen Faktoren wie Echtzeit-Verkehr und Straßenverhältnissen verwendet. Je kraftstoff- oder energieeffizienter die Route ist, desto geringer sind der Kraftstoff-/Energieverbrauch und die CO2-Emissionen.

So ist beispielsweise der relative Kraftstoffverbrauch eines Dieselfahrzeugs 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. Du kannst die Kraftstoffverbrauchsschätzungen verwenden, um verschiedene Routen zu vergleichen, nicht als explizite Kraftstoffverbrauchsschätzungen für dein genaues Fahrzeug.

So spart Google Maps die Kraftstoffeffizienz

Die Routes API schätzt die Kraftstoffeffizienz anhand der Informationen des National Renewable Energy Laboratory (Nationales Labor für erneuerbare Energien) des US-amerikanischen Energieministeriums sowie anhand von Daten der Europäischen Umweltagentur. Diese Berechnung berücksichtigt Faktoren, die sich auf den Kraftstoff- und Energieverbrauch und die 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- und 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, werden über die API relative Kraftstoff- oder Energieeinsparungen zwischen Routen angezeigt, damit Sie sie vergleichen können.

Weitere Informationen zur kraftstoffsparenden Routenplanung (PDF in englischer Sprache)

Voraussetzungen

So verwendest du die kraftstoffsparende Routenplanung oder schätzt den Kraftstoffverbrauch:

Sie müssen TRAFFIC_AWARE_OPTIMAL als Routingeinstellung angeben. In diesem Modus führt der Server eine umfassendere Suche nach dem Straßennetz durch, um die optimale Route zu finden. Weitere Informationen finden Sie unter Qualität vs. Latenz konfigurieren.
Sie müssen travelMode auf DRIVE festlegen. Bei Anfragen für alle anderen Mobilitätsformen wird ein Fehler zurückgegeben.
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 Wegpunkt enthalten.

Abrechnung

In der Regel fallen für die Nutzung einer Vorschaufunktion in der Google Maps Platform keine Kosten an. Da Sie für die kraftstoffsparende Routenplanung und den geschätzten Kraftstoffverbrauch jedoch TRAFFIC_AWARE_OPTIMAL als Routeneinstellung angeben müssen, werden Ihnen die Gebühren nach SKU: Routes Advanced berechnet.

Weitere Informationen zur Abrechnung für die Routes API

Eine kraftstoffsparende Route beantragen

Wenn Sie eine Anfrage zum Berechnen einer umweltfreundlichen Route stellen möchten, legen Sie in der Anfrage 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, die angibt, dass die Antwortattribute, die mit einer umweltfreundlichen Route verknüpft sind, zurückgegeben werden:
- routes.routeLabels: Kennzeichnet jede Route als DEFAULT_ROUTE, FUEL_EFFICIENT oder DEFAULT_ROUTE_ALTERNATE.
- routes.routeToken: Ein Routentoken, das Sie an das Navigation SDK weitergeben können, um eine benutzerdefinierte Route abzurufen.

Beispiel für eine umweltfreundliche Anfrage

Der folgende Code zeigt eine Anfrage für eine kraftstoffsparende 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: 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 Aufruf von Compute-Routen generiert eine JSON-Antwort mit zwei Routen: die Standardroute und die kraftstoffsparende Route. In der Antwort:

Für die Standardroute enthält das Array-Attribut 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 festlegen, um alternative Routen zu berechnen, enthält das Array-Attribut 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 können die Standardroute und die umweltfreundliche 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 der 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 die geschätzte Kraftstoffnutzung für eine Route hinzu:

Legen Sie das Arrayfeld extraComputations auf FUEL_CONSUMPTION fest, um die Berechnung der Kraftstoffnutzung 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 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 mit der Kraftstoffnutzung verknüpften Antwortattribute zurückgegeben werden: routes.travelAdvisory.fuelConsumptionMicroliters.

Im folgenden Beispiel wird die geschätzte Kraftstoffnutzung 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: 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. In der folgenden Liste sind Details zur aktuellen Abdeckung für die kraftstoffsparende Routenplanung auf Länderbasis angegeben:

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)