Эта страница переведена с помощью Cloud Translation API.

Package google.maps.routing.v2

Индекс

Routes (интерфейс)
ComputeRouteMatrixRequest (сообщение)
ComputeRouteMatrixRequest.ExtraComputation (перечисление)
ComputeRoutesRequest (сообщение)
ComputeRoutesRequest.ExtraComputation (перечисление)
ComputeRoutesRequest.ReferenceRoute (перечисление)
ComputeRoutesResponse (сообщение)
FallbackInfo (сообщение)
FallbackReason (перечисление)
FallbackRoutingMode (перечисление)
GeocodedWaypoint (сообщение)
GeocodingResults (сообщение)
LocalizedTime (сообщение)
Location (сообщение)
Maneuver (перечисление)
NavigationInstruction (сообщение)
Polyline (сообщение)
PolylineEncoding (перечисление)
PolylineQuality (перечисление)
Route (сообщение)
Route.RouteLocalizedValues (сообщение)
RouteLabel (перечисление)
RouteLeg (сообщение)
RouteLeg.RouteLegLocalizedValues (сообщение)
RouteLeg.StepsOverview (сообщение)
RouteLeg.StepsOverview.MultiModalSegment (сообщение)
RouteLegStep (сообщение)
RouteLegStep.RouteLegStepLocalizedValues (сообщение)
RouteLegStepTransitDetails (сообщение)
RouteLegStepTransitDetails.TransitDetailsLocalizedValues (сообщение)
RouteLegStepTransitDetails.TransitStopDetails (сообщение)
RouteLegStepTravelAdvisory (сообщение)
RouteLegTravelAdvisory (сообщение)
RouteMatrixDestination (сообщение)
RouteMatrixElement (сообщение)
RouteMatrixElement.LocalizedValues (сообщение)
RouteMatrixElementCondition (перечисление)
RouteMatrixOrigin (сообщение)
RouteModifiers (сообщение)
RouteTravelAdvisory (сообщение)
RouteTravelMode (перечисление)
RoutingPreference (перечисление)
SpeedReadingInterval (сообщение)
SpeedReadingInterval.Speed (перечисление)
TollInfo (сообщение)
TollPass (перечисление)
TrafficModel (перечисление)
TransitAgency (сообщение)
TransitLine (сообщение)
TransitPreferences (сообщение)
TransitPreferences.TransitRoutingPreference (перечисление)
TransitPreferences.TransitTravelMode (перечисление)
TransitStop (сообщение)
TransitVehicle (сообщение)
TransitVehicle.TransitVehicleType (перечисление)
Units (перечисление)
VehicleEmissionType (перечисление)
VehicleInfo (сообщение)
Waypoint (сообщение)

Маршруты

API маршрутов.

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix( ComputeRouteMatrixRequest ) returns ( RouteMatrixElement )` Принимает список пунктов отправления и назначения и возвращает поток, содержащий информацию о маршруте для каждой комбинации пунктов отправления и назначения. ПРИМЕЧАНИЕ. Этот метод требует, чтобы вы указали маску поля ответа во входных данных. Вы можете указать маску поля ответа, используя параметр URL-адреса `$fields` или `fields` или используя заголовок HTTP/gRPC `X-Goog-FieldMask` (см. доступные параметры и заголовки URL-адреса . Значение представляет собой список путей к полям, разделенных запятыми. См. подробную документацию о том, как создавать пути к полям . Например, в этом методе: Маска поля всех доступных полей (для ручной проверки): `X-Goog-FieldMask: ` Маска поля длительности маршрута, расстояний, статуса элемента, состояния и индексов элемента (пример настройки производства): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` Крайне важно, чтобы вы включали `status` в маску поля, иначе все сообщения будут выглядеть нормально. Google не рекомендует использовать маску поля ответа с подстановочным знаком ( `` ), потому что: Выбор только тех полей, которые вам нужны, помогает нашему серверу экономить вычислительные циклы, позволяя нам возвращать вам результат с меньшей задержкой. Выбор только тех полей, которые вам нужны в рабочем задании, обеспечивает стабильную производительность задержки. Возможно, в будущем мы добавим больше полей ответа, и эти новые поля могут потребовать дополнительного времени вычислений. Если вы выберете все поля или если вы выберете все поля на верхнем уровне, вы можете столкнуться с ухудшением производительности, поскольку любое новое поле, которое мы добавляем, будет автоматически включено в ответ. Выбор только тех полей, которые вам нужны, приводит к меньшему размеру ответа и, следовательно, к более высокой пропускной способности сети.

rpc ComputeRouteMatrix( ComputeRouteMatrixRequest ) returns ( RouteMatrixElement )

Принимает список пунктов отправления и назначения и возвращает поток, содержащий информацию о маршруте для каждой комбинации пунктов отправления и назначения.

