Эта страница переведена с помощью 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 маршрутов.

ВычислитьМаршрутМатрица

ВычислитьМаршрутМатрица
`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 не рекомендует использовать маску поля ответа с подстановочным знаком ( * ), потому что:

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

Вычислительные маршруты

Вычислительные маршруты
`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 )

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

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

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

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

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

ВычислениеМаршрутМатриксЗапрос

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

Поля
`origins[]`	`RouteMatrixOrigin` Необходимый. Массив источников, определяющий строки матрицы ответа. К числу элементов отправления и назначения применяются несколько ограничений по размеру: Сумма количества отправителей + количества пунктов назначения, указанных в качестве `place_id` или `address` не должна превышать 50. В любом случае произведение количества отправлений × количество пунктов назначения не должно превышать 625. Произведение количества отправителей × количество пунктов назначения не должно превышать 100, если для параметра router_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». Дополнительные сведения см. в разделе Идентификатор локали Unicode . Список поддерживаемых языков см. в разделе « Поддержка языков». Если вы не укажете это значение, язык отображения будет определяться на основе местоположения первого источника.
`region_code`	`string` Необязательный. Код региона в виде двухсимвольного значения ccTLD («домен верхнего уровня»). Дополнительную информацию см. в разделе Домены верхнего уровня с кодом страны .
`units`	`Units` Необязательный. Указывает единицы измерения для полей отображения.
`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`	Информация о дорожных сборах для элемента(ов) матрицы.

ВычислитьМаршрутыЗапрос

Сообщение запроса 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` . Транзитные поездки доступны на срок до 7 дней в прошлом или на 100 дней в будущем.
`arrival_time`	`Timestamp` Необязательный. Время прибытия. ПРИМЕЧАНИЕ. Можно установить только в том случае, если для `RouteTravelMode` установлено значение `TRANSIT` . Вы можете указать `departure_time` или `arrival_time` , но не оба одновременно. Транзитные поездки доступны на срок до 7 дней в прошлом или на 100 дней в будущем.
`compute_alternative_routes`	`bool` Необязательный. Указывает, следует ли рассчитывать альтернативные маршруты в дополнение к маршруту. Альтернативные маршруты не возвращаются для запросов, имеющих промежуточные точки.
`route_modifiers`	`RouteModifiers` Необязательный. Набор условий, которые необходимо выполнить, влияющие на способ расчета маршрутов.
`language_code`	`string` Необязательный. Код языка BCP-47, например «en-US» или «sr-Latn». Дополнительные сведения см. в разделе Идентификатор локали Unicode . Список поддерживаемых языков см. в разделе « Поддержка языков». Если вы не укажете это значение, язык отображения будет определяться на основе местоположения запроса маршрута.
`region_code`	`string` Необязательный. Код региона в виде двухсимвольного значения ccTLD («домен верхнего уровня»). Дополнительную информацию см. в разделе Домены верхнего уровня с кодом страны .
`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`	`NavigationInstructions` представлены в виде текстовой строки в формате HTML. Этот контент предназначен для чтения «как есть». Этот контент предназначен только для отображения. Не анализируйте его программно.

Справочный маршрут

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

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

ComputeRoutesResponse

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

Поля

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

routes[]

Route

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

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

FallbackInfo

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

Поля

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

routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

FallbackПричина

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

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

Режим резервной маршрутизации

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

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

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

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

Поля
`geocoder_status`	`Status` Указывает код состояния, полученный в результате операции геокодирования.
`type[]`	`string` Тип(ы) результата в виде нуля или более тегов типа. Поддерживаемые типы: типы адресов и типы компонентов адреса .
`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.

ПолилинияКачество

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

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

Маршрут

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

