Package google.maps.routing.v2 (Automotive)

Индекс

ДинамическийАтрибутеСервис

Служба динамических атрибутов, содержащая API AnnotatePaths.

АннотатеПути

rpc AnnotatePaths( AnnotatePathsRequest ) returns ( AnnotatePathsResponse )

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

Маршруты

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 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 ), потому что:

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

Аннотатепутсреквест

Запрос к API AnnotatePaths. Пути аннотируются так, как если бы транспортное средство должно было начать движение по каждому пути в текущий момент.

Аннотации к сегменту могут различаться в зависимости от пути, к которому он принадлежит, например, один и тот же сегмент A может существовать в пути 1 и пути 2. В пути 1 за сегментом A следует сегмент B, а в пути 2 за сегментом A следует сегмент. C. Сегмент A может иметь разные динамические атрибуты, возвращаемые для Пути 1 и Пути 2, в зависимости от разницы в последующих сегментах.

Поля
paths[]

Path

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

annotation_options

AnnotationOptions

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

Аннотатепассответ

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

Поля
annotated_paths[]

AnnotatedPath

Пути из входных данных, аннотированные запрошенными атрибутами.

АннотатедПат

Копия входного пути, возвращенная с предсказанными атрибутами.

Поля
annotated_segments[]

AnnotatedSegment

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

Аннотированный сегмент

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

Поля
segment

Segment

Детали сегмента используются для отличия его от других сегментов.

segment_span_attributes[]

SegmentSpanAttribute

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

Параметры аннотации

Запрошены аннотации для входных путей.

Поля
include_level_of_service

bool

Необязательный. Если установлено значение true, сегменты в ответе будут помечены прогнозируемыми значениями трафика. «Уровень обслуживания» — это обычно используемый термин для описания категоризации потока трафика, но определения уровня обслуживания в этом API принадлежат только этому API.

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

Сообщение запроса 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

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

route_token
(deprecated)

string

Необязательный. Устарело: вместо этого используйте route_token_options.route_token .

route_token_options

RouteTokenOptions

Необязательный. Маркеры маршрута позволяют запросу зависеть от ранее выбранного маршрута.

traffic_model

TrafficModel

Необязательный. Указывает предположения, которые следует использовать при расчете времени в пробке. Этот параметр влияет на значение, возвращаемое в поле длительности в Route и RouteLeg , которое содержит прогнозируемое время в трафике на основе исторических средних значений. TrafficModel доступен только для запросов, в которых для RoutingPreference установлено значение TRAFFIC_AWARE_OPTIMAL , а для RouteTravelMode — DRIVE . По умолчанию используется BEST_GUESS если трафик запрошен, а TrafficModel не указан.

transit_preferences

TransitPreferences

Необязательный. Указывает предпочтения, влияющие на маршрут, возвращаемый для TRANSIT маршрутов. ПРИМЕЧАНИЕ. transit_preferences можно указать только в том случае, если для RouteTravelMode установлено значение TRANSIT .

navigation_session_id

string

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

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

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

Перечисления
EXTRA_COMPUTATION_UNSPECIFIED Не используется. Запросы, содержащие это значение, не будут выполнены.
TOLLS Информация о платных маршрутах.
FUEL_CONSUMPTION Ориентировочный расход топлива по маршруту(ам).
TRAFFIC_ON_POLYLINE Полилинии с учетом трафика для маршрутов.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions представлены в виде форматированной текстовой строки HTML. Этот контент предназначен для чтения «как есть». Этот контент предназначен только для отображения. Не анализируйте его программно.
PREDICTED_SPEED_ON_POLYLINE_20KPH_BUCKETS Прогнозируемая скорость ковша 20 км/ч. Результаты в следующих predicted_speed_intervals : [0, 10) км/ч, [10, 30) км/ч, ... [110, 130) км/ч, [130, inf) км/ч.
PREDICTED_SPEED_ON_POLYLINE_10KPH_BUCKETS Прогнозируемая скорость ведра 10 км/ч. Результаты в следующих predicted_speed_intervals : [0, 10) км/ч, [10, 20) км/ч, ... [120, 130) км/ч, [130, inf) км/ч.

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

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

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

ComputeRoutesResponse

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

Поля
routes[]

Route

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

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

FallbackInfo

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

Поля
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

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

УровеньОфСервис

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

