рассчитывать стоимость проезда по платным дорогам;

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

При расчете маршрута или матрицы маршрутов вы можете учитывать плату за проезд по маршруту. Для некоторых городов можно рассчитать примерную стоимость проезда по маршруту в нужной валюте.

Список поддерживаемых платных дорог можно найти в справочнике TollPass.

Как рассчитывается стоимость платных дорог

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

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

  • Тип выбросов транспортного средства, используемого на маршруте (VehicleEmissionType). Если тип выбросов не указан, возвращается плата за проезд для автомобиля с бензиновым двигателем.
  • Все абонементы на проезд, которые есть у водителя и транспортного средства, с помощью свойства tollPasses. API использует абонементы на проезд, чтобы определить точную стоимость проезда, и возвращает цены при оплате наличными, если абонементы на проезд в запросе не являются местными для маршрута.
  • Укажите, нужно ли избегать платных дорог. Если вы хотите по возможности избегать платных дорог, добавьте avoidTolls в качестве RouteModifier.

Рассчитывать стоимость проезда с учетом абонемента

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

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

В разных регионах абонементы на проезд могут работать по-разному.

  • При наличии абонемента на проезд тарифы могут быть ниже. В некоторых регионах водители, у которых есть абонемент на проезд, платят меньше. Например, если у вас есть карта Good To Go!, абонемент на проезд в Сиэтле (штат Вашингтон, США), вы платите меньше, чем если бы у вас его не было.
  • Для проезда по некоторым дорогам требуется абонемент. В некоторых регионах, например в Индонезии, есть дороги, для проезда по которым требуется абонемент. Если вы не укажете абонемент на проезд для маршрута, где он требуется, API не вернет стоимость проезда.

Как рассчитать стоимость проезда по платной дороге

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

  • Задайте для свойства extraComputations значение TOLLS.
  • Укажите тип транспортного средства и тип абонемента на проезд с помощью свойства routeModifiers.
  • Чтобы рассчитать плату за проезд по всему маршруту, запросите travelAdvisory в свойстве fields запроса. Посмотреть информацию о плате за проезд по всему маршруту можно в route.travelAdvisory.tollInfo.
  • Чтобы рассчитать плату за проезд по отдельным участкам маршрута, запросите legs в свойстве fields запроса. Посмотреть информацию о плате за проезд по каждому участку можно в route.legs[i].travelAdvisory.tollInfo.

Пример

В следующем примере запроса показано, как запросить плату за проезд по маршруту:

const requestWithTolls = {
  origin: 'Kirkland, WA',
  destination: 'University of Washington',
  travelMode: 'DRIVING',
  extraComputations: ['TOLLS'],
  routeModifiers: {
    vehicleInfo: {
      emissionType: 'GASOLINE',
    },
    tollPasses: ['US_WA_GOOD_TO_GO'],
  },
  fields: ['path', 'legs', 'distanceMeters', 'durationMillis', 'travelAdvisory'],
};