Поля
`route_labels[]`	`RouteLabel` Метки `Route` , которые полезны для определения конкретных свойств маршрута для сравнения с другими.
`legs[]`	`RouteLeg` Набор участков (сегментов пути между путевыми точками), составляющих маршрут. Каждый этап соответствует поездке между двумя `Waypoints` не являющимися `via` . Например, маршрут без промежуточных точек имеет только один участок. Маршрут, включающий одну промежуточную точку, не являющуюся `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, который можно передать в Navigation SDK. Он позволяет Navigation SDK реконструировать маршрут во время навигации и в случае изменения маршрута соблюдать исходное намерение при создании маршрута путем вызова ВычислитьМаршруты. Клиенты должны рассматривать этот токен как непрозрачный объект. Не сравнивайте его значение в разных запросах — этот токен может измениться, даже если был возвращен тот же самый маршрут. ПРИМЕЧАНИЕ. `Route.route_token` доступен только для запросов, в которых для `ComputeRoutesRequest.routing_preference` установлено значение `TRAFFIC_AWARE` или `TRAFFIC_AWARE_OPTIMAL` . `Route.route_token` не поддерживается для запросов, содержащих путевые точки Via.

МаршрутLocalizedValues

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

Поля
`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` . Это поле заполняется только для ТРАНЗИТНЫХ маршрутов.

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

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

Поля

distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

ШагиОбзор

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

Поля

Поля
`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` , который является концом мультимодального сегмента.

МаршрутНогаШаг

Содержит сегмент 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` Режим движения, используемый для этого шага.

МаршрутЛегШтепLocalizedValues

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

Поля

distance

LocalizedText

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

static_duration

LocalizedText

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

МаршрутНогаШагТранзитПодробнее

Дополнительная информация для 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` Ориентировочное время выхода на шаг.

МаршрутНогаШагПутешествиеКонсультационный совет

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

Поля

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

speed_reading_intervals[]

SpeedReadingInterval

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

МаршрутНогаПутешествиеРекомендации

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

Поля

Поля
`toll_info`	`TollInfo` Содержит информацию о дорожных сборах на конкретном `RouteLeg` . Это поле заполняется только в том случае, если мы ожидаем, что на `RouteLeg` есть платные дороги. Если это поле установлено, но подполе Assessment_price не заполнено, мы ожидаем, что дорога содержит плату за проезд, но мы не знаем ориентировочную цену. Если это поле не существует, плата за проезд на `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 есть платные дороги. Если это поле установлено, но подполе Assessment_price не заполнено, мы ожидаем, что дорога содержит плату за проезд, но мы не знаем ориентировочную цену. Если это поле не существует, плата за проезд на 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).

МаршрутМатрицаНазначение

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

Поля

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

waypoint

Waypoint

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

МаршрутМатрицаЭлемент