Перечисления
LEVEL_OF_SERVICE_UNSPECIFIED Значение по умолчанию. Это значение означает, что прогнозируемое значение трафика отсутствует.
LEVEL_OF_SERVICE_STOPPED Движение транспорта остановлено.
LEVEL_OF_SERVICE_STOP_AND_GO Движение стоит и идет.
LEVEL_OF_SERVICE_SLOW Прогнозируется замедление движения, но пробок не предвидится.
LEVEL_OF_SERVICE_NORMAL Скорость нормальная, замедления не предвидится.

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

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

Поля
time

LocalizedText

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

time_zone

string

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

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

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

Поля
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

Инструкции по навигации на этом этапе.

Путь

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

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

В настоящее время длина пути ограничена 15 км. Путь измеряется от начала первого сегмента — предполагаемого местоположения транспортного средства. Будет возвращена ошибка, если сегмент пути начинается дальше, чем в 15 км от начала первого сегмента. Допускается, чтобы последний участок начинался до 15 км и заканчивался после 15 км. Частичные ответы не возвращаются.

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

Поля
segments[]

Segment

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

Полилиния

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

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

string

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

geo_json_linestring

Struct

Указывает полилинию с использованием формата GeoJSON LineString .

ПолилинияПодробнее

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

Поля
altitude_info[]

AltitudeInfo

Детали высоты вдоль полилинии.

incident_info[]

IncidentInfo

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

segment_info[]

SegmentInfo

Сегментируйте детали вдоль полилинии.

ferry_info[]

FerryInfo

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

highway_info[]

HighwayInfo

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

toll_info[]

TollInfo

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

tunnel_info[]

TunnelInfo

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

vignette_info[]

VignetteInfo

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

hov_info[]

HovInfo

Хов детали вдоль полилинии. Это поле заполняется только в том случае, если в запросе указан модификатор allow_hov и результирующий маршрут содержит его. В противном случае это поле не используется.

restriction_info[]

RestrictionInfo

Детали ограничения вдоль полилинии. Это поле заполняется только в том случае, если в запросе указан модификатор маршрута vehicle_info и результирующий маршрут содержит применимое ограничение. В противном случае это поле не используется.

predicted_speeds[]

PredictedSpeedInfo

Прогнозируемые сегменты скорости вдоль полилинии.

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

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

Поля
polyline_point_index

PolylinePointIndex

Местоположение измерения высоты вдоль полилинии.

altitude_meters

double

Высота в метрах относительно эллипсоида WGS-84.

Информация о пароме

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

Поля
ferry_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

Расположение информации, связанной с переправой, вдоль ломаной линии.

Информация о шоссе

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

Поля
highway_presence

RoadFeatureState

Только вывод. Указывает, существует ли шоссе на данном участке полилинии.

polyline_point_index

PolylinePointIndex

Расположение информации о шоссе вдоль полилинии.

ХовИнфо

Инкапсулирует информацию о сегментах/полосах HOV вдоль полилинии.

Поля
hov_presence

RoadFeatureState

Только вывод. Указывает, существует ли дорога/полоса HOV на данном участке полилинии.

polyline_point_index

PolylinePointIndex

Расположение информации, связанной с HOV, вдоль полилинии.

Информация об инциденте

Инкапсулирует информацию об инциденте вдоль полилинии.

Поля
incident_type

IncidentType

Тип происшествия.

estimated_delay

Duration

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

polyline_point_index

PolylinePointIndex

Местоположение происшествия вдоль полилинии.

Тип инцидента

Типы происшествий.

Перечисления
INCIDENT_TYPE_UNSPECIFIED Значение по умолчанию. Это значение не используется.
INCIDENT_ROAD_CLOSED Перекрытие дороги.
INCIDENT_CRASH Авария.
INCIDENT_CONSTRUCTION Строительство.
INCIDENT_JAM Пробка.

ПолилинияПоинтИндекс

Инкапсулирует начальный и конечный индексы полилинии. В тех случаях, когда данные соответствуют одной точке, start_index и end_index будут равны.

Поля
start_index

int32

Начальный индекс этой детали в полилинии.

end_index

int32

Конечный индекс этой детали в полилинии.

Предсказанная скоростьинформация

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

Поля
predicted_speed_interval

PredictedSpeedInterval

Диапазон скоростей прогнозируется на этом участке полилинии.

polyline_point_index

PolylinePointIndex

Расположение прогнозируемого интервала скорости вдоль полилинии.

Интервал прогнозируемой скорости

Гибкий интервал прогнозируемой скорости, представляющий скорости в [ lower_bound_kph_inclusive , upper_bound_kph_exclusive ). Возвращаемые интервалы зависят от того, какие extra_computations были указаны в запросе.

Поля
lower_bound_kph_inclusive

int32

Включая нижнюю границу.

upper_bound_kph_exclusive

