Рассчитать плату за проезд

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

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

Список поддерживаемых пунктов взимания платы см. в справке по TollPass .

Как рассчитываются сборы

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

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

  • Тип выбросов транспортного средства, используемого на маршруте ( 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'],
};