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 (сообщение)
• PolylineDetails (сообщение)
• PolylineDetails.BridgeInfo (сообщение)
• PolylineDetails.FlyoverInfo (сообщение)
• PolylineDetails.NarrowRoadInfo (сообщение)
• PolylineDetails.PolylinePointIndex (сообщение)
• PolylineDetails.RestrictionInfo (сообщение)
• PolylineDetails.RoadFeatureState (перечисление)
• PolylineDetails.SkywayInfo (сообщение)
• PolylineDetails.TunnelInfo (сообщение)
• 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 (сообщение)
• VehicleInfo.HazardousGoodsType (перечисление)
• VehicleInfo.TrailerInfo (сообщение)
• Waypoint (сообщение)

Routes

Routes API.

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 не рекомендует использовать маску поля ответа с подстановочным знаком (*), поскольку: Если вы выберете только нужные поля, наш сервер сможет сэкономить вычислительные ресурсы и быстрее предоставить вам результат. Если в рабочем задании выбрать только нужные поля, задержка будет стабильной. В будущем мы можем добавить больше полей для ответов, и для их обработки может потребоваться дополнительное время. Если вы выберете все поля или все поля на верхнем уровне, то можете заметить снижение производительности, поскольку любое новое поле, которое мы добавим, будет автоматически включаться в ответ. Если выбрать только нужные поля, размер ответа будет меньше, а пропускная способность сети – выше.

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), поскольку: Если вы выберете только нужные поля, наш сервер сможет сэкономить вычислительные ресурсы и быстрее предоставить вам результат. Если в рабочем задании выбрать только нужные поля, задержка будет стабильной. В будущем мы можем добавить больше полей для ответов, и для их обработки может потребоваться дополнительное время. Если вы выберете все поля или все поля на верхнем уровне, то можете заметить снижение производительности, поскольку любое новое поле, которое мы добавим, будет автоматически включаться в ответ. Если выбрать только нужные поля, размер ответа будет меньше, а пропускная способность сети – выше.

ComputeRouteMatrixRequest

Запрос ComputeRouteMatrix

Поля
origins[]	RouteMatrixOrigin Обязательно. Массив источников, определяющий строки матрицы ответа. Для количества уникальных значений пунктов отправления и назначения действуют следующие ограничения: Сумма количества пунктов отправления и пунктов назначения, указанных как place_id или address, не должна превышать 50. Произведение количества пунктов отправления и назначения не должно превышать 625. Если для параметра routing_preference задано значение TRAFFIC_AWARE_OPTIMAL, произведение количества пунктов отправления и назначения не должно превышать 100. Если для параметра travel_mode задано значение TRANSIT, произведение количества пунктов отправления и назначения не должно превышать 100.
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, например "ru-RU" или "sr-Latn". Подробнее об идентификаторах локали Unicode… Список поддерживаемых языков приведен в разделе Поддержка языков. Если вы не укажете значение, язык будет определен на основе местоположения первого источника.
region_code	string Необязательное поле. Код региона, указываемый как двухсимвольное значение национального домена верхнего уровня (ccTLD). Подробнее о национальных доменах верхнего уровня…
units	Units Необязательное поле. Указывает единицы измерения для полей отображения.
extra_computations[]	ExtraComputation Необязательное поле. Список дополнительных вычислений, которые могут быть использованы для выполнения запроса. Примечание. В результате этих дополнительных вычислений в ответе могут появиться дополнительные поля. Эти дополнительные поля также должны быть указаны в маске поля, чтобы быть возвращенными в ответе.
traffic_model	TrafficModel Необязательное поле. Определяет выбор модели расчета в зависимости от загруженности дорог. Этот параметр влияет на возвращаемое значение поля "продолжительность" в RouteMatrixElement (прогнозируемое время в пути с учетом средних статистических показателей). TrafficModel доступен только для запросов, в которых для параметра RoutingPreference задано значение TRAFFIC_AWARE_OPTIMAL, а для параметра RouteTravelMode – DRIVE. Если запрос трафика отправлен, а значение TrafficModel не указано, по умолчанию используется значение BEST_GUESS.
transit_preferences	TransitPreferences Необязательное поле. Указывает предпочтения, влияющие на маршрут, возвращаемый для маршрутов TRANSIT. ПРИМЕЧАНИЕ. Вы можете указать значение transit_preferences, только если для параметра RouteTravelMode задано значение TRANSIT.

