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

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

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

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

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

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

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

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

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

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

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

Предпосылки

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

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

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

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

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

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

Биллинг

Как правило, платформа Google Карт не взимает плату за использование функции предварительного просмотра. Однако, поскольку для построения экологичных маршрутов и оценки расхода топлива требуется указать TRAFFIC_AWARE_OPTIMAL в качестве предпочтительного варианта маршрута, плата взимается на основе артикула 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 Карт постоянно работает над расширением международного покрытия наших API-сервисов. Ниже представлен список актуальных данных о покрытии экологичных маршрутов по странам:

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

Регионы, поддерживающие двухколесный транспорт

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

  • Индия (IN)
  • Индонезия (ID)