Eine umweltfreundliche Route erhalten

Standardmäßig gibt die Routes API die Route default zurück, also eine Route. ohne die Kraftstoff- oder Energieeffizienz zu berücksichtigen. Wenn Sie die umweltfreundliche Routing verwenden, erhalten Sie in der Antwort trotzdem die Standardroute. Außerdem sehen Sie Eine spritsparende Route zurückgeben, die die kraftstoff- oder energieeffizienteste Route zeigt je nach Motortyp des Fahrzeugs.

Die von der Routes API zurückgegebene spritsparende Route ist für geringerer Kraftstoffverbrauch auf der gesamten Route. Die API verwendet den Motor deines Fahrzeugs sowie andere Faktoren wie Verkehrs- und Straßenverhältnisse in Echtzeit an, die spritsparende Route wählen. Je kraftstoff- oder energieeffizienter die Route ist, den Kraftstoff- und Energieverbrauch und die CO2-Emissionen Ihres Autos zu senken.

Der relative Kraftstoffverbrauch eines Dieselfahrzeugs am besten beim Autofahren. Hybrid- und Elektrofahrzeuge bieten meist immer mehr Effizienz bei Stop-and-go-Stadtfahrten und bei hügeligen Fahrten. Umgebungen, in denen sie regenerative Energien umfassend nutzen und davon profitieren können zu bremsen.

Sie können auch anfordern, dass die API den geschätzten Kraftstoffverbrauch für Ihr für die gesamte Route. Anhand der Schätzungen des Kraftstoffverbrauchs können Sie verschiedene Routen erstellen, 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 Daten aus den USA. Energieministerium Nationales Labor für erneuerbare Energien 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 ungefähr der Ankunftszeit der Standardroute entspricht. In Fällen, in denen Kraftstoff oder Energieeinsparungen zu gering sind oder die Fahrzeit erheblich verlängern, zeigt die relative Kraftstoff- oder Energieeinsparung zwischen Routen an, 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 dieser führt der Server eine ausführlichere Suche im Straßennetz durch, um die optimale Route zu finden. Weitere Informationen finden Sie unter Konfiguriere Qualität und Latenz.

  • Sie müssen travelMode auf DRIVE festlegen. Anfragen für bei jeder anderen Mobilitätsform einen Fehler zurück.

  • Sie müssen eine Position für den Ausgangswegpunkt in einem unterstützte Region haben. Andernfalls gibt die API einen Fehler zurück.

  • Die Route darf keinen Wegpunkt enthalten.

Abrechnung

In der Regel erhebt die Google Maps Platform keine Gebühren für die Nutzung einer Vorabversion . Da die spritsparende Routenplanung und die Schätzung des Kraftstoffverbrauchs müssen Sie TRAFFIC_AWARE_OPTIMAL als Routing-Einstellung angeben. werden basierend auf der SKU: Routes berechnet. Erweitert.

Weitere Informationen zur Abrechnung für die Routes API

Kraftstoffsparende Route anfordern

Legen Sie die folgenden Attribute fest, um eine Anfrage zur Berechnung einer spritsparenden Route zu stellen in der Anfrage:

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

  • Setzen Sie requestedReferenceRoutes auf FUEL_EFFICIENT.

  • Legt eine Antwortfeldmaske fest, die angibt, dass die Antworteigenschaften 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 den Navigation SDK zum Abrufen eines benutzerdefinierte Route.

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 mit einer spritsparende Route sowie die routes.distanceMeters und routes.duration-Properties:

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: die Standardroute und die spritsparende Route. In der Antwort:

  • Für die Standardroute enthält das Array-Attribut routeLabels DEFAULT_ROUTE.

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

  • Wenn Sie in der Anfrage für computeAlternativeRoutes den Wert true für die Berechnung festlegen alternative routes, das Array-Attribut routeLabels enthält 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 werden die Standardroute und die spritsparende Route gleich sein kann. 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"
      ]
    }
  ]
}

Den Kraftstoffverbrauch für die Route schätzen

Sie können die Methode anfordern, um den geschätzten Kraftstoffverbrauch für die gesamte in Mikroliter angegeben. Um den geschätzten Kraftstoffverbrauch für eine Route hinzuzufügen, Antwort:

  • Legen Sie das Array-Feld extraComputations auf FUEL_CONSUMPTION fest, um Folgendes zu aktivieren: Berechnung des Kraftstoffverbrauchs.

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

    Wenn emissionType auf HYBRID gesetzt ist, wandelt die API Strom und Kraftstoff um. bis hin zu Mikroliter Kraftstoff.

    Wenn emissionType auf ELECTRIC gesetzt ist, wandelt die API Strom um bis hin zu Mikroliter Kraftstoff.

  • Legt eine Antwortfeldmaske fest, die angibt, dass die Antworteigenschaften zurückgegeben werden sollen im Zusammenhang mit dem Kraftstoffverbrauch: routes.travelAdvisory.fuelConsumptionMicroliters

Im folgenden Beispiel wird der geschätzte Kraftstoffverbrauch im Rahmen einer Anfrage angefordert, enthält außerdem die spritsparende Route:

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 und 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, den internationalen Abdeckung unserer API-Dienste. Die folgende Liste zeigt die aktuelle Berichterstattung für die spritsparende Routenplanung nach Land aufgeschlüsselt:

  • 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)