ExtraComputation

Дополнительные вычисления, которые нужно выполнить при обработке запроса.

Перечисления
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. Маршруты общественного транспорта доступны за последние 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, например "ru-RU" или "sr-Latn". Подробнее об идентификаторах локали Unicode… Список поддерживаемых языков приведен в разделе Поддержка языков. Если вы не укажете это значение, язык интерфейса будет определен на основе местоположения запроса маршрута.
region_code	string Необязательное поле. Код региона, указываемый как двухсимвольное значение национального домена верхнего уровня (ccTLD). Подробнее о национальных доменах верхнего уровня…
units	Units Необязательное поле. Указывает единицы измерения для полей отображения. К ним относится поле instruction в объекте NavigationInstruction. Единицы измерения, используемые для маршрута, этапа, расстояния и продолжительности, не зависят от этого значения. Если вы не укажете это значение, единицы измерения будут определены на основе местоположения первого источника.
optimize_waypoint_order	bool Необязательное поле. Если задано значение true, сервис пытается минимизировать общую стоимость маршрута, меняя порядок указанных промежуточных путевых точек. Если какая-либо из промежуточных путевых точек является путевой точкой via, запрос не будет выполнен. Чтобы найти новый порядок, используйте ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index. Если в заголовке X-Goog-FieldMask не указан параметр ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index, запрос не будет выполнен. Если для правила optimize_waypoint_order задано значение False, поле ComputeRoutesResponse.optimized_intermediate_waypoint_index будет пустым.
requested_reference_routes[]	ReferenceRoute Необязательное поле. Указывает, какие справочные маршруты нужно рассчитать в рамках запроса в дополнение к маршруту по умолчанию. Справочный маршрут – это маршрут, который рассчитывается с целью, отличной от цели маршрута по умолчанию. Например, при расчете FUEL_EFFICIENT эталонного маршрута учитываются различные параметры, которые позволяют создать оптимальный маршрут с точки зрения расхода топлива. При использовании этой функции ищите значок route_labels на маршрутах.
extra_computations[]	ExtraComputation Необязательное поле. Список дополнительных вычислений, которые могут быть использованы для выполнения запроса. Примечание. В результате этих дополнительных вычислений в ответе могут появиться дополнительные поля. Эти дополнительные поля также должны быть указаны в маске поля, чтобы быть возвращенными в ответе.
traffic_model	TrafficModel Необязательное поле. Определяет выбор модели расчета в зависимости от загруженности дорог. Этот параметр влияет на возвращаемое значение поля длительности в Route и RouteLeg (прогнозируемое время в пути с учетом средних статистических показателей). TrafficModel доступен только для запросов, в которых для параметра RoutingPreference задано значение TRAFFIC_AWARE_OPTIMAL, а для параметра RouteTravelMode – DRIVE. Если запрос трафика отправлен, а значение TrafficModel не указано, по умолчанию используется значение BEST_GUESS.
transit_preferences	TransitPreferences Необязательное поле. Указывает предпочтения, влияющие на маршрут, возвращаемый для маршрутов TRANSIT. ПРИМЕЧАНИЕ. Вы можете указать значение transit_preferences, только если для параметра RouteTravelMode задано значение TRANSIT.

ExtraComputation

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

Перечисления
EXTRA_COMPUTATION_UNSPECIFIED	Не используется. Запросы с этим значением будут отклоняться.
TOLLS	Информация о платных дорогах на маршруте.
FUEL_CONSUMPTION	Расчетный расход топлива на маршруте.
TRAFFIC_ON_POLYLINE	Полилинии маршрутов с учетом загруженности дорог.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS	NavigationInstruction в виде отформатированной текстовой строки HTML. Этот текст должен отображаться "как есть", без дополнительной программной обработки. Не анализируйте его программно.
FLYOVER_INFO_ON_POLYLINE	Информация о пролете над маршрутом. Чтобы получить эту информацию, необходимо указать маску поля routes.polyline_details.flyover_info. В настоящее время эти данные доступны только для некоторых агломераций в Индии. Это экспериментальная функция, и SKU/цена могут быть изменены.
NARROW_ROAD_INFO_ON_POLYLINE	Информация об узких дорогах на маршруте. Чтобы получить эту информацию, необходимо указать маску поля routes.polyline_details.narrow_road_info. В настоящее время эти данные доступны только для некоторых агломераций в Индии. Это экспериментальная функция, и SKU/цена могут быть изменены.
TUNNEL_INFO_ON_POLYLINE	Информация о тоннелях на маршруте. Чтобы получить эту информацию, необходимо указать маску поля routes.polyline_details.tunnel_info.
BRIDGE_INFO_ON_POLYLINE	Информация о мостах на маршруте. Чтобы получить эту информацию, необходимо указать маску поля routes.polyline_details.bridge_info.
SKYWAY_INFO_ON_POLYLINE	Информация о надземных переходах на маршрутах. Чтобы получить эту информацию, необходимо указать маску поля routes.polyline_details.skyway_info.