int32

Эксклюзивная верхняя граница. Представляет бесконечность, если не заполнено.

Информация об ограничении

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

Поля
restriction_presence

RoadFeatureState

Только вывод. Указывает, существует ли ограничение для данного участка полилинии.

polyline_point_index

PolylinePointIndex

Расположение информации, связанной с ограничениями, вдоль полилинии.

restriction поля объединения. Инкапсулирует типы ограничений, которые могут применяться к данному участку полилинии. restriction может быть только одним из следующих:
restricted_height_mm

int64

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

ДорогаХарактеристикаСостояние

Инкапсулирует состояния объектов дороги (например, автомагистралей, паромов и т. д.) вдоль участка полилинии.

Перечисления
ROAD_FEATURE_STATE_UNSPECIFIED Состояние объекта дороги не было рассчитано (значение по умолчанию).
EXISTS Объект дороги существует.
DOES_NOT_EXIST Объект дороги не существует.

Информация о сегменте

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

Поля
place_id

string

Идентификатор места для этого участка дороги.

polyline_point_index

PolylinePointIndex

Расположение сегмента вдоль полилинии.

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

Инкапсулирует информацию о дорожных сборах вдоль полилинии.

Поля
toll_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

Расположение информации о платных дорогах вдоль полилинии.

Информация о туннеле

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

Поля
tunnel_presence

RoadFeatureState

Только вывод. Указывает, существует ли туннель на данном участке полилинии.

polyline_point_index

PolylinePointIndex

Расположение информации, связанной с туннелем, вдоль полилинии.

ВиньеткаИнформация

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

Поля
vignette_presence

RoadFeatureState

Только вывод. Указывает, существует ли виньетка для данного участка полилинии.

polyline_point_index

PolylinePointIndex

Расположение информации, связанной с виньеткой, вдоль полилинии.

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

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

Перечисления
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 не поддерживается для запросов, которые имеют путевые точки.

route_token_update_fidelity

RouteTokenUpdateFidelity

Для ComputeRouteRequests содержащих route_token , это поле идентифицирует связь этого маршрута к входному токену.

polyline_details

PolylineDetails

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

RateLocalizedValues

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

Поля
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

transit_fare

LocalizedText

Транзитный тариф представлен в текстовой форме.

Routetokenupdatefidelity

Для запросов с использованием route_token_behavior GET_ROUTE_UPDATES идентифицирует маршруты, построенные из соответствующего route_token. (Не связан с route_token в этом сообщении).

Перечисления
ROUTE_TOKEN_UPDATE_FIDELITY_UNSPECIFIED Этот маршрут не был получен из токена маршрута.
APPROXIMATE Этот маршрут реконструирован из токена маршрута и логически эквивалентен, но геометрия маршрута не идентична.
IDENTICAL Этот маршрут геометрически идентичен токену маршрута.

RouteLabel

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

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

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

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

STESTORGEVERVIEW

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

Поля
multi_modal_segments[]

MultiModalSegment

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

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

Предоставляет суммированную информацию о различных мультимодальных сегментах 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

Определяет ожидаемое время как продолжительность между отъездами от той же остановки в это время. Например, со значением Headway Seconds 600 вы ожидаете, что вы ожидаете, если вам следует пропустить свой автобус.

transit_line

TransitLine

Информация о транзитной линии, используемой на этом этапе.

stop_count

int32

Количество остановок от отъезда до остановки прибытия. Этот счет включает в себя остановку прибытия, но исключает остановку отъезда. Например, если ваш маршрут оставляет от остановки A, проходит через остановки B и C и прибывает на Stop 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 есть платы. Если это поле устанавливается, но подполе Ayrated_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).

RoutematrixDestination

Единственный пункт назначения для компьютерного эпоха

Поля
waypoint

Waypoint

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

RoutematrixElement

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

Поля
status

Status

Код состояния ошибки для этого элемента.

condition

RouteMatrixElementCondition

Указывает, был ли маршрут найден или нет. Независимо от статуса.

distance_meters

int32

Расстояние прохождения маршрута, в метрах.

duration

Duration

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

static_duration

Duration

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

travel_advisory

RouteTravelAdvisory

Дополнительная информация о маршруте. Например: информация об ограничении и информация о платежей

fallback_info

FallbackInfo

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

localized_values

LocalizedValues

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

origin_index

int32

Ноль индекс происхождения в запросе.

destination_index

int32

Зоровый индекс назначения в запросе.

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

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

Поля
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

transit_fare

LocalizedText

Транзитный тариф представлен в текстовой форме.

RoutematrixElementCondition

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

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

