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

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

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

Чтобы рассчитать стоимость проезда по матрице маршрута, см. раздел Расчёт стоимости проезда по матрице маршрута .

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

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

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

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

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

Рассчитать пошлины, используя проездной билет

Для расчета платы за проезд с использованием платного проезда вы указываете любые платные проезды как часть запроса. Затем API возвращает цены на проезд.

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

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

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

  • Тарифы могут быть ниже с проездным билетом : в некоторых регионах водитель или транспортное средство с проездным билетом платит другой сбор, чем те, у кого нет проездного билета. Например, если у вас есть проездной билет Good To Go! в Сиэтле, штат Вашингтон, США, вы платите меньший сбор, чем если бы у вас не было проездного билета.

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

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

В следующем примере метод computeRoutes используется для возврата информации о платных дорогах с предполагаемой ценой при использовании платного проезда. В этом примере вы:

  • Установите для поля массива extraComputations значение TOLLS чтобы включить расчет информации о платных дорогах.

  • Укажите тип транспортного средства и тип проездного билета, используя поле routeModifiers запроса. Возвращаемая стоимость проезда основана на ценах, используемых для указанного типа транспортного средства и проездного билета. Если указано более одного проездного билета, возвращается наименее дорогая цена.

  • Используйте маску поля ответа , чтобы настроить метод для возврата информации о платных дорогах в ответе. В этом примере запрос включал следующие свойства в маске поля ответа:

    • Поле routes.travelAdvisory.tollInfo для возврата информации по всему маршруту.

    • routes.legs.travelAdvisory.tollInfo для возврата информации по каждому этапу.

Запрос информации о платных дорогах 

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "extraComputations": ["TOLLS"],
  "routeModifiers":{
    "vehicleInfo":{
      "emissionType": "GASOLINE"
    },
    "tollPasses": [
      "US_MA_EZPASSMA",
      "US_WA_GOOD_TO_GO"
    ]
  }
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Ответ, содержащий информацию о платных дорогах

Ответ содержит информацию о платных дорогах в объекте TollInfo (REST) ​​или TollInfo (gRPC). В этом примере вы возвращаете информацию о платных дорогах для всего маршрута и для каждого участка маршрута.

{
  "routes": [
    {
      "legs": [
        {
          "travelAdvisory": {
            "tollInfo": {
              "estimatedPrice": [
                {
                  "currencyCode": "USD",
                  "units": "4",
                  "nanos": 400000000
                }
              ]
            }
          }
        }
      ],
      "distanceMeters": 150338,
      "duration": "6650s",
      "travelAdvisory": {
        "tollInfo": {
          "estimatedPrice": [
            {
              "currencyCode": "USD",
              "units": "4",
              "nanos": 400000000
            }
          ]
        }
      }
    }
  ]
}