ПРИМЕЧАНИЕ. Этот метод требует, чтобы вы указали маску поля ответа во входных данных. Вы можете указать маску поля ответа, используя параметр URL-адреса $fields или fields или используя заголовок HTTP/gRPC X-Goog-FieldMask (см. доступные параметры и заголовки URL-адреса . Значение представляет собой список путей к полям, разделенных запятыми. См. подробную документацию о том, как создавать пути к полям .

Например, в этом методе:

Маска поля всех доступных полей (для ручной проверки): X-Goog-FieldMask: *
Маска поля длительности маршрута, расстояний, статуса элемента, состояния и индексов элемента (пример настройки производства): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Крайне важно, чтобы вы включали status в маску поля, иначе все сообщения будут выглядеть нормально. Google не рекомендует использовать маску поля ответа с подстановочным знаком ( * ), потому что:

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

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes( ComputeRoutesRequest ) returns ( ComputeRoutesResponse )` Возвращает основной маршрут вместе с необязательными альтернативными маршрутами с заданным набором конечных и промежуточных путевых точек. ПРИМЕЧАНИЕ. Этот метод требует, чтобы вы указали маску поля ответа во входных данных. Вы можете указать маску поля ответа, используя параметр URL-адреса `$fields` или `fields` или используя заголовок HTTP/gRPC `X-Goog-FieldMask` (см. доступные параметры и заголовки URL-адреса . Значение представляет собой список путей к полям, разделенных запятыми. См. подробная документация о том, как создавать пути к полям . Например, в этом методе: Маска поля всех доступных полей (для ручной проверки): `X-Goog-FieldMask: ` Маска поля длительности, расстояния и полилинии на уровне маршрута (пример производственной настройки): `X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` Google не рекомендует использовать маску поля ответа с подстановочным знаком ( `` ) или указывать маску поля на верхнем уровне ( `routes` ), потому что: Выбор только тех полей, которые вам нужны, помогает нашему серверу экономить вычислительные циклы, позволяя нам возвращать вам результат с меньшей задержкой. Выбор только тех полей, которые вам нужны в рабочем задании, обеспечивает стабильную производительность задержки. Возможно, в будущем мы добавим больше полей ответа, и эти новые поля могут потребовать дополнительного времени вычислений. Если вы выберете все поля или если вы выберете все поля на верхнем уровне, вы можете столкнуться с ухудшением производительности, поскольку любое новое поле, которое мы добавляем, будет автоматически включено в ответ. Выбор только тех полей, которые вам нужны, приводит к меньшему размеру ответа и, следовательно, к более высокой пропускной способности сети.

rpc ComputeRoutes( ComputeRoutesRequest ) returns ( ComputeRoutesResponse )

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

ПРИМЕЧАНИЕ. Этот метод требует, чтобы вы указали маску поля ответа во входных данных. Вы можете указать маску поля ответа, используя параметр URL-адреса $fields или fields или используя заголовок HTTP/gRPC X-Goog-FieldMask (см. доступные параметры и заголовки URL-адреса . Значение представляет собой список путей к полям, разделенных запятыми. См. подробная документация о том, как создавать пути к полям .

Например, в этом методе:

Маска поля всех доступных полей (для ручной проверки): X-Goog-FieldMask: *
Маска поля длительности, расстояния и полилинии на уровне маршрута (пример производственной настройки): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google не рекомендует использовать маску поля ответа с подстановочным знаком ( * ) или указывать маску поля на верхнем уровне ( routes ), потому что:

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

ComputeRouteMatrixRequest

Сообщение запроса ComputeRouteMatrix

Поля
`origins[]`	`RouteMatrixOrigin` Необходимый. Массив источников, который определяет строки матрицы ответов. Несколько ограничений по размеру применяются к кардинальности пунктов отправления и назначения: Сумма количества источников + количество пунктов назначения, указанных либо как `place_id` , либо как `address` не должна превышать 50. Произведение количества отправлений × количество мест назначения в любом случае не должно превышать 625. Произведение количества источников на количество пунктов назначения не должно превышать 100, если для параметра routing_preference установлено значение `TRAFFIC_AWARE_OPTIMAL` . Произведение количества пунктов отправления × количество пунктов назначения не должно превышать 100, если для параметра travel_mode установлено значение `TRANSIT` .
`destinations[]`	`RouteMatrixDestination` Необходимый. Массив адресатов, определяющий столбцы матрицы ответов.
`travel_mode`	`RouteTravelMode` Необязательный. Определяет вид транспорта.
`routing_preference`	`RoutingPreference` Необязательный. Указывает, как вычислить маршрут. Сервер пытается использовать выбранный параметр маршрутизации для расчета маршрута. Если предпочтение маршрутизации приводит к ошибке или слишком большой задержке, возвращается ошибка. Вы можете указать эту опцию только тогда, когда `travel_mode` имеет `DRIVE` или `TWO_WHEELER` , в противном случае запрос не будет выполнен.
`departure_time`	`Timestamp` Необязательный. Время отправления. Если вы не зададите это значение, то оно будет по умолчанию равно времени, когда вы сделали запрос. ПРИМЕЧАНИЕ. `departure_time` в прошлом можно указать только в том случае, если для `RouteTravelMode` установлено значение `TRANSIT` .
`arrival_time`	`Timestamp` Необязательный. Время прибытия. ПРИМЕЧАНИЕ. Можно установить, только если для `RouteTravelMode` установлено значение `TRANSIT` . Вы можете указать либо `departure_time` , либо `arrival_time` , но не то и другое одновременно.
`language_code`	`string` Необязательный. Код языка BCP-47, например «en-US» или «sr-Latn». Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . Список поддерживаемых языков см. в разделе Языковая поддержка . Если вы не укажете это значение, язык отображения выводится из местоположения первого источника.
`region_code`	`string` Необязательный. Код региона, указанный как двухсимвольное значение ccTLD («домен верхнего уровня»). Для получения дополнительной информации см. https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains .
`extra_computations[]`	`ExtraComputation` Необязательный. Список дополнительных вычислений, которые могут быть использованы для выполнения запроса. Примечание. Эти дополнительные вычисления могут возвращать дополнительные поля в ответе. Эти дополнительные поля также должны быть указаны в маске поля, которая будет возвращена в ответе.
`traffic_model`	`TrafficModel` Необязательный. Указывает допущения, используемые при расчете времени в пробке. Этот параметр влияет на значение, возвращаемое в поле продолжительности в `RouteMatrixElement` , которое содержит прогнозируемое время в трафике на основе средних значений за прошлые периоды. `RoutingPreference` на `TRAFFIC_AWARE_OPTIMAL` и `RouteTravelMode` на `DRIVE` . По умолчанию `BEST_GUESS` если запрашивается трафик, а `TrafficModel` не указан.
`transit_preferences`	`TransitPreferences` Необязательный. Указывает предпочтения, влияющие на маршрут, возвращаемый для `TRANSIT` маршрутов. ПРИМЕЧАНИЕ. Вы можете указать `transit_preferences` только в том случае, если для `RouteTravelMode` установлено значение `TRANSIT` .

Дополнительные вычисления

Дополнительные вычисления для выполнения при выполнении запроса.

перечисления
`EXTRA_COMPUTATION_UNSPECIFIED`	Не используется. Запросы, содержащие это значение, не будут выполнены.
`TOLLS`	Информация о платных дорогах для элемента(ов) матрицы.

ComputeRoutesRequest

Сообщение запроса ComputeRoutes.

Поля
`origin`	`Waypoint` Необходимый. Исходная путевая точка.
`destination`	`Waypoint` Необходимый. Пункт назначения.
`intermediates[]`	`Waypoint` Необязательный. Набор путевых точек на маршруте (исключая конечные точки), на которых можно остановиться или проехать. Поддерживается до 25 промежуточных путевых точек.
`travel_mode`	`RouteTravelMode` Необязательный. Определяет вид транспорта.
`routing_preference`	`RoutingPreference` Необязательный. Указывает, как вычислить маршрут. Сервер пытается использовать выбранный параметр маршрутизации для расчета маршрута. Если предпочтение маршрутизации приводит к ошибке или слишком большой задержке, возвращается ошибка. Вы можете указать эту опцию только тогда, когда `travel_mode` имеет `DRIVE` или `TWO_WHEELER` , в противном случае запрос не будет выполнен.
`polyline_quality`	`PolylineQuality` Необязательный. Определяет ваши предпочтения в отношении качества полилинии.
`polyline_encoding`	`PolylineEncoding` Необязательный. Задает предпочтительную кодировку полилинии.
`departure_time`	`Timestamp` Необязательный. Время отправления. Если вы не зададите это значение, то оно будет по умолчанию равно времени, когда вы сделали запрос. ПРИМЕЧАНИЕ. `departure_time` в прошлом можно указать только в том случае, если для `RouteTravelMode` установлено значение `TRANSIT` .
`arrival_time`	`Timestamp` Необязательный. Время прибытия. ПРИМЕЧАНИЕ. Можно установить, только если для `RouteTravelMode` установлено значение `TRANSIT` . Вы можете указать либо `departure_time` , либо `arrival_time` , но не то и другое одновременно.
`compute_alternative_routes`	`bool` Необязательный. Указывает, следует ли рассчитывать альтернативные маршруты в дополнение к маршруту. Для запросов с промежуточными путевыми точками альтернативные маршруты не возвращаются.
`route_modifiers`	`RouteModifiers` Необязательный. Набор условий, которые влияют на способ расчета маршрутов.
`language_code`	`string` Необязательный. Код языка BCP-47, например «en-US» или «sr-Latn». Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . Список поддерживаемых языков см. в разделе Языковая поддержка . Если вы не укажете это значение, язык интерфейса выводится из расположения запроса маршрута.
`region_code`	`string` Необязательный. Код региона, указанный как двухсимвольное значение ccTLD («домен верхнего уровня»). Для получения дополнительной информации см. https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains .
`units`	`Units` Необязательный. Указывает единицы измерения для отображаемых полей. Эти поля включают поле `instruction` в `NavigationInstruction` . Это значение не влияет на единицы измерения, используемые для маршрута, этапа, длины шага и продолжительности. Если вы не укажете это значение, то единицы отображения выводятся из местоположения первого источника.
`optimize_waypoint_order`	`bool` Необязательный. Если установлено значение true, служба пытается минимизировать общую стоимость маршрута, переупорядочив указанные промежуточные путевые точки. Запрос не выполняется, если какая-либо из промежуточных путевых точек является `via` путевой точкой. Используйте `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` , чтобы найти новый порядок. Если `ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index` не запрашивается в заголовке `X-Goog-FieldMask` , запрос не выполняется. Если для `optimize_waypoint_order` установлено значение false, `ComputeRoutesResponse.optimized_intermediate_waypoint_index` будет пустым.
`requested_reference_routes[]`	`ReferenceRoute` Необязательный. Указывает, какие эталонные маршруты следует рассчитать как часть запроса в дополнение к маршруту по умолчанию. Эталонный маршрут — это маршрут с целью расчета маршрута, отличной от маршрута по умолчанию. Например, при расчете эталонного маршрута `FUEL_EFFICIENT` учитываются различные параметры, которые позволяют создать оптимальный маршрут с эффективным расходом топлива.
`extra_computations[]`	`ExtraComputation` Необязательный. Список дополнительных вычислений, которые могут быть использованы для выполнения запроса. Примечание. Эти дополнительные вычисления могут возвращать дополнительные поля в ответе. Эти дополнительные поля также должны быть указаны в маске поля, которая будет возвращена в ответе.
`traffic_model`	`TrafficModel` Необязательный. Указывает допущения, используемые при расчете времени в пробке. Этот параметр влияет на значение, возвращаемое в поле длительности в `Route` и `RouteLeg` , которое содержит прогнозируемое время в трафике на основе средних значений за прошлые периоды. `TrafficModel` доступен только для запросов, в которых `RoutingPreference` задано значение `TRAFFIC_AWARE_OPTIMAL` , а `RouteTravelMode` — значение `DRIVE` . По умолчанию `BEST_GUESS` если запрашивается трафик, а `TrafficModel` не указан.
`transit_preferences`	`TransitPreferences` Необязательный. Указывает предпочтения, влияющие на маршрут, возвращаемый для `TRANSIT` маршрутов. ПРИМЕЧАНИЕ. Вы можете указать `transit_preferences` только в том случае, если для `RouteTravelMode` установлено значение `TRANSIT` .

Дополнительные вычисления

Дополнительные вычисления для выполнения при выполнении запроса.

перечисления
`EXTRA_COMPUTATION_UNSPECIFIED`	Не используется. Запросы, содержащие это значение, не будут выполнены.
`TOLLS`	Информация о платных проездах по маршруту(ам).
`FUEL_CONSUMPTION`	Расчетный расход топлива по маршруту(ам).
`TRAFFIC_ON_POLYLINE`	Полилинии с учетом трафика для маршрута(ов).
`HTML_FORMATTED_NAVIGATION_INSTRUCTIONS`	Инструкции по навигации представлены в виде форматированной текстовой строки HTML. Этот контент предназначен для чтения как есть. Этот контент предназначен только для отображения. Не анализируйте его программно.

СсылкаМаршрут

Поддерживаемый эталонный маршрут в ComputeRoutesRequest.

перечисления
`REFERENCE_ROUTE_UNSPECIFIED`	Не используется. Запросы, содержащие это значение, не выполняются.
`FUEL_EFFICIENT`	Топливоэффективный маршрут. Маршруты, отмеченные этим значением, определены как оптимизированные по таким параметрам, как расход топлива.

ComputeRoutesResponse

ComputeНаправляет ответное сообщение.

Поля

Поля
`routes[]`	`Route` Содержит массив вычисленных маршрутов (до трех), если вы укажете calculate_alternatives_routes, и содержит только один маршрут, если вы этого не сделаете. Когда этот массив содержит несколько записей, наиболее рекомендуемым маршрутом является первая. Если массив пуст, значит маршрут не найден.
`fallback_info`	`FallbackInfo` В некоторых случаях, когда сервер не может вычислить результаты маршрута со всеми параметрами ввода, он может вернуться к использованию другого способа вычисления. При использовании резервного режима это поле содержит подробную информацию о резервном ответе. В противном случае это поле не установлено.
`geocoding_results`	`GeocodingResults` Содержит информацию ответа геокодирования для путевых точек, указанных как адреса.

routes[]

Route

Содержит массив вычисленных маршрутов (до трех), если вы укажете calculate_alternatives_routes, и содержит только один маршрут, если вы этого не сделаете. Когда этот массив содержит несколько записей, наиболее рекомендуемым маршрутом является первая. Если массив пуст, значит маршрут не найден.

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

Содержит информацию ответа геокодирования для путевых точек, указанных как адреса.

FallbackInfo

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

Поля

Поля
`routing_mode`	`FallbackRoutingMode` Режим маршрутизации, используемый для ответа. Если сработал резервный вариант, режим может отличаться от предпочтения маршрутизации, установленного в исходном клиентском запросе.
`reason`	`FallbackReason` Причина, по которой вместо исходного ответа использовался резервный ответ. Это поле заполняется только тогда, когда срабатывает резервный режим и возвращается аварийный ответ.

routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

ОткатПричина

Причины использования резервного ответа.

перечисления
`FALLBACK_REASON_UNSPECIFIED`	Причина отката не указана.
`SERVER_ERROR`	Произошла ошибка сервера при расчете маршрутов с вашим предпочтительным режимом маршрутизации, но мы смогли вернуть результат, рассчитанный альтернативным режимом.
`LATENCY_EXCEEDED`	Мы не смогли вовремя завершить расчет с предпочитаемым вами режимом маршрутизации, но смогли вернуть результат, рассчитанный по альтернативному режиму.

FallbackRoutingMode

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

перечисления
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	Не используется.
`FALLBACK_TRAFFIC_UNAWARE`	Указывает, что `TRAFFIC_UNAWARE` `google.maps.routing.v2.RoutingPreference` использовался для вычисления ответа.
`FALLBACK_TRAFFIC_AWARE`	Указывает, что `TRAFFIC_AWARE` `RoutingPreference` использовался для вычисления ответа.

GeocodedWaypoint

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

Поля
`geocoder_status`	`Status` Указывает код состояния, полученный в результате операции геокодирования.
`type[]`	`string` Тип(ы) результата в виде нуля или более тегов типа. Поддерживаемые типы: https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types .
`partial_match`	`bool` Указывает, что геокодер не вернул точное совпадение с исходным запросом, хотя смог сопоставить часть запрошенного адреса. Вы можете проверить первоначальный запрос на наличие опечаток и/или неполного адреса.
`place_id`	`string` Идентификатор места для этого результата.
`intermediate_waypoint_request_index`	`int32` Индекс соответствующей промежуточной путевой точки в запросе. Заполняется только в том случае, если соответствующая путевая точка является промежуточной путевой точкой.

Результаты геокодирования

Содержит GeocodedWaypoints для начальной, конечной и промежуточных путевых точек. Заполняется только для адресных путевых точек.

Поля

Поля
`origin`	`GeocodedWaypoint` Исходная геокодированная путевая точка.
`destination`	`GeocodedWaypoint` Геокодированная путевая точка назначения.
`intermediates[]`	`GeocodedWaypoint` Список промежуточных геокодированных путевых точек, каждая из которых содержит поле индекса, соответствующее отсчитываемому от нуля положению путевой точки в том порядке, в котором они были указаны в запросе.

origin

GeocodedWaypoint

Исходная геокодированная путевая точка.

destination

GeocodedWaypoint

Геокодированная путевая точка назначения.

intermediates[]

GeocodedWaypoint

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

Локализованное время

Локализованное описание времени.

Поля

Поля
`time`	`LocalizedText` Время, указанное в виде строки в заданном часовом поясе.
`time_zone`	`string` Содержит часовой пояс. Значение представляет собой название часового пояса, определенное в базе данных часовых поясов IANA , например, «Америка/Нью-Йорк».

time

LocalizedText

Время, указанное в виде строки в заданном часовом поясе.

time_zone

string

Содержит часовой пояс. Значение представляет собой название часового пояса, определенное в базе данных часовых поясов IANA , например, «Америка/Нью-Йорк».

Расположение

Инкапсулирует местоположение (географическую точку и необязательный заголовок).

Поля

Поля
`lat_lng`	`LatLng` Географические координаты путевой точки.
`heading`	`Int32Value` Курс по компасу связан с направлением движения транспорта. Это значение указывает сторону дороги для посадки и высадки. Значения направления могут быть от 0 до 360, где 0 указывает направление строго на север, 90 указывает направление строго на восток и так далее. Вы можете использовать это поле только для `DRIVE` и `TWO_WHEELER` `RouteTravelMode` .

lat_lng

LatLng

Географические координаты путевой точки.

heading

Int32Value

Курс по компасу связан с направлением движения транспорта. Это значение указывает сторону дороги для посадки и высадки. Значения направления могут быть от 0 до 360, где 0 указывает направление строго на север, 90 указывает направление строго на восток и так далее. Вы можете использовать это поле только для DRIVE и TWO_WHEELER RouteTravelMode .

Маневр

Набор значений, определяющих действие навигации для текущего шага (например, повернуть налево, объединиться, прямо и т. д.).

перечисления
`MANEUVER_UNSPECIFIED`	Не используется.
`TURN_SLIGHT_LEFT`	Поверните немного влево.
`TURN_SHARP_LEFT`	Резко повернуть налево.
`UTURN_LEFT`	Сделайте левый разворот.
`TURN_LEFT`	Поверните налево.
`TURN_SLIGHT_RIGHT`	Поверните немного вправо.
`TURN_SHARP_RIGHT`	Резко поверните направо.
`UTURN_RIGHT`	Сделайте правый разворот.
`TURN_RIGHT`	Поверните направо.
`STRAIGHT`	Езжайте прямо.
`RAMP_LEFT`	Возьмите левый пандус.
`RAMP_RIGHT`	Возьмите правый пандус.
`MERGE`	Слиться с трафиком.
`FORK_LEFT`	Возьмите левую развилку.
`FORK_RIGHT`	Возьмите правую вилку.
`FERRY`	Сядьте на паром.
`FERRY_TRAIN`	Сядьте на поезд, ведущий на паром.
`ROUNDABOUT_LEFT`	Поверните налево на кольцевой развязке.
`ROUNDABOUT_RIGHT`	Поверните направо на кольцевой развязке.
`DEPART`	Начальный маневр.
`NAME_CHANGE`	Используется для обозначения изменения названия улицы.

Инструкция по навигации

Инкапсулирует инструкции по навигации для RouteLegStep .

Поля

maneuver

Maneuver

Инкапсулирует навигационные инструкции для текущего шага (например, повернуть налево, объединиться, прямо и т. д.). Это поле определяет, какой значок отображать.

instructions

string

Инструкции по прохождению этого шага.

Полилиния

Инкапсулирует закодированную полилинию.

Поля

Поля
Поле объединения `polyline_type` . Инкапсулирует тип полилинии. По умолчанию используется encoded_polyline. `polyline_type` может быть только одним из следующих:
`encoded_polyline`	`string` Строковое кодирование полилинии с использованием алгоритма кодирования полилинии
`geo_json_linestring`	`Struct` Задает полилинию, используя формат GeoJSON LineString.

Поле объединения polyline_type . Инкапсулирует тип полилинии. По умолчанию используется encoded_polyline. polyline_type может быть только одним из следующих:

encoded_polyline

string

Строковое кодирование полилинии с использованием алгоритма кодирования полилинии

geo_json_linestring

Struct

Задает полилинию, используя формат GeoJSON LineString.

ПолилинияКодирование

Указывает предпочтительный тип возвращаемой полилинии.

перечисления
`POLYLINE_ENCODING_UNSPECIFIED`	Не указан предпочтительный тип полилинии. По умолчанию `ENCODED_POLYLINE` .
`ENCODED_POLYLINE`	Указывает полилинию, закодированную с использованием алгоритма кодирования полилинии .
`GEO_JSON_LINESTRING`	Задает полилинию, используя формат GeoJSON LineString.

PolylineQuality

Набор значений, определяющих качество полилинии.

перечисления
`POLYLINE_QUALITY_UNSPECIFIED`	Не заданы предпочтения качества полилиний. По умолчанию `OVERVIEW` .
`HIGH_QUALITY`	Указывает высококачественную полилинию, которая состоит из большего количества точек, чем `OVERVIEW` , за счет увеличения размера ответа. Используйте это значение, когда вам нужна большая точность.
`OVERVIEW`	Определяет обзорную полилинию, состоящую из небольшого количества точек. Используйте это значение при отображении обзора маршрута. Использование этого параметра имеет меньшую задержку запроса по сравнению с использованием параметра `HIGH_QUALITY` .

Маршрут

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

Поля
`route_labels[]`	`RouteLabel` Метки для `Route` , которые полезны для определения конкретных свойств маршрута для сравнения с другими.
`legs[]`	`RouteLeg` Набор участков (сегментов пути между путевыми точками), составляющих маршрут. Каждый этап соответствует поездке между двумя `via` `Waypoints` . Например, маршрут без промежуточных путевых точек имеет только один этап. Маршрут, включающий одну `via` путевую точку, не являющуюся промежуточной, имеет два этапа. Маршрут, который включает в себя один маршрут `via` промежуточную путевую точку, имеет один этап. Порядок этапов соответствует порядку путевых точек от `origin` к `intermediates` `destination` .
`distance_meters`	`int32` Протяженность маршрута, в метрах.
`duration`	`Duration` Время, необходимое для прохождения маршрута. Если вы установите для `routing_preference` значение `TRAFFIC_UNAWARE` , то это значение будет таким же, как `static_duration` . Если для параметра `routing_preference` установлено значение `TRAFFIC_AWARE` или `TRAFFIC_AWARE_OPTIMAL` , это значение рассчитывается с учетом условий трафика.
`static_duration`	`Duration` Продолжительность проезда по маршруту без учета условий движения.
`polyline`	`Polyline` Общая полилиния маршрута. Эта полилиния представляет собой комбинированную полилинию всех `legs` .
`description`	`string` Описание маршрута.
`warnings[]`	`string` Массив предупреждений для отображения при отображении маршрута.
`viewport`	`Viewport` Ограничивающая рамка области просмотра полилинии.
`travel_advisory`	`RouteTravelAdvisory` Дополнительная информация о маршруте.
`optimized_intermediate_waypoint_index[]`	`int32` Если вы установите для `optimize_waypoint_order` значение true, это поле будет содержать оптимизированный порядок промежуточных путевых точек. В противном случае это поле пустое. Например, если вы вводите Origin: LA; Промежуточные путевые точки: Даллас, Бангор, Феникс; Пункт назначения: Нью-Йорк; а оптимизированный порядок промежуточных путевых точек — Феникс, Даллас, Бангор, то это поле содержит значения [2, 0, 1]. Индекс начинается с 0 для первой промежуточной путевой точки, предоставленной во входных данных.
`localized_values`	`RouteLocalizedValues` Текстовые представления свойств `Route` .
`route_token`	`string` Веб-безопасный токен маршрута в кодировке base64, который можно передать в пакет SDK для навигации, который позволяет пакету навигации для навигации реконструировать маршрут во время навигации и, в случае изменения маршрута, соблюдать исходное намерение при создании маршрута путем вызова Вычислить маршруты. Клиенты должны рассматривать этот токен как непрозрачный большой двоичный объект. Он не предназначен для чтения или изменения. ПРИМЕЧАНИЕ. `Route.route_token` доступен только для запросов, в которых для `ComputeRoutesRequest.routing_preference` задано значение `TRAFFIC_AWARE` или `TRAFFIC_AWARE_OPTIMAL` . `Route.route_token` не поддерживается для запросов с путевыми точками Via.

Маршрутлокализованные значения

Текстовые представления определенных свойств.

Поля
`distance`	`LocalizedText` Пройденное расстояние представлено в текстовой форме.
`duration`	`LocalizedText` Продолжительность с учетом дорожных условий, представленная в текстовом виде. Примечание. Если вы не запрашивали информацию о трафике, это значение будет таким же, как и static_duration.
`static_duration`	`LocalizedText` Продолжительность без учета условий движения, представленная в текстовом виде.
`transit_fare`	`LocalizedText` Транзитный тариф представлен в текстовом виде.

Метка маршрута

Метки для Route , которые полезны для определения конкретных свойств маршрута для сравнения с другими.

перечисления
`ROUTE_LABEL_UNSPECIFIED`	По умолчанию - не используется.
`DEFAULT_ROUTE`	«Лучший» маршрут по умолчанию, возвращенный для расчета маршрута.
`DEFAULT_ROUTE_ALTERNATE`	Альтернатива «лучшему» маршруту по умолчанию. Маршруты, подобные этому, будут возвращены, если указан параметр `compute_alternative_routes` .
`FUEL_EFFICIENT`	Топливоэффективный маршрут. Маршруты, помеченные этим значением, оптимизированы для таких параметров Eco, как расход топлива.

МаршрутЭтап

Содержит сегмент между via путевыми точками.

Поля
`distance_meters`	`int32` Протяженность участка маршрута, в метрах.
`duration`	`Duration` Продолжительность времени, необходимого для прохождения ноги. Если для `route_preference` установлено значение `TRAFFIC_UNAWARE` , то это значение совпадает со `static_duration` . Если `route_preference` имеет значение `TRAFFIC_AWARE` или `TRAFFIC_AWARE_OPTIMAL` , то это значение рассчитывается с учетом условий трафика.
`static_duration`	`Duration` Продолжительность проезда по этапу, рассчитанная без учета условий движения.
`polyline`	`Polyline` Общая полилиния для этого отрезка, включающая полилинию каждого `step` .
`start_location`	`Location` Место начала этого этапа. Это местоположение может отличаться от указанного `origin` . Например, если исходная `origin` не находится рядом с дорогой, это точка на дороге.
`end_location`	`Location` Конечное место этой ноги. Это местоположение может отличаться от указанного `destination` . Например, если указанный `destination` находится не рядом с дорогой, это точка на дороге.
`steps[]`	`RouteLegStep` Массив шагов, обозначающих сегменты в пределах этой ветви. Каждый шаг представляет собой одну инструкцию навигации.
`travel_advisory`	`RouteLegTravelAdvisory` Содержит дополнительную информацию, о которой должен быть проинформирован пользователь, например, возможные ограничения зоны движения на участке маршрута.
`localized_values`	`RouteLegLocalizedValues` Текстовые представления свойств `RouteLeg` .
`steps_overview`	`StepsOverview` Обзорная информация о шагах в этом `RouteLeg` . Это поле заполняется только для ТРАНЗИТНЫХ маршрутов.

RouteLegLocalizedValues

Текстовые представления определенных свойств.

Поля

distance

LocalizedText

Пройденное расстояние представлено в текстовой форме.

duration

LocalizedText

Продолжительность с учетом условий движения представлена в текстовом виде. Примечание. Если вы не запрашивали информацию о трафике, это значение будет таким же, как и static_duration.

static_duration

LocalizedText

Продолжительность без учета условий движения, представленная в текстовом виде.

ШагиОбзор

Предоставляет обзорную информацию о списке RouteLegStep s.

Поля

Поля
`multi_modal_segments[]`	`MultiModalSegment` Обобщенная информация о различных мультимодальных сегментах `RouteLeg.steps` . Это поле не заполняется, если `RouteLeg` не содержит мультимодальных сегментов в шагах.

multi_modal_segments[]

MultiModalSegment

Обобщенная информация о различных мультимодальных сегментах RouteLeg.steps . Это поле не заполняется, если RouteLeg не содержит мультимодальных сегментов в шагах.

Мультимодальный сегмент

Предоставляет сводную информацию о различных мультимодальных сегментах RouteLeg.steps . Мультимодальный сегмент определяется как один или несколько смежных RouteLegStep , которые имеют один и тот же RouteTravelMode . Это поле не заполняется, если RouteLeg не содержит мультимодальных сегментов в шагах.

Поля
`navigation_instruction`	`NavigationInstruction` NavigationInstruction для мультимодального сегмента.
`travel_mode`	`RouteTravelMode` Режим движения мультимодального сегмента.
`step_start_index`	`int32` Соответствующий индекс `RouteLegStep` , который является началом мультимодального сегмента.
`step_end_index`	`int32` Соответствующий индекс `RouteLegStep` , являющийся концом мультимодального сегмента.

МаршрутLegStep

Содержит сегмент RouteLeg . Шаг соответствует одной инструкции навигации. Участки маршрута состоят из ступенек.

Поля
`distance_meters`	`int32` Расстояние прохождения этого шага в метрах. В некоторых случаях это поле может не иметь значения.
`static_duration`	`Duration` Продолжительность проезда через этот этап без учета условий движения. В некоторых случаях это поле может не иметь значения.
`polyline`	`Polyline` Полилиния, связанная с этим шагом.
`start_location`	`Location` Место начала этого шага.
`end_location`	`Location` Место окончания этого шага.
`navigation_instruction`	`NavigationInstruction` Инструкции по навигации.
`travel_advisory`	`RouteLegStepTravelAdvisory` Содержит дополнительную информацию, о которой должен быть проинформирован пользователь, например, возможные ограничения зоны движения на шаге ноги.
`localized_values`	`RouteLegStepLocalizedValues` Текстовые представления свойств `RouteLegStep` .
`transit_details`	`RouteLegStepTransitDetails` Подробности, относящиеся к этому шагу, если выбран режим передвижения `TRANSIT` .
`travel_mode`	`RouteTravelMode` Режим движения, используемый для этого шага.

RouteLegStepLocalizedValues

Текстовые представления определенных свойств.

Поля

distance

LocalizedText

Пройденное расстояние представлено в текстовой форме.

static_duration

LocalizedText

Продолжительность без учета условий движения, представленная в текстовом виде.

RouteLegStepTransitDetails

Дополнительная информация для RouteLegStep , относящаяся к TRANSIT маршрутам.

Поля
`stop_details`	`TransitStopDetails` Информация о прибытии и отправлении остановок для шага.
`localized_values`	`TransitDetailsLocalizedValues` Текстовые представления свойств `RouteLegStepTransitDetails` .
`headsign`	`string` Указывает направление движения по этой линии, отмеченное на транспортном средстве или на остановке отправления. Направление часто является конечной станцией.
`headway`	`Duration` Указывает ожидаемое время как продолжительность между отправлениями с одной и той же остановки в это время. Например, при значении интервала в секундах, равном 600, вы ожидаете десятиминутное ожидание, если опоздаете на автобус.
`transit_line`	`TransitLine` Информация о транзитной линии, используемой на этом этапе.
`stop_count`	`int32` Количество остановок от отправления до остановки прибытия. Этот подсчет включает остановку прибытия, но не включает остановку отправления. Например, если ваш маршрут отправляется с остановки A, проходит через остановки B и C и прибывает на остановку D, stop_count вернет 3.
`trip_short_text`	`string` Текст, который появляется в расписаниях и на вывесках для обозначения транзитной поездки для пассажиров. Текст должен однозначно идентифицировать поездку в течение служебного дня. Например, «538» — это `trip_short_text` поезда Amtrak, который отправляется из Сан-Хосе, Калифорния, в 15:10 по будням в Сакраменто, Калифорния.

TransitDetailsLocalizedValues

Локализованные описания значений RouteTransitDetails.

Поля

Поля
`arrival_time`	`LocalizedTime` Время в форматированном текстовом представлении с соответствующим часовым поясом.
`departure_time`	`LocalizedTime` Время в форматированном текстовом представлении с соответствующим часовым поясом.

arrival_time

LocalizedTime

Время в форматированном текстовом представлении с соответствующим часовым поясом.

departure_time

LocalizedTime

Время в форматированном текстовом представлении с соответствующим часовым поясом.

ТранзитОстановкаДетали

Подробная информация об остановках общественного транспорта для RouteLegStep

Поля
`arrival_stop`	`TransitStop` Информация об остановке прибытия на этап.
`arrival_time`	`Timestamp` Расчетное время прибытия на шаг.
`departure_stop`	`TransitStop` Информация об остановке отправления на ступень.
`departure_time`	`Timestamp` Расчетное время выхода на этап.

RouteLegStepTravelAdvisory

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

Поля

Поля
`speed_reading_intervals[]`	`SpeedReadingInterval` ПРИМЕЧАНИЕ. В настоящее время это поле не заполнено.

speed_reading_intervals[]

SpeedReadingInterval

ПРИМЕЧАНИЕ. В настоящее время это поле не заполнено.

RouteLegTravelAdvisory

Содержит дополнительную информацию, о которой пользователь должен быть проинформирован на этапе перехода, например, возможные ограничения зоны движения.

Поля

Поля
`toll_info`	`TollInfo` Содержит информацию о платных проездах по конкретному `RouteLeg` . Это поле заполняется только в том случае, если мы ожидаем, что на `RouteLeg` есть дорожные сборы. Если это поле установлено, но подполе предполагаемая_цена не заполнено, мы ожидаем, что дорога содержит плату за проезд, но мы не знаем расчетной цены. Если это поле не существует, то на `RouteLeg` плата не взимается.
`speed_reading_intervals[]`	`SpeedReadingInterval` Интервалы скорочтения с подробным описанием плотности трафика. Применимо в случае настроек маршрутизации `TRAFFIC_AWARE` и `TRAFFIC_AWARE_OPTIMAL` . Интервалы охватывают всю полилинию `RouteLeg` без перекрытия. Начальная точка указанного интервала совпадает с конечной точкой предыдущего интервала. Пример: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

Содержит информацию о платных проездах по конкретному RouteLeg . Это поле заполняется только в том случае, если мы ожидаем, что на RouteLeg есть дорожные сборы. Если это поле установлено, но подполе предполагаемая_цена не заполнено, мы ожидаем, что дорога содержит плату за проезд, но мы не знаем расчетной цены. Если это поле не существует, то на RouteLeg плата не взимается.

speed_reading_intervals[]

SpeedReadingInterval

Интервалы скорочтения с подробным описанием плотности трафика. Применимо в случае настроек маршрутизации TRAFFIC_AWARE и TRAFFIC_AWARE_OPTIMAL . Интервалы охватывают всю полилинию RouteLeg без перекрытия. Начальная точка указанного интервала совпадает с конечной точкой предыдущего интервала.

Пример:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

Единое назначение для ComputeRouteMatrixRequest

Поля

Поля
`waypoint`	`Waypoint` Необходимый. Пункт назначения

waypoint

Waypoint

Необходимый. Пункт назначения

RouteMatrixElement

Содержит информацию о маршруте, вычисленную для пары исходной/конечной точки в API ComputeRouteMatrix. Этот прототип можно передать клиенту.

Поля
`status`	`Status` Код состояния ошибки для этого элемента.
`condition`	`RouteMatrixElementCondition` Указывает, был ли маршрут найден или нет. Независимость от статуса.
`distance_meters`	`int32` Протяженность маршрута, в метрах.
`duration`	`Duration` Время, необходимое для прохождения маршрута. Если вы установите для `routing_preference` значение `TRAFFIC_UNAWARE` , то это значение будет таким же, как `static_duration` . Если для параметра `routing_preference` установлено значение `TRAFFIC_AWARE` или `TRAFFIC_AWARE_OPTIMAL` , это значение рассчитывается с учетом условий трафика.
`static_duration`	`Duration` Продолжительность движения по маршруту без учета условий движения.
`travel_advisory`	`RouteTravelAdvisory` Дополнительная информация о маршруте. Например: информация об ограничениях и информация о платных дорогах
`fallback_info`	`FallbackInfo` В некоторых случаях, когда сервер не может рассчитать маршрут с заданными предпочтениями для этой конкретной пары отправной точки/назначения, он может вернуться к использованию другого режима вычисления. При использовании резервного режима это поле содержит подробную информацию о резервном ответе. В противном случае это поле не установлено.
`localized_values`	`LocalizedValues` Текстовые представления свойств `RouteMatrixElement` .
`origin_index`	`int32` Отсчитываемый от нуля индекс источника в запросе.
`destination_index`	`int32` Отсчитываемый от нуля индекс адресата в запросе.

Локализованные значения

Текстовые представления определенных свойств.

Поля
`distance`	`LocalizedText` Пройденное расстояние представлено в текстовой форме.
`duration`	`LocalizedText` Продолжительность представлена в текстовом виде с учетом дорожных условий. Примечание. Если информация о трафике не запрашивалась, это значение совпадает со значением static_duration.
`static_duration`	`LocalizedText` Продолжительность представлена в текстовом виде без учета дорожных условий.
`transit_fare`	`LocalizedText` Транзитный тариф представлен в текстовом виде.

RouteMatrixElementCondition

Состояние возвращаемого маршрута.

перечисления
`ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED`	Используется только тогда, когда `status` элемента не в порядке.
`ROUTE_EXISTS`	Маршрут был найден, и для элемента была заполнена соответствующая информация.
`ROUTE_NOT_FOUND`	Не удалось найти маршрут. Поля, содержащие информацию о маршруте, например, `distance_meters` или `duration` , не будут заполнены в элементе.

RouteMatrixOrigin

Единый источник для ComputeRouteMatrixRequest

Поля

Поля
`waypoint`	`Waypoint` Необходимый. Исходная путевая точка
`route_modifiers`	`RouteModifiers` Необязательный. Модификаторы для каждого маршрута, который принимает это как начало

waypoint

Waypoint

Необходимый. Исходная путевая точка

route_modifiers

RouteModifiers

Необязательный. Модификаторы для каждого маршрута, который принимает это как начало

Модификаторы маршрута

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

Поля
`avoid_tolls`	`bool` При значении true избегает платных дорог там, где это целесообразно, отдавая предпочтение маршрутам, не содержащим платных дорог. Применяется только к `DRIVE` и `TWO_WHEELER` `RouteTravelMode` .
`avoid_highways`	`bool` When set to true, avoids highways where reasonable, giving preference to routes not containing highways. Applies only to the `DRIVE` and `TWO_WHEELER` `RouteTravelMode` .
`avoid_ferries`	`bool` When set to true, avoids ferries where reasonable, giving preference to routes not containing ferries. Applies only to the `DRIVE` and `TWO_WHEELER` `RouteTravelMode` .
`avoid_indoor`	`bool` When set to true, avoids navigating indoors where reasonable, giving preference to routes not containing indoor navigation. Applies only to the `WALK` `RouteTravelMode` .
`vehicle_info`	`VehicleInfo` Specifies the vehicle information.
`toll_passes[]`	`TollPass` Encapsulates information about toll passes. If toll passes are provided, the API tries to return the pass price. If toll passes are not provided, the API treats the toll pass as unknown and tries to return the cash price. Applies only to the `DRIVE` and `TWO_WHEELER` `RouteTravelMode` .

RouteTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions.

Fields
`toll_info`	`TollInfo` Contains information about tolls on the route. This field is only populated if tolls are expected on the route. If this field is set, but the estimatedPrice subfield is not populated, then the route contains tolls, but the estimated price is unknown. If this field is not set, then there are no tolls expected on the route.
`speed_reading_intervals[]`	`SpeedReadingInterval` Speed reading intervals detailing traffic density. Applicable in case of `TRAFFIC_AWARE` and `TRAFFIC_AWARE_OPTIMAL` routing preferences. The intervals cover the entire polyline of the route without overlap. The start point of a specified interval is the same as the end point of the preceding interval. Example: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`
`fuel_consumption_microliters`	`int64` The predicted fuel consumption in microliters.
`route_restrictions_partially_ignored`	`bool` Returned route may have restrictions that are not suitable for requested travel mode or route modifiers.
`transit_fare`	`Money` If present, contains the total fare or ticket costs on this route This property is only returned for `TRANSIT` requests and only for routes where fare information is available for all transit steps.

RouteTravelMode

A set of values used to specify the mode of travel. NOTE: WALK , BICYCLE , and TWO_WHEELER routes are in beta and might sometimes be missing clear sidewalks, pedestrian paths, or bicycling paths. You must display this warning to the user for all walking, bicycling, and two-wheel routes that you display in your app.

Enums
`TRAVEL_MODE_UNSPECIFIED`	No travel mode specified. Defaults to `DRIVE` .
`DRIVE`	Travel by passenger car.
`BICYCLE`	Travel by bicycle.
`WALK`	Travel by walking.
`TWO_WHEELER`	Two-wheeled, motorized vehicle. For example, motorcycle. Note that this differs from the `BICYCLE` travel mode which covers human-powered mode.
`TRANSIT`	Travel by public transit routes, where available.

RoutingPreference

A set of values that specify factors to take into consideration when calculating the route.

Enums
`ROUTING_PREFERENCE_UNSPECIFIED`	No routing preference specified. Default to `TRAFFIC_UNAWARE` .
`TRAFFIC_UNAWARE`	Computes routes without taking live traffic conditions into consideration. Suitable when traffic conditions don't matter or are not applicable. Using this value produces the lowest latency. Note: For `RouteTravelMode` `DRIVE` and `TWO_WHEELER` choice of route and duration are based on road network and average time-independent traffic conditions. Results for a given request may vary over time due to changes in the road network, updated average traffic conditions, and the distributed nature of the service. Results may also vary between nearly-equivalent routes at any time or frequency.
`TRAFFIC_AWARE`	Calculates routes taking live traffic conditions into consideration. In contrast to `TRAFFIC_AWARE_OPTIMAL` , some optimizations are applied to significantly reduce latency.
`TRAFFIC_AWARE_OPTIMAL`	Calculates the routes taking live traffic conditions into consideration, without applying most performance optimizations. Using this value produces the highest latency.

SpeedReadingInterval

Traffic density indicator on a contiguous segment of a polyline or path. Given a path with points P_0, P_1, ... , P_N (zero-based index), the SpeedReadingInterval defines an interval and describes its traffic using the following categories.

Fields
`start_polyline_point_index`	`int32` The starting index of this interval in the polyline.
`end_polyline_point_index`	`int32` The ending index of this interval in the polyline.
Union field `speed_type` . `speed_type` can be only one of the following:
`speed`	`Speed` Traffic speed in this interval.

Speed

The classification of polyline speed based on traffic data.

Enums
`SPEED_UNSPECIFIED`	Default value. This value is unused.
`NORMAL`	Normal speed, no slowdown is detected.
`SLOW`	Slowdown detected, but no traffic jam formed.
`TRAFFIC_JAM`	Traffic jam detected.

TollInfo

Encapsulates toll information on a Route or on a RouteLeg .

Fields

Fields
`estimated_price[]`	`Money` The monetary amount of tolls for the corresponding `Route` or `RouteLeg` . This list contains a money amount for each currency that is expected to be charged by the toll stations. Typically this list will contain only one item for routes with tolls in one currency. For international trips, this list may contain multiple items to reflect tolls in different currencies.

estimated_price[]

Money

The monetary amount of tolls for the corresponding Route or RouteLeg . This list contains a money amount for each currency that is expected to be charged by the toll stations. Typically this list will contain only one item for routes with tolls in one currency. For international trips, this list may contain multiple items to reflect tolls in different currencies.

TollPass

List of toll passes around the world that we support.

Enums
`TOLL_PASS_UNSPECIFIED`	Not used. If this value is used, then the request fails.
`AU_ETOLL_TAG`	Sydney toll pass. See additional details at https://www.myetoll.com.au .
`AU_EWAY_TAG`	Sydney toll pass. See additional details at https://www.tollpay.com.au .
`AU_LINKT`	Australia-wide toll pass. See additional details at https://www.linkt.com.au/ .
`AR_TELEPASE`	Argentina toll pass. See additional details at https://telepase.com.ar
`BR_AUTO_EXPRESO`	Brazil toll pass. See additional details at https://www.autoexpreso.com
`BR_CONECTCAR`	Brazil toll pass. See additional details at https://conectcar.com .
`BR_MOVE_MAIS`	Brazil toll pass. See additional details at https://movemais.com .
`BR_PASSA_RAPIDO`	Brazil toll pass. See additional details at https://pasorapido.gob.do/
`BR_SEM_PARAR`	Brazil toll pass. See additional details at https://www.semparar.com.br .
`BR_TAGGY`	Brazil toll pass. See additional details at https://taggy.com.br .
`BR_VELOE`	Brazil toll pass. See additional details at https://veloe.com.br/site/onde-usar .
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	Canada to United States border crossing.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	Canada to United States border crossing.
`CA_US_BLUE_WATER_EDGE_PASS`	Ontario, Canada to Michigan, United States border crossing.
`CA_US_CONNEXION`	Ontario, Canada to Michigan, United States border crossing.
`CA_US_NEXUS_CARD`	Canada to United States border crossing.
`ID_E_TOLL`	Indonesia. E-card provided by multiple banks used to pay for tolls. All e-cards via banks are charged the same so only one enum value is needed. Eg - Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
`IN_FASTAG`	India.
`IN_LOCAL_HP_PLATE_EXEMPT`	India, HP state plate exemption.
`MX_IAVE`	Mexico toll pass. https://iave.capufe.gob.mx/#/
`MX_PASE`	Mexico https://www.pase.com.mx
`MX_QUICKPASS`	Mexico https://operadoravial.com/quick-pass/
`MX_SISTEMA_TELEPEAJE_CHIHUAHUA`	http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
`MX_TAG_IAVE`	Mexico
`MX_TAG_TELEVIA`	Mexico toll pass company. One of many operating in Mexico City. See additional details at https://www.televia.com.mx .
`MX_TELEVIA`	Mexico toll pass company. One of many operating in Mexico City. https://www.televia.com.mx
`MX_VIAPASS`	Mexico toll pass. See additional details at https://www.viapass.com.mx/viapass/web_home.aspx .
`US_AL_FREEDOM_PASS`	AL, USA.
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	AK, USA.
`US_CA_FASTRAK`	CA, USA.
`US_CA_FASTRAK_CAV_STICKER`	Indicates driver has any FasTrak pass in addition to the DMV issued Clean Air Vehicle (CAV) sticker. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO, USA.
`US_CO_GO_PASS`	CO, USA.
`US_DE_EZPASSDE`	DE, USA.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	FL, USA.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	FL, USA.
`US_FL_EPASS`	FL, USA.
`US_FL_GIBA_TOLL_PASS`	FL, USA.
`US_FL_LEEWAY`	FL, USA.
`US_FL_SUNPASS`	FL, USA.
`US_FL_SUNPASS_PRO`	FL, USA.
`US_IL_EZPASSIL`	IL, USA.
`US_IL_IPASS`	IL, USA.
`US_IN_EZPASSIN`	IN, USA.
`US_KS_BESTPASS_HORIZON`	KS, USA.
`US_KS_KTAG`	KS, USA.
`US_KS_NATIONALPASS`	KS, USA.
`US_KS_PREPASS_ELITEPASS`	KS, USA.
`US_KY_RIVERLINK`	KY, USA.
`US_LA_GEAUXPASS`	LA, USA.
`US_LA_TOLL_TAG`	LA, USA.
`US_MA_EZPASSMA`	MA, USA.
`US_MD_EZPASSMD`	MD, USA.
`US_ME_EZPASSME`	ME, USA.
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	MI, USA.
`US_MI_BCPASS`	MI, USA.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	MI, USA.
`US_MI_IQ_PROX_CARD`	MI, USA. Deprecated as this pass type no longer exists. This item is deprecated!
`US_MI_IQ_TAG`	MI, USA.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	MI, USA.
`US_MI_NEXPRESS_TOLL`	MI, USA.
`US_MN_EZPASSMN`	MN, USA.
`US_NC_EZPASSNC`	NC, USA.
`US_NC_PEACH_PASS`	NC, USA.
`US_NC_QUICK_PASS`	NC, USA.
`US_NH_EZPASSNH`	NH, USA.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	NJ, USA.
`US_NJ_EZPASSNJ`	NJ, USA.
`US_NY_EXPRESSPASS`	NY, USA.
`US_NY_EZPASSNY`	NY, USA.
`US_OH_EZPASSOH`	OH, USA.
`US_PA_EZPASSPA`	PA, USA.
`US_RI_EZPASSRI`	RI, USA.
`US_SC_PALPASS`	SC, USA.
`US_TX_AVI_TAG`	TX, USA.
`US_TX_BANCPASS`	TX, USA.
`US_TX_DEL_RIO_PASS`	TX, USA.
`US_TX_EFAST_PASS`	TX, USA.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	TX, USA.
`US_TX_EPTOLL`	TX, USA.
`US_TX_EZ_CROSS`	TX, USA.
`US_TX_EZTAG`	TX, USA.
`US_TX_FUEGO_TAG`	TX, USA.
`US_TX_LAREDO_TRADE_TAG`	TX, USA.
`US_TX_PLUSPASS`	TX, USA.
`US_TX_TOLLTAG`	TX, USA.
`US_TX_TXTAG`	TX, USA.
`US_TX_XPRESS_CARD`	TX, USA.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	UT, USA.
`US_VA_EZPASSVA`	VA, USA.
`US_WA_BREEZEBY`	WA, USA.
`US_WA_GOOD_TO_GO`	WA, USA.
`US_WV_EZPASSWV`	WV, USA.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV, USA.
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV, USA.

TrafficModel

Specifies the assumptions to use when calculating time in traffic. This setting affects the value returned in the duration field in the response, which contains the predicted time in traffic based on historical averages.

Enums
`TRAFFIC_MODEL_UNSPECIFIED`	Unused. If specified, will default to `BEST_GUESS` .
`BEST_GUESS`	Indicates that the returned `duration` should be the best estimate of travel time given what is known about both historical traffic conditions and live traffic. Live traffic becomes more important the closer the `departure_time` is to now.
`PESSIMISTIC`	Indicates that the returned duration should be longer than the actual travel time on most days, though occasional days with particularly bad traffic conditions may exceed this value.
`OPTIMISTIC`	Indicates that the returned duration should be shorter than the actual travel time on most days, though occasional days with particularly good traffic conditions may be faster than this value.

TransitAgency

A transit agency that operates a transit line.

Fields

Fields
`name`	`string` The name of this transit agency.
`phone_number`	`string` The transit agency's locale-specific formatted phone number.
`uri`	`string` The transit agency's URI.

name

string

The name of this transit agency.

phone_number

string

The transit agency's locale-specific formatted phone number.

uri

string

The transit agency's URI.

TransitLine

Contains information about the transit line used in this step.

Fields
`agencies[]`	`TransitAgency` The transit agency (or agencies) that operates this transit line.
`name`	`string` The full name of this transit line, For example, "8 Avenue Local".
`uri`	`string` the URI for this transit line as provided by the transit agency.
`color`	`string` The color commonly used in signage for this line. Represented in hexadecimal.
`icon_uri`	`string` The URI for the icon associated with this line.
`name_short`	`string` The short name of this transit line. This name will normally be a line number, such as "M7" or "355".
`text_color`	`string` The color commonly used in text on signage for this line. Represented in hexadecimal.
`vehicle`	`TransitVehicle` The type of vehicle that operates on this transit line.

TransitPreferences

Preferences for TRANSIT based routes that influence the route that is returned.

Fields

allowed_travel_modes[]

TransitTravelMode

A set of travel modes to use when getting a TRANSIT route. Defaults to all supported modes of travel.

routing_preference

TransitRoutingPreference

A routing preference that, when specified, influences the TRANSIT route returned.

TransitRoutingPreference

Specifies routing preferences for transit routes.

Enums
`TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED`	No preference specified.
`LESS_WALKING`	Indicates that the calculated route should prefer limited amounts of walking.
`FEWER_TRANSFERS`	Indicates that the calculated route should prefer a limited number of transfers.

TransitTravelMode

A set of values used to specify the mode of transit.

Enums
`TRANSIT_TRAVEL_MODE_UNSPECIFIED`	No transit travel mode specified.
`BUS`	Travel by bus.
`SUBWAY`	Travel by subway.
`TRAIN`	Travel by train.
`LIGHT_RAIL`	Travel by light rail or tram.
`RAIL`	Travel by rail. This is equivalent to a combination of `SUBWAY` , `TRAIN` , and `LIGHT_RAIL` .

TransitStop

Information about a transit stop.

Fields

name

string

The name of the transit stop.

location

Location

The location of the stop expressed in latitude/longitude coordinates.

TransitVehicle

Information about a vehicle used in transit routes.

Fields
`name`	`LocalizedText` The name of this vehicle, capitalized.
`type`	`TransitVehicleType` The type of vehicle used.
`icon_uri`	`string` The URI for an icon associated with this vehicle type.
`local_icon_uri`	`string` The URI for the icon associated with this vehicle type, based on the local transport signage.

TransitVehicleType

The type of vehicles for transit routes.

Enums
`TRANSIT_VEHICLE_TYPE_UNSPECIFIED`	Unused.
`BUS`	Bus.
`CABLE_CAR`	A vehicle that operates on a cable, usually on the ground. Aerial cable cars may be of the type `GONDOLA_LIFT` .
`COMMUTER_TRAIN`	Commuter rail.
`FERRY`	Ferry.
`FUNICULAR`	A vehicle that is pulled up a steep incline by a cable. A Funicular typically consists of two cars, with each car acting as a counterweight for the other.
`GONDOLA_LIFT`	An aerial cable car.
`HEAVY_RAIL`	Heavy rail.
`HIGH_SPEED_TRAIN`	High speed train.
`INTERCITY_BUS`	Intercity bus.
`LONG_DISTANCE_TRAIN`	Long distance train.
`METRO_RAIL`	Light rail transit.
`MONORAIL`	Monorail.
`OTHER`	All other vehicles.
`RAIL`	Rail.
`SHARE_TAXI`	Share taxi is a kind of bus with the ability to drop off and pick up passengers anywhere on its route.
`SUBWAY`	Underground light rail.
`TRAM`	Above ground light rail.
`TROLLEYBUS`	Trolleybus.

Units

A set of values that specify the unit of measure used in the display.

Enums
`UNITS_UNSPECIFIED`	Units of measure not specified. Defaults to the unit of measure inferred from the request.
`METRIC`	Metric units of measure.
`IMPERIAL`	Imperial (English) units of measure.

VehicleEmissionType

A set of values describing the vehicle's emission type. Applies only to the DRIVE RouteTravelMode .

Enums
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	No emission type specified. Default to `GASOLINE` .
`GASOLINE`	Gasoline/petrol fueled vehicle.
`ELECTRIC`	Electricity powered vehicle.
`HYBRID`	Hybrid fuel (such as gasoline + electric) vehicle.
`DIESEL`	Diesel fueled vehicle.

VehicleInfo

Contains the vehicle information, such as the vehicle emission type.

Fields

emission_type

VehicleEmissionType

Describes the vehicle's emission type. Applies only to the DRIVE RouteTravelMode .

Waypoint

Encapsulates a waypoint. Waypoints mark both the beginning and end of a route, and include intermediate stops along the route.

Fields
`via`	`bool` Marks this waypoint as a milestone rather a stopping point. For each non-via waypoint in the request, the response appends an entry to the `legs` array to provide the details for stopovers on that leg of the trip. Set this value to true when you want the route to pass through this waypoint without stopping over. Via waypoints don't cause an entry to be added to the `legs` array, but they do route the journey through the waypoint. You can only set this value on waypoints that are intermediates. The request fails if you set this field on terminal waypoints. If `ComputeRoutesRequest.optimize_waypoint_order` is set to true then this field cannot be set to true; otherwise, the request fails.
`vehicle_stopover`	`bool` Indicates that the waypoint is meant for vehicles to stop at, where the intention is to either pickup or drop-off. When you set this value, the calculated route won't include non- `via` waypoints on roads that are unsuitable for pickup and drop-off. This option works only for `DRIVE` and `TWO_WHEELER` travel modes, and when the `location_type` is `Location` .
`side_of_road`	`bool` Indicates that the location of this waypoint is meant to have a preference for the vehicle to stop at a particular side of road. When you set this value, the route will pass through the location so that the vehicle can stop at the side of road that the location is biased towards from the center of the road. This option works only for 'DRIVE' and 'TWO_WHEELER' `RouteTravelMode` .
Union field `location_type` . Different ways to represent a location. `location_type` can be only one of the following:
`location`	`Location` A point specified using geographic coordinates, including an optional heading.
`place_id`	`string` The POI Place ID associated with the waypoint.
`address`	`string` Human readable address or a plus code. See https://plus.codes for details.