Routematrixorigin

Одно происхождение для компьютерного эпоха

Поля
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 .

avoid_tunnels

bool

При установлении True избегает туннелей, где разумные, предпочитая маршруты, не содержащие туннели. Применяется только к DRIVE и TWO_WHEELER RouteTravelMode . RoutingPreference должен быть установлен на TRAFFIC_AWARE_OPTIMAL . Это поле не поддерживается в ComputerouteMatrix.

avoid_vignettes[]

string

Когда он установил True, избегает дорог с виньетками в определенных странах, где разумные, предпочитая маршруты, не содержащие поездки на дорогах с виньетками в странах, перечисленных в качестве поддержки этой функции. Применяется только к DRIVE и TWO_WHEELER RouteTravelMode . RoutingPreference должен быть установлен на TRAFFIC_AWARE_OPTIMAL . Страны должны быть указаны в кодах региона Unicode CLDR. Поддерживаемыми странами являются CH, AT, CZ, HU, SI, SK. Это поле не поддерживается в ComputerouteMatrix.

hov_preference

HOVPreference

Указывает, следует ли изменять маршрутизацию на основе присутствия дорог, имеющих право HOV. Это поле не поддерживается в ComputerouteMatrix.

Hovpreference

Указывает, следует ли изменять маршрутизацию на основе присутствия дорог HOV (автомобиль с высоким содержанием) или полосы движения.

Поля
allow_hov

bool

Указывает, разрешать ли маршрутизацию на дороги только для HOV в дополнение к сегментам дорог, которые разделяют дорожные дорожки. По умолчанию предпочтение будет отдано маршрутам, не содержащим дороги только для HOV. RoutingPreference должен быть установлен на TRAFFIC_AWARE_OPTIMAL .

Routetokenoptions

Варианты, связанные с токенами маршрута.

Поля
route_token

string

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

route_token_behavior

RouteTokenBehavior

Необязательный. Индикация того, как лечить route_token .

Routetokenbehavior

Поддерживаемые режимы для токенов маршрута.

Перечисления
ROUTE_TOKEN_BEHAVIOR_UNSPECIFIED Рассматривается как GET_ROUTE_UPDATES для совместимости.
GET_ROUTE_UPDATES Если | Происхождение | находится на маршруте, представленном route_token , одним из полученных маршрутов является тот, который представлен route_token . Остальные маршруты не связаны. Обновления наиболее эффективны, когда | Происхождение | находится недалеко от начала route_token ; То есть пользователь не перемещался далеко от того места, где был сгенерирован route_token .
GET_SIMILAR_ROUTES Маршрут, представленный route_token , не включен в ответ, но другие маршруты включают сходство с route_token как весовой фактор в их ранжировании.

RouteTraveladVisory

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

Поля
toll_info

TollInfo

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

vignette_info

VignetteInfo

Инкапсулирует поля данных для виньетки. Сервис только заполняет это поле в следующих условиях:

  • Сам запрос должен указать модификатор маршрута avoid_vignettes .
  • Полученный маршрут не может избежать виньетки.

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

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 запросами и только для маршрутов, где информация о тарине доступна для всех этапов транзита.

Vignetteinfo

Инкапсулирует информацию о виньетке по маршруту.

Поля
country_vignettes_used[]

string

Страны, где используются виньетки. Страны указаны в кодах региона Unicode CLDR. Поддерживаемыми странами являются CH, AT, CZ, HU, SI, SK.

RouteTravelMode

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

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

RoutingPreference

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

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

Сегмент

Сегмент, который принадлежит пути.

Поля
polyline

Polyline

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

id поля Союза. Используется для идентификации этого сегмента в пространстве идентификации. Необходимый. id может быть только одним из следующих:
place_id

string

Идентификатор места для этого дорожного сегмента. Используется по всему API.

Сегменты

Используется для разграничения подраздела сегмента. Если пролет покрывает весь сегмент, start_meters будет 0, а End_meters будет длиной сегмента.

Поля
start_meters

int32

Где начало пролета происходит от начальной точки полилинии сегмента.

end_meters

int32

Где конец пролета находится от начальной точки полилинии сегмента.

SegmentsPanattribute

SegmentsPanattribute содержит аннотации, возвращенные из API.

Поля
segment_span

SegmentSpan

Описывает, где в сегменте применяются аннотации.

level_of_service

LevelOfService

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

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 Пробок обнаружено.

Толлинфо

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

Поля
estimated_price[]

Money

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

TollPass

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