Содержит информацию о маршруте, вычисленную для пары отправитель/назначение в 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` Транзитный тариф представлен в текстовом виде.

МаршрутМатрицаЭлементУсловие

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

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

МаршрутМатрицаПроисхождение

Один источник для ComputeRouteMatrixRequest.

Поля

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

waypoint

Waypoint

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

route_modifiers

RouteModifiers

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

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

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

Поля
`avoid_tolls`	`bool` Если установлено значение true, платные дороги избегаются там, где это возможно, отдавая предпочтение маршрутам, не содержащим платных дорог. Применяется только к `DRIVE` и `TWO_WHEELER` `RouteTravelMode` .
`avoid_highways`	`bool` Если установлено значение true, избегает шоссе, где это возможно, отдавая предпочтение маршрутам, не содержащим шоссе. Применяется только к `DRIVE` и `TWO_WHEELER` `RouteTravelMode` .
`avoid_ferries`	`bool` Если установлено значение true, паромы избегаются, где это возможно, отдавая предпочтение маршрутам, не содержащим паромов. Применяется только к `DRIVE` и `TWO_WHEELER` `RouteTravelMode` .
`avoid_indoor`	`bool` Если установлено значение true, навигация в помещении избегается, где это возможно, отдавая предпочтение маршрутам, не содержащим навигацию в помещении. Применяется только к `WALK` `RouteTravelMode` .
`vehicle_info`	`VehicleInfo` Указывает информацию об автомобиле.
`toll_passes[]`	`TollPass` Инкапсулирует информацию о платных проездных. Если предоставляются проездные, API пытается вернуть стоимость проезда. Если проездные билеты не предоставлены, API рассматривает проездной билет как неизвестный и пытается вернуть цену наличными. Применяется только к `DRIVE` и `TWO_WHEELER` `RouteTravelMode` .

МаршрутПутешествияКонсультационные услуги

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

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

МаршрутПутешествияРежим

Набор значений, используемых для указания режима передвижения. ПРИМЕЧАНИЕ. Маршруты WALK , BICYCLE и TWO_WHEELER находятся в стадии бета-тестирования, и иногда на них могут отсутствовать чистые тротуары, пешеходные или велосипедные дорожки. Вы должны отображать это предупреждение пользователю для всех пешеходных, велосипедных и двухколесных маршрутов, отображаемых в вашем приложении.

Перечисления
`TRAVEL_MODE_UNSPECIFIED`	Не указан режим движения. По умолчанию `DRIVE` .
`DRIVE`	Путешествие на легковом автомобиле.
`BICYCLE`	Путешествие на велосипеде.
`WALK`	Путешествуйте пешком.
`TWO_WHEELER`	Двухколесное моторизованное транспортное средство. Например, мотоцикл. Обратите внимание, что это отличается от режима движения `BICYCLE` , который охватывает режим с участием человека.
`TRANSIT`	Передвигайтесь по маршрутам общественного транспорта, если таковые имеются.

Предпочтение маршрутизации

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

Перечисления
`ROUTING_PREFERENCE_UNSPECIFIED`	Не указаны предпочтения маршрутизации. По умолчанию `TRAFFIC_UNAWARE` .
`TRAFFIC_UNAWARE`	Рассчитывает маршруты без учета условий движения в реальном времени. Подходит, когда условия дорожного движения не имеют значения или неприменимы. Использование этого значения обеспечивает минимальную задержку. Примечание. Для `RouteTravelMode` `DRIVE` и `TWO_WHEELER` выбранный маршрут и продолжительность основаны на дорожной сети и средних условиях дорожного движения, не зависящих от времени, а не на текущих дорожных условиях. Следовательно, маршруты могут включать дороги, которые временно закрыты. Результаты для данного запроса могут меняться со временем из-за изменений в дорожной сети, обновленных средних условий дорожного движения и распределенного характера услуги. Результаты также могут различаться между почти эквивалентными маршрутами в любое время и с любой частотой.
`TRAFFIC_AWARE`	Рассчитывает маршруты с учетом условий движения в реальном времени. В отличие от `TRAFFIC_AWARE_OPTIMAL` , применяются некоторые оптимизации, позволяющие значительно сократить задержку.
`TRAFFIC_AWARE_OPTIMAL`	Рассчитывает маршруты с учетом условий движения в реальном времени, без применения большинства оптимизаций производительности. Использование этого значения приводит к самой высокой задержке.

СкоростьЧтенияИнтервал

Индикатор плотности трафика на непрерывном участке ломаной линии или пути. Учитывая путь с точками P_0, P_1,..., P_N (индекс, начинающийся с нуля), SpeedReadingInterval определяет интервал и описывает его трафик, используя следующие категории.

Поля
`start_polyline_point_index`	`int32` Начальный индекс этого интервала в полилинии.
`end_polyline_point_index`	`int32` Конечный индекс этого интервала в полилинии.
Поле объединения `speed_type` . `speed_type` может быть только одним из следующих:
`speed`	`Speed` Скорость движения в этом интервале.

Скорость

Классификация скорости полилинии на основе данных о трафике.

Перечисления
`SPEED_UNSPECIFIED`	Значение по умолчанию. Это значение не используется.
`NORMAL`	Скорость нормальная, замедлений не обнаружено.
`SLOW`	Замедление зафиксировано, но пробки не образовалось.
`TRAFFIC_JAM`	Обнаружена пробка.

Платная информация

Инкапсулирует информацию о платных дорогах в Route или RouteLeg .

Поля

Поля
`estimated_price[]`	`Money` Денежная сумма дорожных сборов для соответствующего `Route` или `RouteLeg` . Этот список содержит денежную сумму для каждой валюты, которая, как ожидается, будет взиматься на станциях взимания платы за проезд. Обычно этот список содержит только один элемент для маршрутов, стоимость проезда в которых указана в одной валюте. Для международных поездок этот список может содержать несколько пунктов, отражающих стоимость проезда в разных валютах.

estimated_price[]

Money

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

TollPass

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

Перечисления
`TOLL_PASS_UNSPECIFIED`	Не используется. Если это значение используется, запрос завершается неудачно.
`AU_ETOLL_TAG`	Платный перевал в Сиднее. Дополнительную информацию см. на https://www.myetoll.com.au .
`AU_EWAY_TAG`	Платный перевал в Сиднее. Дополнительную информацию см. на https://www.tollpay.com.au .
`AU_LINKT`	Платный проезд по всей Австралии. Дополнительную информацию см. на https://www.linkt.com.au/ .
`AR_TELEPASE`	Платный перевал в Аргентине. Дополнительную информацию см. на https://telease.com.ar.
`BR_AUTO_EXPRESO`	Платный перевал в Бразилии. Дополнительную информацию см. на https://www.autoexpreso.com.
`BR_CONECTCAR`	Платный перевал в Бразилии. Дополнительную информацию см. на https://conectcar.com .
`BR_MOVE_MAIS`	Платный перевал в Бразилии. Дополнительную информацию см. на https://movemais.com .
`BR_PASSA_RAPIDO`	Платный перевал в Бразилии. Дополнительную информацию см. на https://pasorapido.gob.do/.
`BR_SEM_PARAR`	Платный перевал в Бразилии. Дополнительную информацию см. на https://www.semparar.com.br .
`BR_TAGGY`	Платный перевал в Бразилии. Дополнительную информацию см. на https://taggy.com.br .
`BR_VELOE`	Платный перевал в Бразилии. Дополнительную информацию см. на https://veloe.com.br/site/onde-usar .
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	Пограничный переход между Канадой и США.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	Пограничный переход между Канадой и США.
`CA_US_BLUE_WATER_EDGE_PASS`	Пограничный переход Онтарио, Канада, Мичиган, США.
`CA_US_CONNEXION`	Пограничный переход Онтарио, Канада, Мичиган, США.
`CA_US_NEXUS_CARD`	Пограничный переход между Канадой и США.
`ID_E_TOLL`	Индонезия. Электронная карта, предоставленная несколькими банками, используемая для оплаты дорожных сборов. Все электронные карты через банки взимаются одинаково, поэтому требуется только одно перечисляемое значение. Например – Банк Мандири https://www.bankmandiri.co.id/e-money – BCA https://www.bca.co.id/flazz – BNI https://www.bni.co.id/id- идентификатор/ebanking/tapcash
`IN_FASTAG`	Индия.
`IN_LOCAL_HP_PLATE_EXEMPT`	Индия, освобождение от уплаты государственных знаков HP.
`JP_ETC`	Япония и т. д. Электронная беспроводная система для взимания платы за проезд. https://www.go-etc.jp/
`JP_ETC2`	Япония ETC2.0. Новая версия ETC с дополнительной скидкой и двунаправленной связью между устройствами на транспортных средствах и антеннами на дороге. https://www.go-etc.jp/etc2/index.html
`MX_IAVE`	Платный перевал в Мексике. https://iave.capufe.gob.mx/#/
`MX_PASE`	Мексика https://www.pase.com.mx
`MX_QUICKPASS`	Мексика https://operadoravial.com/quick-pass/
`MX_SISTEMA_TELEPEAJE_CHIHUAHUA`	http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
`MX_TAG_IAVE`	Мексика
`MX_TAG_TELEVIA`	Компания по взиманию платы за проезд в Мексике. Один из многих, работающих в Мехико. Дополнительную информацию см. на https://www.televia.com.mx .
`MX_TELEVIA`	Компания по взиманию платы за проезд в Мексике. Один из многих, работающих в Мехико. https://www.televia.com.mx
`MX_VIAPASS`	Платный перевал в Мексике. Дополнительную информацию см. на странице https://www.viapass.com.mx/viapass/web_home.aspx .
`US_AL_FREEDOM_PASS`	АЛ, США.
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	АК, США.
`US_CA_FASTRAK`	Калифорния, США.
`US_CA_FASTRAK_CAV_STICKER`	Указывает, что у водителя есть пропуск FasTrak в дополнение к наклейке транспортного средства с чистым воздухом (CAV), выданной DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	Колорадо, США.
`US_CO_GO_PASS`	Колорадо, США.
`US_DE_EZPASSDE`	ДЭ, США.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	Флорида, США.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	Флорида, США.
`US_FL_EPASS`	Флорида, США.
`US_FL_GIBA_TOLL_PASS`	Флорида, США.
`US_FL_LEEWAY`	Флорида, США.
`US_FL_SUNPASS`	Флорида, США.
`US_FL_SUNPASS_PRO`	Флорида, США.
`US_IL_EZPASSIL`	Иллинойс, США.
`US_IL_IPASS`	Иллинойс, США.
`US_IN_EZPASSIN`	ИН, США.
`US_KS_BESTPASS_HORIZON`	КС, США.
`US_KS_KTAG`	КС, США.
`US_KS_NATIONALPASS`	КС, США.
`US_KS_PREPASS_ELITEPASS`	КС, США.
`US_KY_RIVERLINK`	Кентукки, США.
`US_LA_GEAUXPASS`	Лос-Анджелес, США.
`US_LA_TOLL_TAG`	Лос-Анджелес, США.
`US_MA_EZPASSMA`	Массачусетс, США.
`US_MD_EZPASSMD`	Доктор медицины, США.
`US_ME_EZPASSME`	Я, США.
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	Мичиган, США.
`US_MI_BCPASS`	Мичиган, США.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	Мичиган, США.
`US_MI_IQ_PROX_CARD`	Мичиган, США. Устарело, поскольку этот тип пропуска больше не существует. Этот товар устарел!
`US_MI_IQ_TAG`	Мичиган, США.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	Мичиган, США.
`US_MI_NEXPRESS_TOLL`	Мичиган, США.
`US_MN_EZPASSMN`	Миннесота, США.
`US_NC_EZPASSNC`	Северная Каролина, США.
`US_NC_PEACH_PASS`	Северная Каролина, США.
`US_NC_QUICK_PASS`	Северная Каролина, США.
`US_NH_EZPASSNH`	Нью-Хэмпшир, США.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	Нью-Джерси, США.
`US_NJ_EZPASSNJ`	Нью-Джерси, США.
`US_NY_EXPRESSPASS`	Нью-Йорк, США.
`US_NY_EZPASSNY`	Нью-Йорк, США.
`US_OH_EZPASSOH`	О, США.
`US_PA_EZPASSPA`	Пенсильвания, США.
`US_RI_EZPASSRI`	Р.И., США.
`US_SC_PALPASS`	СК, США.
`US_TX_AVI_TAG`	Техас, США.
`US_TX_BANCPASS`	Техас, США.
`US_TX_DEL_RIO_PASS`	Техас, США.
`US_TX_EFAST_PASS`	Техас, США.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	Техас, США.
`US_TX_EPTOLL`	Техас, США.
`US_TX_EZ_CROSS`	Техас, США.
`US_TX_EZTAG`	Техас, США.
`US_TX_FUEGO_TAG`	Техас, США.
`US_TX_LAREDO_TRADE_TAG`	Техас, США.
`US_TX_PLUSPASS`	Техас, США.
`US_TX_TOLLTAG`	Техас, США.
`US_TX_TXTAG`	Техас, США.
`US_TX_XPRESS_CARD`	Техас, США.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	ЮТ, США.
`US_VA_EZPASSVA`	Вирджиния, США.
`US_WA_BREEZEBY`	Вашингтон, США.
`US_WA_GOOD_TO_GO`	Вашингтон, США.
`US_WV_EZPASSWV`	Западная Вирджиния, США.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	Западная Вирджиния, США.
`US_WV_MOV_PASS`	Западная Вирджиния, США
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	Западная Вирджиния, США.

Модель трафика

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

Перечисления
`TRAFFIC_MODEL_UNSPECIFIED`	Неиспользованный. Если указано, по умолчанию будет `BEST_GUESS` .
`BEST_GUESS`	Указывает, что возвращаемая `duration` должна быть наилучшей оценкой времени в пути с учетом того, что известно как об исторических условиях дорожного движения, так и о реальном трафике. Трафик в реальном времени становится тем более важным, чем ближе к настоящему `departure_time` .
`PESSIMISTIC`	Указывает, что возвращаемая продолжительность должна быть больше фактического времени в пути в большинстве дней, хотя в отдельные дни с особенно плохими дорожными условиями может превышать это значение.
`OPTIMISTIC`	Указывает, что возвращаемая продолжительность должна быть короче фактического времени в пути в большинстве дней, хотя в отдельные дни с особенно хорошими дорожными условиями может быть быстрее, чем это значение.

Транзитное Агентство

Транзитное агентство, управляющее транзитной линией.

Поля

Поля
`name`	`string` Название этого транзитного агентства.
`phone_number`	`string` Номер телефона транзитного агентства в соответствии с региональным стандартом.
`uri`	`string` URI транзитного агентства.

name

string

Название этого транзитного агентства.

phone_number

string

Номер телефона транзитного агентства в соответствии с региональным стандартом.

uri

string

URI транзитного агентства.

ТранзитЛайн

Содержит информацию о транзитной линии, использованной на этом этапе.

Поля
`agencies[]`	`TransitAgency` Транзитное агентство (или агентства), которое управляет этой транзитной линией.
`name`	`string` Полное название этой транспортной линии, например, «8 Avenue Local».
`uri`	`string` URI для этой транзитной линии, предоставленный транзитным агентством.
`color`	`string` Цвет, обычно используемый в вывесках этой линии. Представлено в шестнадцатеричном формате.
`icon_uri`	`string` URI для значка, связанного с этой строкой.
`name_short`	`string` Краткое название этой транзитной линии. Обычно это имя представляет собой номер строки, например «M7» или «355».
`text_color`	`string` Цвет, обычно используемый в тексте на вывесках этой линии. Представлено в шестнадцатеричном формате.
`vehicle`	`TransitVehicle` Тип транспортного средства, курсирующего по данной транзитной линии.

Транзитные предпочтения

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

Поля

allowed_travel_modes[]

TransitTravelMode

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

routing_preference

TransitRoutingPreference

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

ТранзитМаршрутизацияПредпочтение

Указывает предпочтения маршрутизации для транзитных маршрутов.

Перечисления
`TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED`	Предпочтения не указаны.
`LESS_WALKING`	Указывает, что рассчитанный маршрут должен предусматривать ограниченное количество пеших прогулок.
`FEWER_TRANSFERS`	Указывает, что рассчитанный маршрут должен отдавать предпочтение ограниченному числу пересадок.

ТранзитПутешествияРежим

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

Перечисления
`TRANSIT_TRAVEL_MODE_UNSPECIFIED`	Не указан транзитный режим передвижения.
`BUS`	Путешествие на автобусе.
`SUBWAY`	Путешествие на метро.
`TRAIN`	Путешествие на поезде.
`LIGHT_RAIL`	Путешествуйте на легкорельсовом транспорте или трамвае.
`RAIL`	Путешествие по железной дороге. Это эквивалентно комбинации `SUBWAY` , `TRAIN` и `LIGHT_RAIL` .

ТранзитСтоп

Информация о транзитной остановке.

Поля

name

string

Название транзитной остановки.

location

Location

Местоположение остановки, выраженное в координатах широты и долготы.

Транзитное транспортное средство

Сведения о транспортном средстве, используемом на транзитных маршрутах.

Поля
`name`	`LocalizedText` Название этого автомобиля, с большой буквы.
`type`	`TransitVehicleType` Тип используемого транспортного средства.
`icon_uri`	`string` URI для значка, связанного с этим типом транспортного средства.
`local_icon_uri`	`string` URI для значка, связанного с этим типом транспортного средства, на основе знаков местного транспорта.

Тип транзитного транспортного средства

Тип транспортных средств для транзитных маршрутов.

Перечисления
`TRANSIT_VEHICLE_TYPE_UNSPECIFIED`	Неиспользованный.
`BUS`	Автобус.
`CABLE_CAR`	Транспортное средство, работающее на тросе, обычно на земле. Воздушные канатные дороги могут быть типа `GONDOLA_LIFT` .
`COMMUTER_TRAIN`	Пригородная железная дорога.
`FERRY`	Перевозить.
`FUNICULAR`	Транспортное средство, которое поднимается по крутому склону с помощью троса. Фуникулер обычно состоит из двух вагонов, каждый из которых выступает в качестве противовеса другому.
`GONDOLA_LIFT`	Воздушная канатная дорога.
`HEAVY_RAIL`	Тяжелый рельс.
`HIGH_SPEED_TRAIN`	Высокоскоростной поезд.
`INTERCITY_BUS`	Междугородний автобус.
`LONG_DISTANCE_TRAIN`	Поезд дальнего следования.
`METRO_RAIL`	Легкорельсовый транспорт.
`MONORAIL`	Монорельс.
`OTHER`	Все остальные транспортные средства.
`RAIL`	Железнодорожный.
`SHARE_TAXI`	Маршрутное такси — это разновидность автобуса, способного высаживать и забирать пассажиров в любом месте своего маршрута.
`SUBWAY`	Подземный легкорельсовый транспорт.
`TRAM`	Надземный легкорельсовый транспорт.
`TROLLEYBUS`	Троллейбус.

Единицы

Набор значений, определяющих единицу измерения, используемую при отображении.

Перечисления
`UNITS_UNSPECIFIED`	Единицы измерения не указаны. По умолчанию используется единица измерения, полученная из запроса.
`METRIC`	Метрические единицы измерения.
`IMPERIAL`	Имперские (английские) единицы измерения.

Транспортное средствоТип выбросов

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

Перечисления
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	Тип выброса не указан. По умолчанию `GASOLINE` .
`GASOLINE`	Автомобиль, работающий на бензине/бензине.
`ELECTRIC`	Транспортное средство с электроприводом.
`HYBRID`	Гибридное топливо (например, бензин + электромобиль).
`DIESEL`	Автомобиль, работающий на дизельном топливе.

Информация о транспортном средстве

Содержит информацию о транспортном средстве, например тип выбросов транспортного средства.

Поля

emission_type

VehicleEmissionType

Описывает тип выбросов автомобиля. Применяется только к DRIVE RouteTravelMode .

Путевая точка

Инкапсулирует путевую точку. Путевые точки отмечают начало и конец маршрута и включают промежуточные остановки на маршруте.

Поля
`via`	`bool` Отмечает эту путевую точку как веху, а не как точку остановки. Для каждой путевой точки в запросе, не являющейся транзитным, ответ добавляет запись в массив `legs` , чтобы предоставить подробную информацию об остановках на этом этапе поездки. Установите для этого значения значение true, если вы хотите, чтобы маршрут проходил через эту точку без остановок. Через путевые точки не добавляется запись в массив `legs` , но они маршрутизируют путешествие через путевую точку. Вы можете установить это значение только для промежуточных точек маршрута. Запрос не будет выполнен, если вы установите это поле для путевых точек терминала. Если `ComputeRoutesRequest.optimize_waypoint_order` установлено значение true, то для этого поля нельзя установить значение true; в противном случае запрос не будет выполнен.
`vehicle_stopover`	`bool` Указывает, что путевая точка предназначена для остановки транспортных средств с намерением либо посадить, либо высадить ее. Если вы установите это значение, расчетный маршрут не будет включать `via` точки на дорогах, которые непригодны для посадки и высадки. Эта опция работает только для режимов движения `DRIVE` и `TWO_WHEELER` , а также когда `location_type` равен `Location` .
`side_of_road`	`bool` Указывает, что расположение этой путевой точки предназначено для того, чтобы транспортное средство остановилось на определенной стороне дороги. Если вы установите это значение, маршрут будет проходить через местоположение, так что транспортное средство сможет остановиться на той стороне дороги, к которой местоположение смещено от центра дороги. Эта опция работает только для `DRIVE` и `TWO_WHEELER` `RouteTravelMode` .
Поле объединения `location_type` . Различные способы представления местоположения. `location_type` может быть только одним из следующих:
`location`	`Location` Точка, указанная с использованием географических координат, включая необязательный заголовок.
`place_id`	`string` Идентификатор места POI, связанный с путевой точкой.
`address`	`string` Человекочитаемый адрес или код плюса. Подробности см. на https://plus.codes .