Получите экологически чистый маршрут

Разработчики Европейской экономической зоны (ЕЭЗ)

По умолчанию API маршрутов возвращает маршрут по умолчанию , то есть маршрут без учета топливной или энергетической эффективности. При включении экологичной маршрутизации вы все равно получаете маршрут по умолчанию в ответе. Кроме того, вы также получаете экологичный маршрут, показывающий наиболее экономичный маршрут с точки зрения топлива или энергии на основе типа двигателя вашего автомобиля.

Экологичный маршрут, возвращаемый API маршрутов, оптимизирован для снижения расхода топлива на всем маршруте. API использует тип двигателя вашего автомобиля вместе с другими факторами, такими как трафик в реальном времени и дорожные условия, чтобы выбрать экологически чистый маршрут. Чем более экономичен или энергоэффективен маршрут, тем ниже потребление топлива или энергии вашим автомобилем и выбросы CO2.

Например, относительное преимущество дизельного автомобиля в экономии топлива, как правило, больше всего проявляется при движении по шоссе. Гибридные и электрические автомобили, как правило, обеспечивают все большую эффективность при движении по городу с частыми остановками и движении по холмистой местности, где они могут широко использовать и извлекать выгоду из рекуперативного торможения.

Вы также можете запросить, чтобы API вернул предполагаемый расход топлива для всего маршрута. Используйте оценки расхода топлива как способ сравнения различных маршрутов, а не как явные оценки расхода топлива для вашего конкретного транспортного средства.

Как Google Maps оценивает топливную экономичность

Routes API оценивает топливную эффективность, используя данные Национальной лаборатории возобновляемой энергии Министерства энергетики США и данные Европейского агентства по охране окружающей среды. Этот расчет включает факторы, которые влияют на потребление топлива и энергии, а также выбросы CO2, такие как:

  • Средний расход топлива или энергии для транспортных средств в вашем регионе
  • Крутизна холмов на вашем маршруте
  • Схемы движения с частыми остановками
  • Типы дорог (например, местные дороги или автомагистрали)

API маршрутов возвращает наиболее экономичный маршрут с точки зрения расхода топлива или энергии, если время прибытия примерно такое же, как у маршрута по умолчанию. В случаях, когда экономия топлива или энергии слишком мала или значительно увеличивает время в пути, API показывает относительную экономию топлива или энергии между маршрутами, чтобы помочь вам сравнить.

Узнайте больше о технологии экологичной маршрутизации (PDF) .

Предпосылки

Чтобы использовать экологичный маршрут или оценить расход топлива:

  • Необходимо указать TRAFFIC_AWARE_OPTIMAL в качестве предпочтения маршрутизации. В этом режиме сервер выполняет более тщательный поиск в дорожной сети, чтобы найти оптимальный маршрут. Для получения дополнительной информации см. раздел Настройка качества и задержки .

  • Необходимо установить travelMode на DRIVE . Запросы на любой другой режим путешествия возвращают ошибку.

  • Необходимо задать местоположение исходной точки маршрута в поддерживаемом регионе . В противном случае API возвращает ошибку.

  • Маршрут не может содержать промежуточную точку.

Биллинг

Обычно Google Maps Platform не взимает плату за использование функции Preview. Однако, поскольку для экологичной маршрутизации и оценки расхода топлива требуется указать TRAFFIC_AWARE_OPTIMAL в качестве предпочтения маршрутизации, с вас взимается плата на основе SKU: Compute Routes Pro .

Узнайте больше о выставлении счетов за Routes API.

Запросить экологически чистый маршрут

Чтобы сделать запрос на расчет экологичного маршрута, задайте в запросе следующие свойства:

  • Укажите emissionType для транспортного средства, используя значения, определенные в VehicleEmissionType : DIESEL , GASOLINE , ELECTRIC или HYBRID . Значение по умолчанию — GASOLINE .

  • Установите requestedReferenceRoutes на FUEL_EFFICIENT .

  • Установите маску поля ответа, которая указывает, что необходимо вернуть свойства ответа, связанные с экологически чистым маршрутом:

    • routes.routeLabels: идентифицирует каждый маршрут как DEFAULT_ROUTE , FUEL_EFFICIENT или DEFAULT_ROUTE_ALTERNATE .

    • routes.routeToken: токен маршрута, который можно передать в Navigation 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: YOUR_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: 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'

Ответ содержит расчетный расход топлива как для маршрута по умолчанию, так и для экологичного маршрута:

{
    "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 Platform постоянно работает над улучшением международного покрытия для наших API-сервисов. В следующем списке показаны последние сведения о покрытии по странам для экологичной маршрутизации:

  • Албания (AL)
  • Австрия (AT)
  • Бельгия (BE)
  • Босния и Герцеговина (БА)
  • Болгария (БГ)
  • Канада (Калифорния)
  • Хорватия (ХР)
  • Кипр (CY)
  • Чехия (CZ)
  • Дания (ДК)
  • Эстония (ЭЭ)
  • Финляндия (FI)
  • Франция (ФР)
  • Германия (DE)
  • Греция (ГР)
  • Венгрия (ВГ)
  • Исландия (ИС)
  • Ирландия (IE)
  • Италия (ИТ)
  • Косово (XK)
  • Латвия (LV)
  • Лихтенштейн (LI)
  • Литва (LT)
  • Люксембург (LU)
  • Мальта (MT)
  • Черногория (ME)
  • Нидерланды (NL)
  • Северная Македония (МК)
  • Норвегия (НЕТ)
  • Польша (PL)
  • Португалия (PT)
  • Румыния (RO)
  • Сербия (РС)
  • Словакия (SK)
  • Словения (СИ)
  • Испания (ES)
  • Швеция (SE)
  • Швейцария (CH)
  • Турция (ТР)
  • Соединенное Королевство (GB)
  • Соединенные Штаты (США)