Перечисления
TOLL_PASS_UNSPECIFIED Не используется. Если это значение используется, то запрос не удается.
AU_ETOLL_TAG Sydney Toll Pass. См. Дополнительную информацию по адресу https://www.myetoll.com.au .
AU_EWAY_TAG Sydney Toll Pass. См. Дополнительную информацию по адресу 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 Индия, HP State Plate Exemption.
JP_ETC Япония и т. Д. Электронная беспроводная система для сбора платы. https://www.go-etc.jp/
JP_ETC2 Япония и т. Д.2.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 Мексика Toll Pass Company. Один из многих действует в Мехико. См. Дополнительную информацию на https://www.televia.com.mx .
MX_TELEVIA Мексика Toll Pass Company. Один из многих действует в Мехико. https://www.televia.com.mx
MX_VIAPASS Мексика пропуск. См. Дополнительную информацию по адресу https://www.viaspans.com.mx/viasps/web_home.aspx .
US_AL_FREEDOM_PASS Ал, США.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS А.К., США.
US_CA_FASTRAK CA, США.
US_CA_FASTRAK_CAV_STICKER Указывает, что у водителя есть какой -либо проход Fastrak в дополнение к наклейке DMV, выпущенной чистым воздушным транспортным средством (CAV). 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 IL, США.
US_IL_IPASS IL, США.
US_IN_EZPASSIN В США.
US_KS_BESTPASS_HORIZON KS, США.
US_KS_KTAG KS, США.
US_KS_NATIONALPASS KS, США.
US_KS_PREPASS_ELITEPASS KS, США.
US_LA_GEAUXPASS LA, США.
US_LA_TOLL_TAG LA, США.
US_MA_EZPASSMA Ма, США.
US_MD_EZPASSMD MD, США.
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 NC, США.
US_NC_PEACH_PASS NC, США.
US_NC_QUICK_PASS NC, США.
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 UT, США.
US_VA_EZPASSVA VA, США.
US_WA_BREEZEBY WA, США.
US_WA_GOOD_TO_GO WA, США.
US_WV_EZPASSWV WV, США.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, США.
US_WV_MOV_PASS Западная Вирджиния, США
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, США.

Trafficmodel

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

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

Транстирантность

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

Поля
name

string

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

phone_number

string

Форматированный номер телефона транзитного агентства.

uri

string

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

Транзитная линия

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

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

Transittravelmode

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

Перечисления
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 для значка, связанного с этим типом транспортного средства, на основе местных транспортных вывесок.

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

FehishemissionType

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

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

Автомобильнфо

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

Поля
emission_type

VehicleEmissionType

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

total_axle_count

int32

Общее количество оси. Должен быть> = 2, если установлено. Должен быть установлен для перевозки, чтобы триггер, но не обязательно для прицеления. Это поле не поддерживается в ComputingOuteMatrix, когда RouteTravelMode является DRIVE .

total_height_mm

int64

Высота транспортного средства, включая высоты любых прикрепленных прицепов. Должен быть установлен для грузовых перевозок или сцепления, чтобы запустить. Это поле не поддерживается в ComputingOuteMatrix, когда RouteTravelMode является DRIVE .

total_length_mm

int64

Длина транспортного средства, включая длину любых прикрепленных прицепов. Должен быть установлен для грузовых перевозок или сцепления, чтобы запустить. Это поле не поддерживается в ComputingOuteMatrix, когда RouteTravelMode является DRIVE .

total_width_mm

int64

Ширина транспортного средства, включая ширину любых прикрепленных прицепов. Должен быть установлен для грузовых перевозок или сцепления, чтобы запустить. Это поле не поддерживается в ComputingOuteMatrix, когда RouteTravelMode является DRIVE .

total_weight_kg

int64

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

trailer_info[]

TrailerInfo

Содержит одну запись для каждого трейлера. Если предоставлена ​​информация о трейлере, RoutingPreference должна быть установлена ​​на TRAFFIC_AWARE_OPTIMAL . Это поле не поддерживается в ComputingOuteMatrix, когда RouteTravelMode является DRIVE .

Trailerinfo

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

Поля
height_mm

int64

Высота трейлера.

length_mm

int64

Длина трейлера.

width_mm

int64

Ширина трейлера.

weight_kg

int64

Вес трейлера. Вес в этом контексте относится к фактическому весу, а не к рейтингу веса.

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

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

Поля
via

bool

На этой путевой точке отмечается как веха, а не остановка. Для каждой не VIA Waypoint в запросе ответ добавляет запись в массив 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

ID POI Place, связанный с путевой точкой.

address

string

Человеческий читаемый адрес или код плюс. Подробности см. на https://plus.codes .