Когда вы вычисляете маршрут или матрицу маршрутов, вы можете принять во внимание любые сборы за проезд по маршруту. Для некоторых городов можно рассчитать расчетную плату за проезд по маршруту в соответствующей валюте.
См. список поддерживаемых платных пунктов ниже.
Как рассчитываются пошлины
Routes API вычисляет предполагаемую плату за проезд, принимая во внимание любые скидки или пропуски, доступные водителю или транспортному средству, а также наиболее удобные способы оплаты. Если для данного маршрута нет доступной платы за проезд, Routes API указывает на существование платы за проезд с неизвестной платой.
Чтобы точно рассчитать информацию о платных дорогах, Routes API дает вам возможность указать:
- Тип выбросов транспортного средства, используемого для маршрута (
VehicleEmissionType
). Если тип выбросов не указан, возвращается плата за автомобиль, работающий на бензине. - Любые проездные билеты для водителя или транспортного средства, которые могут применяться (
TollPass
). Если пропуски не указаны, API возвращает цену наличными. -
avoidTolls
какRouteModifier
, чтобы избежать платных дорог.
Расчет дорожных сборов при использовании проездного
В некоторых регионах водитель или транспортное средство с проездным билетом платит другой сбор, чем те, у кого нет пропуска. Например, если у вас есть Good To Go! в Сиэтле, штат Вашингтон, США, вы платите меньшую плату, чем если бы у вас не было пропуска.
В некоторых регионах, например в Индонезии, есть дороги, по которым требуется проездной. Если платный проездной не указан для маршрута, где требуется платный пропуск, цена не возвращается.
Если вы укажете плату за проезд как часть запроса, API попытается вернуть стоимость проезда:
Если вы укажете недопустимый проездной билет, он будет проигнорирован.
Вы можете указать несколько платных пропусков в виде массива. 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 } ] } } } ] }
Расчет платы за проезд для матрицы маршрутов
В следующем примере используется метод computeRouteMatrix
для возврата информации о платных проездах по маршруту с расчетной ценой при использовании проездного билета:
Задайте для поля массива
extraComputations
значениеTOLLS
, чтобы включить расчет информации о платных дорогах.Укажите тип транспортного средства и тип проездного билета, используя поле
routeModifiers
исходных путевых точек запроса. Возвращаемая стоимость дорожных сборов основана на ценах, используемых для указанного типа транспортного средства и пропуска. Если указано более одного прохода, возвращается наименее дорогая цена.Используйте маску поля ответа , чтобы настроить метод для возврата информации о платных дорогах в ответе. Укажите
routes.travelAdvisory.tollInfo
, чтобы вернуть информацию для всего маршрута.
Запрос информации о платных проездах в матрице маршрутов
curl -X POST -d '{
"origins": [
{
"waypoint": {
"location": {
"latLng": {
"latitude":42.340173523716736,
"longitude":-71.05997968330408
}
}
},
"routeModifiers": {
"vehicleInfo":{
"emissionType": "GASOLINE"
},
"tollPasses": [
"US_MA_EZPASSMA",
"US_WA_GOOD_TO_GO"
]
}
}
],
"destinations": [
{
"waypoint": {
"location": {
"latLng": {
"latitude":42.075698891472804,
"longitude": -72.59806562080408
}
}
}
}
],
"travelMode": "DRIVE",
"extraComputations": ["TOLLS"]
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,travel_advisory.tollInfo,duration,distanceMeters,status' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
Ответ на информацию о платных дорогах в матрице маршрутов
Ответ содержит информацию о платных проездах в объекте TollInfo (REST) или TollInfo (gRPC).
Чтобы настроить метод для возврата информации о платных дорогах, используйте маску поля ответа , чтобы установить поле travelAdvisory.tollInfo
в маске.
[ { "originIndex": 0, "destinationIndex": 0, "status": {}, "distanceMeters": 150338, "duration": "5382s", "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ]
Поддерживаемые платные места
В настоящее время информация о платных дорогах доступна для следующих мест:
Код региона | Страна/регион | Штат/город/платная дорога |
---|---|---|
дополненная реальность | Аргентина | Буэнос айрес |
АС | Австралия | Брисбен |
АС | Австралия | Сидней |
БР | Бразилия | По всей стране |
ИДЕНТИФИКАТОР | Индонезия | По всей стране |
В | Индия | По всей стране |
МХ | Мексика | Мехико |
НАС | Соединенные Штаты | Алабама |
НАС | Соединенные Штаты | Аляска |
НАС | Соединенные Штаты | Калифорния |
НАС | Соединенные Штаты | Колорадо |
НАС | Соединенные Штаты | Делавэр |
НАС | Соединенные Штаты | Флорида |
НАС | Соединенные Штаты | Иллинойс |
НАС | Соединенные Штаты | Айова |
НАС | Соединенные Штаты | Индиана |
НАС | Соединенные Штаты | Канзас |
НАС | Соединенные Штаты | Луизиана |
НАС | Соединенные Штаты | Мэн |
НАС | Соединенные Штаты | Мэриленд |
НАС | Соединенные Штаты | Массачусетс |
НАС | Соединенные Штаты | Мичиган |
НАС | Соединенные Штаты | Миннесота |
НАС | Соединенные Штаты | Миссури |
НАС | Соединенные Штаты | Нью-Гемпшир |
НАС | Соединенные Штаты | Нью-Джерси |
НАС | Соединенные Штаты | Нью-Йорк |
НАС | Соединенные Штаты | Северная Каролина |
НАС | Соединенные Штаты | Огайо |
НАС | Соединенные Штаты | Пенсильвания |
НАС | Соединенные Штаты | Род-Айленд |
НАС | Соединенные Штаты | Южная Каролина |
НАС | Соединенные Штаты | Техас |
НАС | Соединенные Штаты | Юта |
НАС | Соединенные Штаты | Вирджиния |
НАС | Соединенные Штаты | Вашингтон |
НАС | Соединенные Штаты | Западная Виргиния |
Эта информация будет обновляться по мере поступления дополнительных данных о платных дорогах.