ReferenceRoute

Поддерживаемый справочный маршрут в ComputeRoutesRequest.

Перечисления
REFERENCE_ROUTE_UNSPECIFIED	Не используется. Запросы, содержащие это значение, не выполняются.
FUEL_EFFICIENT	Маршрут с минимальным расходом топлива.
SHORTER_DISTANCE	Маршрут с меньшим расстоянием. Это экспериментальная функция. Для запросов DRIVE эта функция отдает приоритет более короткому маршруту, а не комфорту вождения. Например, он может предпочесть местные дороги шоссе, выбрать грунтовые дороги, проехать через парковки и т. д. Эта функция не предлагает маневры, которые Google Картам известны как незаконные. Для запросов BICYCLE и TWO_WHEELER эта функция возвращает маршруты, похожие на те, которые возвращаются, когда вы не указываете requested_reference_routes. Эта функция несовместима с другими способами передвижения, промежуточными путевыми точками и optimize_waypoint_order. Такие запросы будут отклоняться. Однако его можно использовать с любым устройством routing_preference.

ComputeRoutesResponse

ComputeRoutes – ответное сообщение.

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

FallbackInfo

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

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

FallbackReason

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

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

FallbackRoutingMode

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

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

GeocodedWaypoint

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

Поля
geocoder_status	Status Указывает код статуса, полученный в результате операции геокодирования.
type[]	string Тип или типы результата в виде одного или нескольких тегов. Поддерживаемые типы: типы адресов и их компонентов.
partial_match	bool Указывает, что геокодер не вернул точное соответствие для исходного запроса, хотя и обнаружил частичное совпадение с запрашиваемым адресом. Рекомендуется проверить исходный запрос на наличие в нем опечаток и/или неполного адреса.
place_id	string Идентификатор места для этого результата.
intermediate_waypoint_request_index	int32 Индекс соответствующей промежуточной путевой точки в запросе. Заполняется только в том случае, если соответствующая путевая точка является промежуточной.

GeocodingResults

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

Поля
origin	GeocodedWaypoint Путевая точка с геокодом для начальной точки маршрута.
destination	GeocodedWaypoint Путевая точка с геокодом пункта назначения.
intermediates[]	GeocodedWaypoint Список промежуточных геокодированных путевых точек, каждая из которых содержит поле индекса, соответствующее позиции путевой точки в запросе (нумерация начинается с нуля).

LocalizedTime

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

Поля
time	LocalizedText Время в виде строки в определенном часовом поясе.
time_zone	string Содержит часовой пояс. Значение – название часового пояса в формате базы данных часовых поясов IANA (например, "America/New_York").

Местоположение

Содержит информацию о местоположении (географической точке и, при необходимости, направлении).

Поля
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	Используется для обозначения изменения названия улицы.
DESTINATION	Используется для обозначения прибытия в пункт назначения.

NavigationInstruction

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

Поля
maneuver	Maneuver Содержит инструкции по навигации для текущего шага (например, повернуть налево, влиться в поток или ехать прямо). Это поле определяет, какой значок будет показан.
instructions	string Инструкции по выполнению этого шага.

Polyline

Содержит кодированную ломаную линию.

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

PolylineDetails

Сведения, соответствующие определенному индексу или непрерывному сегменту ломаной линии. Для ломаной линии с точками P_0, P_1, …, P_N (индекс с точкой отсчета в нуле) элемент PolylineDetails определяет интервал и связанные с ним метаданные.

