Ta strona została przetłumaczona przez Cloud Translation API.

Wyznacz trasę przyjazną dla środowiska

Domyślnie interfejs Routes API zwraca trasę domyślną, czyli trasę bez uwzględniania zużycia paliwa i energii. Gdy włączysz przyjazne środowisku , w odpowiedzi nadal otrzymasz trasę domyślną. Ponadto cofnij ekologiczną trasę z trasą z najniższym spalaniem lub energią najniższych energii od typu silnika.

Trasa przyjazna dla środowiska zwracana przez interfejs Routes API jest zoptymalizowana pod kątem niższe zużycie paliwa na całej trasie. Interfejs API używa silnika pojazdu typ reklamy oraz inne czynniki, takie jak natężenie ruchu w czasie rzeczywistym i warunki na drodze wybierze trasę przyjazną dla środowiska. Im większa oszczędność paliwa lub energii na trasie, tym obniżyć zużycie paliwa/energii w samochodzie oraz emisję CO2.

Na przykład zaleta względnego zużycia paliwa w pojeździe z silnikiem Diesla jest ogólnie przy jeździe po autostradzie. Pojazdy hybrydowe i elektryczne zapewniają zwykle coraz większa wydajność podczas jazdy po mieście i po górzystym terenie w których mogą być intensywnie wykorzystywane i czerpać korzyści z regeneracji, hamowanie.

Możesz też poprosić interfejs API o podanie szacunkowego zużycia paliwa dla całą trasę. Porównuj szacunkowe zużycie paliwa różne trasy, a nie jako bezpośrednie oszacowanie zużycia paliwa przez konkretny pojazd.

Jak Mapy Google szacują zużycie paliwa

Interfejs Routes API szacuje efektywność paliwową na podstawie statystyk ze Stanów Zjednoczonych Departament Energii National Renewable Energy Laboratory i danych z Europejskiej Agencji Środowiska. W tych obliczeniach uwzględniane są czynniki które mają wpływ na zużycie paliwa i energii oraz emisję CO2, na przykład:

średnie zużycie paliwa i energii w pojazdach w Twoim regionie,
nachylenie drogi na trasie,
wzorce natężenia ruchu,
rodzaje dróg (np. lokalne lub autostrady).

Interfejs Routes API zwraca trasę z najniższym spalaniem lub energią, jeśli – mniej więcej taki sam czas przyjazdu jak trasa domyślna. Jeśli paliwo lub oszczędność energii jest zbyt mała lub znacznie wydłuża czas jazdy, API pokazuje względne oszczędności paliwa lub energii między trasami, co ułatwia porównanie.

Więcej informacji o technologii wyznaczania tras przyjaznych dla środowiska (PDF)

Wymagania wstępne

Aby wyznaczać trasy przyjazne dla środowiska lub oszacować zużycie paliwa:

Jako preferencję routingu musisz określić TRAFFIC_AWARE_OPTIMAL. W tym serwer przeprowadzi bardziej szczegółowe wyszukiwanie sieci drogowej, znalezienie optymalnej trasy. Więcej informacji: Konfigurowanie jakości a opóźnienie.
Musisz ustawić wartość DRIVE na travelMode. Żądania dotyczące każdy inny środek transportu zwraca błąd.
Musisz ustawić lokalizację punktu początkowego obsługiwanego regionu. W przeciwnym razie API zwraca błąd.
Trasa nie może zawierać pośredniego punktu pośredniego.

Płatności

Zwykle Google Maps Platform nie pobiera opłat za korzystanie z wersji testowej. funkcji. Ponieważ jednak wyznaczanie tras przyjaznych dla środowiska i szacowanie zużycia paliwa jest możliwe wymaga określenia TRAFFIC_AWARE_OPTIMAL jako preferencji routingu, są naliczane na podstawie tras SKU SKU: Trasy Zaawansowane.

Dowiedz się więcej o płatnościach za interfejs Routes API.

Wybierz trasę przyjazną dla środowiska

Aby poprosić o wyznaczenie trasy przyjaznej dla środowiska, ustaw te właściwości w żądaniu:

Podaj wartość emissionType dla pojazdu, korzystając z wartości zdefiniowanych w VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC lub HYBRID. Wartość domyślna to GASOLINE
Ustaw requestedReferenceRoutes na FUEL_EFFICIENT.
Ustaw maskę pola odpowiedzi, która określa, że ma zwrócić właściwości odpowiedzi z trasą przyjazną dla środowiska:
- routes.routeLabels: Identyfikuje każdą trasę jako DEFAULT_ROUTE, FUEL_EFFICIENT lub DEFAULT_ROUTE_ALTERNATE.
- routes.routeToken: Token trasy, który można przekazać do Navigation SDK, aby pobrać .

Przykładowe treści przyjazne dla środowiska

Ten kod pokazuje żądanie trasy przyjaznej dla środowiska. W tym przykładzie używasz maski pola odpowiedzi do zwracania właściwości odpowiedzi powiązanych z trasa przyjazna dla środowiska wraz z: routes.distanceMeters i Właściwości 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'

Przykładowa ekologiczna odpowiedź

Wywołanie computeRoutes powyżej generuje odpowiedź JSON zawierającą dwie trasy: trasę domyślną i trasę z najniższym spalaniem. W odpowiedzi:

W przypadku trasy domyślnej właściwość tablicy routeLabels zawiera DEFAULT_ROUTE
W przypadku trasy przyjaznej dla środowiska, właściwość tablica routeLabels zawiera FUEL_EFFICIENT
Jeśli ustawisz w żądaniu computeAlternativeRoutes na true do obliczenia trasy alternatywne, właściwość tablicy routeLabels zawiera DEFAULT_ROUTE_ALTERNATE.

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

Ze względu na obecne warunki jazdy i inne czynniki domyślna trasa trasa przyjazna dla środowiska może być taka sama. W tym przypadku routeLabels zawiera obie etykiety: DEFAULT_ROUTE i FUEL_EFFICIENT:

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

Szacuj zużycie paliwa na trasie

Możesz poprosić o zwrócenie szacowanego zużycia paliwa w przypadku całego w mikrolitrach. Aby dodać szacunkowe zużycie paliwa na trasie do odpowiedź:

W polu tablicy extraComputations ustaw wartość FUEL_CONSUMPTION, aby włączyć obliczanie zużycia paliwa.
Podaj wartość emissionType dla pojazdu, korzystając z wartości zdefiniowanych w VehicleEmissionType: DIESEL, GASOLINE, ELECTRIC lub HYBRID. Wartość domyślna to GASOLINE

Jeśli emissionType to HYBRID, interfejs API przelicza energię elektryczną i paliwo zużycie paliwa na mikrolitry.

Jeśli emissionType to ELECTRIC, interfejs API przelicza energię elektryczną zużycie paliwa na mikrolitry.
Ustaw maskę pola odpowiedzi, która określa, że ma zwrócić właściwości odpowiedzi związane ze zużyciem paliwa: routes.travelAdvisory.fuelConsumptionMicroliters

W poniższym przykładzie poproszono o szacunkowe zużycie paliwa w ramach prośby, która obejmuje również trasę przyjazną dla środowiska:

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'

Odpowiedź zawiera informacje o szacowanym zużyciu paliwa na trasie domyślnej a w przypadku trasy przyjaznej dla środowiska:

{
    "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"
            ]
        }
    ]
}

Obsługiwane regiony

Zespół Google Maps Platform nieustannie pracuje nad ulepszeniem dla naszych usług API. Oto najnowsze wiadomości w poszczególnych krajach na temat tras przyjaznych dla środowiska:

Albania (AL)
Austria (AT)
Belgia (BE)
Bośnia i Hercegowina (BA)
Bułgaria (BG)
Kanada (CA)
Chorwacja (HR)
Cypr (CY)
Czechy (CZ)
Dania (DK)
Estonia (EE)
Finlandia (FI)
Francja (FR)
Niemcy (DE)
Grecja (GR)
Węgry (HU)
Islandia (IS)
Irlandia (IE)
Włochy (IT)
Kosowo (XK)
Łotwa (LV)
Liechtenstein (Liechtenstein)
Litwa (LT)
Luksemburg (LU)
Malta (MT)
Czarnogóra (ME)
Holandia (NL)
Macedonia Północna (MK)
Norwegia (NO)
Polska (PL)
Portugalia (PT)
Rumunia (RO)
Serbia (RS)
Słowacja (SK)
Słowenia (SI)
Hiszpania (ES)
Szwecja (SE)
Szwajcaria (CH)
Turcja (TR)
Wielka Brytania (GB)
Stany Zjednoczone