По умолчанию API маршрутов возвращает маршрут по умолчанию , то есть маршрут без учета топлива или энергоэффективности. Когда вы включаете экологически чистую маршрутизацию , вы все равно получаете в ответе маршрут по умолчанию. Кроме того, вы также получите экологически чистый маршрут, показывающий наиболее экономичный маршрут в зависимости от типа двигателя вашего автомобиля.
Экологически чистый маршрут, возвращаемый API маршрутов, оптимизирован для снижения расхода топлива на всем маршруте. API использует тип двигателя вашего автомобиля, а также другие факторы, такие как движение транспорта в реальном времени и дорожные условия, для выбора экологически чистого маршрута. Чем более экономичен расход топлива или энергии маршрут, тем ниже расход топлива/энергии вашего автомобиля и выбросы CO2.
Например, относительное преимущество дизельного автомобиля в экономии топлива обычно является наибольшим при движении по шоссе. Гибридные и электрические транспортные средства, как правило, обеспечивают все большую эффективность при движении с остановками по городу и в условиях холмистой местности, где они могут широко использовать и получать выгоду от рекуперативного торможения.
Вы также можете запросить, чтобы API возвращал расчетный расход топлива на всем маршруте. Используйте оценки расхода топлива как способ сравнения различных маршрутов, а не как явные оценки расхода топлива для вашего конкретного автомобиля.
Как Google Maps оценивает топливную экономичность
Routes API оценивает топливную эффективность, используя данные Национальной лаборатории возобновляемых источников энергии Министерства энергетики США и данные Европейского агентства по окружающей среде. Этот расчет включает факторы, влияющие на потребление топлива и энергии, а также выбросы CO2, такие как:
- Средний расход топлива или энергии транспортными средствами в вашем регионе
- Крутизна холмов на вашем маршруте
- Схема движения с остановками
- Типы дорог (например, местные дороги или автомагистрали)
API маршрутов возвращает наиболее экономичный по расходу топлива или энергии маршрут, если время прибытия у него примерно такое же, как у маршрута по умолчанию. В тех случаях, когда экономия топлива или энергии слишком мала или значительно увеличивает время в пути, API показывает относительную экономию топлива или энергии между маршрутами, чтобы помочь вам сравнить.
Узнайте больше о технологии экологически чистой маршрутизации (PDF) .
Предварительные условия
Чтобы использовать экологически чистый маршрут или оценить расход топлива:
Вы должны указать
TRAFFIC_AWARE_OPTIMALв качестве предпочтения маршрутизации. В этом режиме сервер выполняет более полный поиск дорожной сети для поиска оптимального маршрута. Дополнительные сведения см. в разделе Настройка качества и задержки .Вы должны установить для параметра
travelModeзначениеDRIVE. Запросы на любой другой режим передвижения возвращают ошибку.Вы должны установить местоположение исходной путевой точки в поддерживаемом регионе . В противном случае API возвращает ошибку.
Маршрут не может содержать промежуточную точку.
Биллинг
Обычно платформа Google Maps не взимает плату за использование функции предварительного просмотра. Однако, поскольку для создания экологически чистого маршрута и оценки расхода топлива необходимо указать TRAFFIC_AWARE_OPTIMAL в качестве предпочтения маршрута, плата взимается в зависимости от SKU: Routes Advanced .
Узнайте больше о выставлении счетов за API маршрутов.
Запросите экологически чистый маршрут
Чтобы сделать запрос на расчет экологически чистого маршрута, установите в запросе следующие свойства:
Укажите
emissionTypeдля транспортного средства, используя значения, определенные в VehicleEmissionType :DIESEL,GASOLINE,ELECTRICилиHYBRID. Значение по умолчанию —GASOLINE.Установите для параметра
requestedReferenceRoutesзначениеFUEL_EFFICIENT.Установите маску поля ответа, которая указывает на возврат свойств ответа, связанных с экологически чистым маршрутом:
routes.routeLabels:Идентифицирует каждый маршрут какDEFAULT_ROUTE,FUEL_EFFICIENTилиDEFAULT_ROUTE_ALTERNATE.routes.routeToken:токен маршрута, который можно передать в навигационный SDK для получения пользовательского маршрута.
Пример экологически чистого запроса
Следующий код показывает запрос на экологически чистый маршрут. В этом примере вы используете маску поля ответа для возврата свойств ответа, связанных с экологически чистым маршрутом, а также свойств routes.distanceMeters и 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: API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
Пример экологически чистого ответа
Вызов computeRoutes приведенный выше, генерирует ответ JSON, содержащий два маршрута: маршрут по умолчанию и маршрут с экономичным расходом топлива. В ответ:
Для маршрута по умолчанию свойство массива
routeLabelsсодержитDEFAULT_ROUTE.Для экологически чистого маршрута свойство массива
routeLabelsсодержитFUEL_EFFICIENT.Если для
computeAlternativeRoutesдля вычисления альтернативных маршрутов в запросе задано значениеtrue, свойство массива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"
]
}
]
}
Из-за текущих условий вождения и других факторов маршрут по умолчанию и экологически чистый маршрут могут совпадать. В этом случае routeLabels содержит обе метки: DEFAULT_ROUTE и FUEL_EFFICIENT :
{
"routes": [
{
"distanceMeters": 45875,
"duration": "2655s",
"routeToken": "CvcDCos…6I40",
"routeLabels": [
"DEFAULT_ROUTE",
"FUEL_EFFICIENT"
]
}
]
}
Оцените расход топлива на маршруте
Вы можете запросить метод, чтобы получить расчетный расход топлива для всего маршрута в микролитрах. Чтобы добавить в ответ расчетный расход топлива для маршрута:
Установите для поля массива
extraComputationsзначениеFUEL_CONSUMPTION, чтобы включить расчет расхода топлива.Укажите
emissionTypeдля транспортного средства, используя значения, определенные в VehicleEmissionType :DIESEL,GASOLINE,ELECTRICилиHYBRID. Значение по умолчанию —GASOLINE.Если
emissionTypeимеет значениеHYBRID, API преобразует расход электроэнергии и топлива в микролитры топлива.Если
emissionType—ELECTRIC, API преобразует потребление электроэнергии в микролитры топлива.Установите маску поля ответа, которая указывает на возврат свойств ответа, связанных с использованием топлива:
routes.travelAdvisory.fuelConsumptionMicroliters.
В следующем примере запрашивается расчетный расход топлива как часть запроса, который также включает экологически чистый маршрут:
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'
В ответе содержится расчетный расход топлива как для маршрута по умолчанию, так и для экологически чистого маршрута:
{
"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"
]
}
]
}
Поддерживаемые регионы
Команда платформы Google Maps постоянно работает над улучшением международного покрытия наших сервисов API. В следующем списке показаны последние сведения о покрытии для экологически чистых маршрутов по странам:
- Албания (AL)
- Австрия (Австрия)
- Бельгия (BE)
- Босния и Герцеговина (BA)
- Болгария (БГ)
- Канада (Калифорния)
- Хорватия (HR)
- Кипр (CY)
- Чехия (CZ)
- Дания (ДК)
- Эстония (EE)
- Финляндия (FI)
- Франция (FR)
- Германия (DE)
- Греция (GR)
- Венгрия (HU)
- Исландия (ИС)
- Ирландия (IE)
- Италия (ИТ)
- Косово (XK)
- Латвия (LV)
- Лихтенштейн (LI)
- Литва (LT)
- Люксембург (LU)
- Мальта (MT)
- Черногория (МЭ)
- Нидерланды (NL)
- Северная Македония (МК)
- Норвегия (НЕТ)
- Польша (PL)
- Португалия (ПТ)
- Румыния (РО)
- Сербия (РС)
- Словакия (СК)
- Словения (SI)
- Испания (ES)
- Швеция (ЮВ)
- Швейцария (CH)
- Турция (ТР)
- Великобритания (Великобритания)
- Соединенные Штаты (США)