Поля
tunnel_info[]	TunnelInfo Информация о туннелях вдоль ломаной линии. Это поле заполняется, если в запросе указан модификатор маршрута avoid_tunnels и построенный маршрут не позволяет избежать туннелей, ИЛИ если в extra_computations указано TUNNEL_INFO_ON_POLYLINE и маршрут содержит туннели.
restriction_info[]	RestrictionInfo Сведения об ограничениях вдоль ломаной линии. Это поле заполняется, только если в запросе указан модификатор маршрута vehicle_info и в полученном маршруте есть применимое ограничение. В противном случае это поле не используется.
flyover_info[]	FlyoverInfo Информация о пролете над ломаной линией.
narrow_road_info[]	NarrowRoadInfo Информация об узких дорогах вдоль ломаной линии.
bridge_info[]	BridgeInfo Информация о мостах вдоль ломаной линии.
skyway_info[]	SkywayInfo Информация о воздушных трассах вдоль ломаной линии.

BridgeInfo

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

Поля
bridge_presence	RoadFeatureState Указывает, есть ли мост на определенном участке ломаной линии.
polyline_point_index	PolylinePointIndex Местоположение информации о мосте на ломаной линии.

FlyoverInfo

Содержит информацию о пролетах над полилинией.

Поля
flyover_presence	RoadFeatureState Используется только для вывода. Указывает, есть ли для определенного участка ломаной линии пролет.
polyline_point_index	PolylinePointIndex Расположение информации о пролете над объектом вдоль ломаной линии.

NarrowRoadInfo

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

Поля
narrow_road_presence	RoadFeatureState Используется только для вывода. Указывает, есть ли узкая дорога на определенном участке ломаной линии.
polyline_point_index	PolylinePointIndex Местоположение информации об узкой дороге вдоль ломаной линии.

PolylinePointIndex

Содержит начальный и конечный индексы для детали ломаной линии. Если данные относятся к одной точке, значения start_index и end_index будут одинаковыми.

Поля
start_index	int32 Начальный индекс этого фрагмента в ломаной линии.
end_index	int32 Конечный индекс этого фрагмента в ломаной линии.

RestrictionInfo

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

Поля
restriction_presence	RoadFeatureState Используется только для вывода. Указывает, есть ли ограничения на определенном участке ломаной линии.
polyline_point_index	PolylinePointIndex Местоположение информации об ограничении на ломаной линии.
Объединенное поле restriction. Содержит типы ограничений, которые могут применяться к определенному участку ломаной линии. restriction может иметь одно из следующих значений:
restricted_height_mm	int64 Ограничение по высоте в миллиметрах. Это поле заполняется, когда ограничение по высоте не позволяет проехать или приводит к низкому клиренсу для указанного транспортного средства.
restricted_weight_kg	int64 Ограничение по весу в килограммах. Это поле заполняется, когда ограничение по весу не позволяет проехать или близко к весу указанного транспортного средства.
hazardous_goods	bool Это поле имеет значение true, если перевозка опасных грузов запрещена.
trucks_prohibited	bool Если грузовики запрещены, в этом поле будет указано значение true.

RoadFeatureState

Содержит информацию о состоянии дорожных объектов на участке ломаной линии.

Перечисления
ROAD_FEATURE_STATE_UNSPECIFIED	Состояние функции "Дорога" не вычислено (значение по умолчанию).
EXISTS	Дорожный объект существует.
DOES_NOT_EXIST	Дороги не существует.

SkywayInfo

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

Поля
skyway_presence	RoadFeatureState Указывает, есть ли надземный переход на определенном участке ломаной линии.
polyline_point_index	PolylinePointIndex Местоположение информации о надземном переходе вдоль ломаной линии.

TunnelInfo

Содержит информацию о туннелях вдоль полилинии.

Поля
tunnel_presence	RoadFeatureState Указывает, есть ли туннель на определенном участке ломаной линии.
polyline_point_index	PolylinePointIndex Расположение информации о туннеле вдоль ломаной линии.

PolylineEncoding

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

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

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, в этом поле будет указан оптимизированный порядок промежуточных путевых точек. В противном случае поле будет пустым. Например, если вы ввели входные данные: "Пункт отправления: Лос-Анджелес; промежуточные путевые точки: Даллас, Бангор, Финикс; пункт назначения: Нью-Йорк", а оптимизированный порядок промежуточных путевых точек – Финикс, Даллас, Бангор, то в этом поле будут указаны значения [2, 0, 1]. Индекс начинается с 0 для первой промежуточной путевой точки, указанной во входных данных.
localized_values	RouteLocalizedValues Текстовые представления свойств объекта Route.
route_token	string Непрозрачный токен, который можно передать в Navigation SDK, чтобы восстановить маршрут во время навигации и, если маршрут будет перестроен, сохранить исходное намерение при его создании. Этот токен следует рассматривать как непрозрачный объект. Не сравнивайте его значения в разных запросах, поскольку оно может меняться, даже если сервис возвращает один и тот же маршрут. ПРИМЕЧАНИЕ. Параметр Route.route_token доступен только для запросов, в которых для параметра ComputeRoutesRequest.routing_preference задано значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL. Route.route_token не поддерживается для запросов с путевыми точками.
polyline_details	PolylineDetails Содержит информацию о деталях вдоль ломаной линии.

