В настоящее время Routes API находится в предварительной версии (pre-GA). Продукты и функции до общедоступной версии могут иметь ограниченную поддержку, а изменения в продуктах и ​​функциях до общедоступной версии могут быть несовместимы с другими версиями до общедоступной версии. Предложения Pre-GA подпадают под действие Особых условий использования платформы Google Карт . Дополнительные сведения см. в описаниях стадий запуска .

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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

Как рассчитываются пошлины

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

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

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

Расчет дорожных сборов при использовании проездного

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

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

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

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

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

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

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

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

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

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "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.travelAdvisory.tollInfo для возврата информации для всего маршрута и routes.legs.travelAdvisory.tollInfo для возврата информации для каждого этапа.

{
  "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 для возврата сведений о платных проездах по маршруту с расчетной ценой при использовании проездного билета.

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

Запрос информации о платных проездах в матрице маршрутов

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",
"routingPreference": "TRAFFIC_AWARE"
}'
-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
           }
        ]
      }
    }
  }
]

Поддерживаемые платные места

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

Код региона Страна/регион Штат/город/платная дорога
дополненная реальность Аргентина Буэнос айрес
АС Австралия Брисбен
АС Австралия Сидней
БР Бразилия По всей стране
Я БЫ Индонезия По всей стране
В Индия По всей стране
МХ Мексика Мехико
НАС Соединенные Штаты Алабама
НАС Соединенные Штаты Аляска
НАС Соединенные Штаты Калифорния
НАС Соединенные Штаты Колорадо
НАС Соединенные Штаты Делавэр
НАС Соединенные Штаты Флорида
НАС Соединенные Штаты Иллинойс
НАС Соединенные Штаты Айова
НАС Соединенные Штаты Индиана
НАС Соединенные Штаты Канзас
НАС Соединенные Штаты Луизиана
НАС Соединенные Штаты Мэн
НАС Соединенные Штаты Мэриленд
НАС Соединенные Штаты Массачусетс
НАС Соединенные Штаты Мичиган
НАС Соединенные Штаты Миннесота
НАС Соединенные Штаты Миссури
НАС Соединенные Штаты Нью-Гемпшир
НАС Соединенные Штаты Нью-Джерси
НАС Соединенные Штаты Нью-Йорк
НАС Соединенные Штаты Северная Каролина
НАС Соединенные Штаты Огайо
НАС Соединенные Штаты Пенсильвания
НАС Соединенные Штаты Род-Айленд
НАС Соединенные Штаты Южная Каролина
НАС Соединенные Штаты Техас
НАС Соединенные Штаты Юта
НАС Соединенные Штаты Вирджиния
НАС Соединенные Штаты Вашингтон
НАС Соединенные Штаты западная Вирджиния

Эта информация будет обновляться по мере поступления дополнительных данных о платных дорогах.