RouteLocalizedValues

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

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

RouteLabel

Ярлыки для Route, которые помогают определить свойства маршрута для сравнения с другими.

Перечисления
ROUTE_LABEL_UNSPECIFIED	По умолчанию не используется.
DEFAULT_ROUTE	Маршрут по умолчанию, который считается оптимальным.
DEFAULT_ROUTE_ALTERNATE	Альтернативный маршрут, отличный от маршрута по умолчанию. Такие маршруты будут возвращаться, если указан параметр compute_alternative_routes.
FUEL_EFFICIENT	Маршрут с минимальным расходом топлива. Маршруты с этим значением оптимизированы с учетом экологических параметров, например расхода топлива.
SHORTER_DISTANCE	Маршрут с меньшим расстоянием. Это экспериментальная функция.

RouteLeg

Содержит сегмент между путевыми точками, не относящимися к 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 Продолжительность поездки без учета загруженности дорог, представленная в текстовой форме.

StepsOverview

Содержит общую информацию о списке RouteLegStep.

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

MultiModalSegment

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

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

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

RouteLegStepLocalizedValues

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

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

RouteLegStepTransitDetails

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

Поля
stop_details	TransitStopDetails Информация об остановках прибытия и отправления для этапа.
localized_values	TransitDetailsLocalizedValues Текстовые представления свойств объекта RouteLegStepTransitDetails.
headsign	string Направление линии общественного транспорта, в котором следует ехать (как указано на транспортном средстве или остановке). Часто это конечная остановка маршрута.
headway	Duration Ожидаемое время в виде интервала между отправлениями от одной и той же остановки. Например, если значение "Интервал между прибытиями в секундах" равно 600, это означает, что следующий автобус придет через 10 минут.
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 Время в виде форматированного текста с указанием часового пояса.

TransitStopDetails

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

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

RouteLegStepTravelAdvisory

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

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

RouteLegTravelAdvisory

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

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

RouteMatrixDestination

один пункт назначения для ComputeRouteMatrixRequest;

Поля
waypoint	Waypoint Обязательно. Путевая точка назначения

RouteMatrixElement

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

Поля
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 Индекс пункта назначения в запросе (начинается с нуля).

LocalizedValues

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

Поля
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 Необязательное поле. Модификаторы для каждого маршрута, который начинается в этой точке.

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.
avoid_tunnels	bool Необязательное поле. Если задано значение true, по возможности избегаются туннели и предпочтение отдается маршрутам без них. Применяется только к DRIVE и TWO_WHEELER RouteTravelMode. Для параметра RoutingPreference необходимо задать значение TRAFFIC_AWARE_OPTIMAL. Это поле не поддерживается в ComputeRouteMatrix.

RouteTravelAdvisory

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

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

RouteTravelMode

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

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

RoutingPreference

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

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

SpeedReadingInterval

Индикатор плотности трафика на непрерывном сегменте ломаной линии или пути. Если путь состоит из точек 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	Задержки из-за пробок.

TollInfo

Содержит информацию об оплате за проезд на устройстве 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://telepase.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	Индонезия. Электронная карта, выпущенная несколькими банками и используемая для оплаты проезда по платным дорогам. Все электронные карты банков имеют одинаковую комиссию, поэтому достаточно одного значения перечисления. Примеры: 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	Индия.
IN_LOCAL_HP_PLATE_EXEMPT	Индия, освобождение от уплаты налогов в штате Химачал-Прадеш.
JP_ETC	Япония, 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 в дополнение к наклейке для экологически чистого автомобиля, выданной Управлением автомобильного транспорта. 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_BREAKAWAY	Мичиган, США.
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	Западная Виргиния, США.

TrafficModel

В этом поле указывается одно из следующих допущений, которые используются при расчете времени в пути с учетом загруженности дорог (перечислены в перечислениях ниже). В зависимости от выбранного перечисления поле duration ответа TrafficModel будет различаться. Значение содержит прогнозируемое время в пути с учетом средних статистических показателей. TrafficModel доступен только для запросов, в которых для параметра RoutingPreference задано значение TRAFFIC_AWARE_OPTIMAL, а для параметра RouteTravelMode – DRIVE.

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

TransitAgency

Транспортное агентство, которое управляет маршрутом.

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

TransitLine

Содержит информацию о маршруте общественного транспорта на этом шаге.

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

TransitPreferences

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

Поля
allowed_travel_modes[]	TransitTravelMode Набор способов передвижения, которые можно использовать при построении маршрута в TRANSIT. По умолчанию выбраны все поддерживаемые способы передвижения.
routing_preference	TransitRoutingPreference Предпочтительный вариант маршрута, который при указании влияет на возвращаемый маршрут TRANSIT.

TransitRoutingPreference

Указывает параметры маршрутов на общественном транспорте.

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

TransitTravelMode

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

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

TransitStop

Информация об остановке общественного транспорта.

Поля
name	string Название остановки общественного транспорта.
location	Location Местоположение остановки, выраженное в координатах широты и долготы.

TransitVehicle

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

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

TransitVehicleType

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

Перечисления
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	имперские (английские) единицы измерения;

VehicleEmissionType

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

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

VehicleInfo

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

Поля
emission_type	VehicleEmissionType Тип выбросов автомобиля. Применяется только к устройству DRIVE RouteTravelMode.
total_height_mm	int64 Высота транспортного средства, включая высоту прицепов. Должен быть задан для грузовика или прицепа, чтобы сработал триггер. Это поле не поддерживается в ComputeRouteMatrix, если RouteTravelMode – DRIVE.
total_length_mm	int64 Длина транспортного средства, включая длину прицепов. Должен быть задан для грузовика или прицепа, чтобы сработал триггер. Это поле не поддерживается в ComputeRouteMatrix, если RouteTravelMode – DRIVE.
total_width_mm	int64 Ширина транспортного средства, включая ширину прицепов. Должен быть задан для грузовика или прицепа, чтобы сработал триггер. Это поле не поддерживается в ComputeRouteMatrix, если RouteTravelMode – DRIVE.
total_weight_kg	int64 Вес транспортного средства, включая вес прицепов. В данном случае вес – это фактический вес, а не рейтинг веса. Должен быть задан для грузовика или прицепа, чтобы сработал триггер. Это поле не поддерживается в ComputeRouteMatrix, если RouteTravelMode – DRIVE.
trailer_info[]	TrailerInfo Содержит по одной записи для каждого трейлера. Если указана информация о трейлере, для свойства RoutingPreference необходимо задать значение TRAFFIC_AWARE_OPTIMAL. Это поле не поддерживается в ComputeRouteMatrix, если RouteTravelMode – DRIVE.
hazardous_goods_types[]	HazardousGoodsType Список опасных материалов, перевозимых в автомобиле (если есть).

HazardousGoodsType

Типы опасных материалов.

Перечисления
HAZARDOUS_GOODS_TYPE_UNSPECIFIED	Не указан тип опасных грузов.
EXPLOSIVES	Взрывчатые вещества.
GASES	Газы.
FLAMMABLE	легковоспламеняющиеся товары;
COMBUSTIBLE	легковоспламеняющиеся товары;
ORGANIC	Органические продукты.
POISON	Ядовитые вещества.
RADIOACTIVE	Радиоактивные материалы.
CORROSIVE	Коррозионные вещества.
ASPIRATION_HAZARD	Опасные товары, которые могут попасть в дыхательные пути.
ENVIRONMENTAL_HAZARD	Опасные для окружающей среды товары.
OTHER	Другие товары.

TrailerInfo

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

Поля
height_mm	int64 Высота трейлера.
length_mm	int64 Длина прицепа.
width_mm	int64 Ширина трейлера.
weight_kg	int64 Вес прицепа. В данном случае вес – это фактический вес, а не рейтинг веса.

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

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

Поля
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 Адрес, удобный для восприятия человеком, или код Plus Code. Подробную информацию можно найти на сайте https://plus.codes.
navigation_point_token	string Токен, идентифицирующий NavigationPoint, полученный с помощью метода SearchDestinations Geocoding API.