Package google.maps.routing.v2

Индекс

Маршруты

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.
  • Произведение количества пунктов отправления × количества пунктов назначения не должно превышать 100, если параметр routing_preference установлен в значение TRAFFIC_AWARE_OPTIMAL .
  • Произведение количества пунктов отправления × количества пунктов назначения не должно превышать 100, если параметр travel_mode установлен в TRANSIT .
destinations[]

RouteMatrixDestination

Обязательно. Массив адресов назначения, определяющий столбцы матрицы ответов.

travel_mode

RouteTravelMode

Необязательно. Указывает вид транспорта.

routing_preference

RoutingPreference

Необязательный параметр. Указывает способ вычисления маршрута. Сервер пытается использовать выбранный предпочтительный маршрут для вычисления маршрута. Если предпочтительный маршрут приводит к ошибке или чрезмерной задержке, возвращается сообщение об ошибке. Этот параметр можно указать только в том случае, если travel_mode имеет DRIVE или TWO_WHEELER , в противном случае запрос завершится неудачей.

departure_time

Timestamp

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

arrival_time

Timestamp

Необязательно. Время прибытия. ПРИМЕЧАНИЕ: Можно задать только в том случае, если для параметра RouteTravelMode установлено значение TRANSIT . Можно указать либо departure_time , либо arrival_time , но не оба параметра одновременно.

language_code

string

Необязательно. Код языка BCP-47, например, "en-US" или "sr-Latn". Дополнительную информацию см. в разделе "Идентификатор локали Unicode" . Список поддерживаемых языков см. в разделе " Поддержка языков" . Если это значение не указано, язык отображения определяется по местоположению первого источника.

region_code

string

Необязательный параметр. Код региона, указанный в виде двухсимвольного значения ccTLD («домен верхнего уровня»). Дополнительную информацию см. в разделе «Домены верхнего уровня с кодом страны» .

units

Units

Необязательный параметр. Задает единицы измерения для отображаемых полей.

extra_computations[]

ExtraComputation

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

traffic_model

TrafficModel

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

transit_preferences

TransitPreferences

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

Экстравычисления

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

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

ComputeRoutesRequest

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

Поля
origin

Waypoint

Обязательно. Начальная точка маршрута.

destination

Waypoint

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

intermediates[]

Waypoint

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

travel_mode

RouteTravelMode

Необязательно. Указывает вид транспорта.

routing_preference

RoutingPreference

Необязательный параметр. Указывает способ вычисления маршрута. Сервер пытается использовать выбранный предпочтительный маршрут для вычисления маршрута. Если предпочтительный маршрут приводит к ошибке или чрезмерной задержке, возвращается сообщение об ошибке. Этот параметр можно указать только в том случае, если travel_mode имеет значение DRIVE или TWO_WHEELER , в противном случае запрос завершится неудачей.

polyline_quality

PolylineQuality

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

polyline_encoding

PolylineEncoding

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

departure_time

Timestamp

Необязательно. Время отправления. Если вы не укажете это значение, по умолчанию будет установлено время отправки запроса. ПРИМЕЧАНИЕ: Вы можете указать время departure_time в прошлом только в том случае, если RouteTravelMode установлен в TRANSIT . Транзитные поездки доступны для поездок сроком до 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 учитывает различные параметры, которые позволят создать оптимальный маршрут с оптимальным расходом топлива. При использовании этой функции ищите route_labels в результирующих маршрутах.

extra_computations[]

ExtraComputation

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

traffic_model

TrafficModel

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

transit_preferences

TransitPreferences

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

Экстравычисления

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

Перечисления
EXTRA_COMPUTATION_UNSPECIFIED Не используется. Запросы, содержащие это значение, завершатся ошибкой.
TOLLS Информация о платных участках маршрута (маршрутов).
FUEL_CONSUMPTION Расчетный расход топлива на данном маршруте (маршрутах).
TRAFFIC_ON_POLYLINE Полилинии, учитывающие интенсивность движения, для данного маршрута (маршрутов).
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions представлены в виде отформатированной HTML-строки. Этот контент предназначен для чтения в неизмененном виде. Он предназначен только для отображения. Не следует обрабатывать его программным способом.
FLYOVER_INFO_ON_POLYLINE Информация об эстакадах для маршрута(ов). Для получения этой информации необходимо указать параметр поля routes.polyline_details.flyover_info . В настоящее время эти данные будут доступны только для некоторых крупных городов Индии. Эта функция является экспериментальной, и ее артикул/стоимость могут быть изменены.
NARROW_ROAD_INFO_ON_POLYLINE Информация о узких дорогах для маршрута(ов). Для получения этой информации необходимо указать параметр поля routes.polyline_details.narrow_road_info . В настоящее время эти данные будут доступны только для некоторых крупных городов Индии. Эта функция является экспериментальной, и ее артикул/стоимость могут быть изменены.

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

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

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

Маршрут с меньшим расстоянием. Это экспериментальная функция.

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

Для запросов 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 Указывает, что для вычисления ответа использовался RoutingPreference TRAFFIC_UNAWARE .
FALLBACK_TRAFFIC_AWARE Указывает, что для вычисления ответа использовался RoutingPreference TRAFFIC_AWARE .

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

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

Поля
geocoder_status

Status

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

type[]

string

Тип(ы) результата в виде нуля или более тегов типа. Поддерживаемые типы: типы адресов и типы компонентов адресов .

partial_match

bool

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

place_id

string

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

intermediate_waypoint_request_index

int32

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

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

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

Поля
origin

GeocodedWaypoint

Исходная точка маршрута, геолокационная.

destination

GeocodedWaypoint

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

intermediates[]

GeocodedWaypoint

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

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

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

Поля
time

LocalizedText

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

time_zone

string

Содержит часовой пояс. Значение представляет собой название часового пояса, как оно определено в базе данных часовых поясов IANA , например, "America/New_York".

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

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

Поля
lat_lng

LatLng

Географические координаты контрольной точки.

heading

Int32Value

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

Маневр

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

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

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

Поля
maneuver

Maneuver

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

instructions

string

Инструкции по выполнению этого шага.

Полилиния

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

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

string

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

geo_json_linestring

Struct

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

PolylineDetails

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

Поля
flyover_info[]

FlyoverInfo

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

narrow_road_info[]

NarrowRoadInfo

Детали узкой дороги вдоль полилинии.

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

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

RoadFeatureState

Отражает состояние дорожных объектов вдоль участка полилинии.

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

PolylineEncoding

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

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

PolylineQuality

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

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

Маршрут

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

Поля
route_labels[]

RouteLabel

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

legs[]

RouteLeg

Набор участков пути (отрезков между промежуточными точками), составляющих маршрут. Каждый участок соответствует пути между двумя 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, это поле будет содержать оптимизированный порядок промежуточных путевых точек. В противном случае это поле будет пустым. Например, если вы зададите следующие данные: Начальная точка: Лос-Анджелес; Промежуточные путевые точки: Даллас, Бангор, Финикс; Конечная точка: Нью-Йорк; и оптимизированный порядок промежуточных путевых точек — Финикс, Даллас, Бангор, то это поле будет содержать значения [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 не поддерживается для запросов, содержащих путевые точки Via.

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 Более короткий маршрут. Это экспериментальная функция.

Маршрутная нога

Содержит участок между точками маршрута, не via .

Поля
distance_meters

int32

Пройденное расстояние участка маршрута в метрах.

duration

Duration

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

static_duration

Duration

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

polyline

Polyline

Общая полилиния для этого участка, включающая полилинию каждой step .

start_location

Location

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

end_location

Location

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

steps[]

RouteLegStep

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

travel_advisory

RouteLegTravelAdvisory

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

localized_values

RouteLegLocalizedValues

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

steps_overview

StepsOverview

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

RouteLegLocalizedValues

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

Поля
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

Обзор этапов

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

Поля
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 , обозначающий конец мультимодального сегмента.

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

Содержит сегмент 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

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

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

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

Поля
stop_details

TransitStopDetails

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

localized_values

TransitDetailsLocalizedValues

Текстовое представление свойств объекта RouteLegStepTransitDetails .

headsign

string

Указывает направление движения по данной линии, как это обозначено на транспортном средстве или на остановке отправления. Зачастую это направление соответствует конечной станции.

headway

Duration

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

transit_line

TransitLine

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

stop_count

int32

Количество остановок от остановки отправления до остановки прибытия. В это число входит остановка прибытия, но не включается остановка отправления. Например, если ваш маршрут начинается с остановки A, проходит через остановки B и C и прибывает на остановку D,

stop_count

возвращает 3.

trip_short_text

string

Текст, который отображается в расписаниях и на информационных табло для идентификации пассажирами маршрута общественного транспорта. Текст должен однозначно идентифицировать поездку в течение дня обслуживания. Например, "538" — это trip_short_text поездки поезда Amtrak, отправляющегося из Сан-Хосе, Калифорния, в 15:10 по будням в Сакраменто, Калифорния.

TransitDetailsLocalizedValues

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

Поля
arrival_time

LocalizedTime

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

departure_time

LocalizedTime

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

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

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

Поля
arrival_stop

TransitStop

Информация о конечной остановке на данном этапе.

arrival_time

Timestamp

Расчетное время прибытия на данный этап.

departure_stop

TransitStop

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

departure_time

Timestamp

Ориентировочное время отправления на данном этапе.

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

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

Поля
speed_reading_intervals[]

SpeedReadingInterval

Примечание: В данный момент это поле не заполнено.

Маршрутный маршрутный совет

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

Поля
toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

Speed reading intervals indicating traffic density. This field is only populated for requests when the request has a TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference value, and TRAFFIC_ON_POLYLINE is included in the ComputeRoutesRequest.extra_computations . The intervals cover the entire polyline of the RouteLeg without overlap. The start point of a specified interval is the same as the end point of the preceding interval.

Пример:

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

RouteMatrixDestination

A single destination for ComputeRouteMatrixRequest

Поля
waypoint

Waypoint

Required. Destination waypoint

RouteMatrixElement

Contains route information computed for an origin/destination pair in the ComputeRouteMatrix API. This proto can be streamed to the client.

Поля
status

Status

Error status code for this element.

condition

RouteMatrixElementCondition

Indicates whether the route was found or not. Independent of status.

distance_meters

int32

The travel distance of the route, in meters.

duration

Duration

The length of time needed to navigate the route. If you set the routing_preference to TRAFFIC_UNAWARE , then this value is the same as static_duration . If you set the routing_preference to either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

static_duration

Duration

The duration of traveling through the route without taking traffic conditions into consideration.

travel_advisory

RouteTravelAdvisory

Additional information about the route. For example: restriction information and toll information

fallback_info

FallbackInfo

In some cases when the server is not able to compute the route with the given preferences for this particular origin/destination pair, it may fall back to using a different mode of computation. When fallback mode is used, this field contains detailed information about the fallback response. Otherwise this field is unset.

localized_values

LocalizedValues

Text representations of properties of the RouteMatrixElement .

origin_index

int32

Zero-based index of the origin in the request.

destination_index

int32

Zero-based index of the destination in the request.

LocalizedValues

Text representations of certain properties.

Поля
distance

LocalizedText

Travel distance represented in text form.

duration

LocalizedText

Duration represented in text form taking traffic conditions into consideration. Note: If traffic information was not requested, this value is the same value as static_duration.

static_duration

LocalizedText

Duration represented in text form without taking traffic conditions into consideration.

transit_fare

LocalizedText

Transit fare represented in text form.

RouteMatrixElementCondition

The condition of the route being returned.

Перечисления
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Only used when the status of the element is not OK.
ROUTE_EXISTS A route was found, and the corresponding information was filled out for the element.
ROUTE_NOT_FOUND No route could be found. Fields containing route information, such as distance_meters or duration , will not be filled out in the element.

RouteMatrixOrigin

A single origin for ComputeRouteMatrixRequest

Поля
waypoint

Waypoint

Required. Origin waypoint

route_modifiers

RouteModifiers

Optional. Modifiers for every route that takes this as the origin

RouteModifiers

Encapsulates a set of optional conditions to satisfy when calculating the routes.

Поля
avoid_tolls

bool

When set to true, avoids toll roads where reasonable, giving preference to routes not containing toll roads. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_highways

bool

When set to true, avoids highways where reasonable, giving preference to routes not containing highways. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_ferries

bool

When set to true, avoids ferries where reasonable, giving preference to routes not containing ferries. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_indoor

bool

When set to true, avoids navigating indoors where reasonable, giving preference to routes not containing indoor navigation. Applies only to the WALK RouteTravelMode .

vehicle_info

VehicleInfo

Specifies the vehicle information.

toll_passes[]

TollPass

Encapsulates information about toll passes. If toll passes are provided, the API tries to return the pass price. If toll passes are not provided, the API treats the toll pass as unknown and tries to return the cash price. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

RouteTravelAdvisory

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

Поля
toll_info

TollInfo

Contains information about tolls on the route. This field is only populated if tolls are expected on the route and TOLLS is included in the request's ComputeRoutesRequest.extra_computations . If this field is set, but the estimatedPrice subfield is not populated, then the route contains tolls, but the estimated price is unknown. If toll_info is not set, then there are no tolls expected on the route.

speed_reading_intervals[]

SpeedReadingInterval

Speed reading intervals indicating traffic density. This field is only populated for requests when the request has a TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference value, and TRAFFIC_ON_POLYLINE is included in the ComputeRoutesRequest.extra_computations . The intervals cover the entire polyline of the route without overlap. The start point of a specified interval is the same as the end point of the preceding interval.

Пример:

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

int64

The predicted fuel consumption in microliters. This field is only populated when FUEL_CONSUMPTION is included in the request's ComputeRoutesRequest.extra_computations .

route_restrictions_partially_ignored

bool

Returned route may have restrictions that are not suitable for requested travel mode or route modifiers.

transit_fare

Money

If present, contains the total fare or ticket costs on this route This property is only returned for TRANSIT requests and only for routes where fare information is available for all transit steps.

RouteTravelMode

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

Перечисления
TRAVEL_MODE_UNSPECIFIED No travel mode specified. Defaults to DRIVE .
DRIVE Travel by passenger car.
BICYCLE Travel by bicycle.
WALK Travel by walking.
TWO_WHEELER Two-wheeled, motorized vehicle. For example, motorcycle. Note that this differs from the BICYCLE travel mode which covers human-powered mode.
TRANSIT Travel by public transit routes, where available.

RoutingPreference

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

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

SpeedReadingInterval

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

Поля
start_polyline_point_index

int32

The starting index of this interval in the polyline.

end_polyline_point_index

int32

The ending index of this interval in the polyline.

Union field speed_type . The type of speed in this interval. speed_type can be only one of the following:
speed

Speed

Traffic speed in this interval.

Скорость

The classification of polyline speed based on traffic data.

Перечисления
SPEED_UNSPECIFIED Default value. This value is unused.
NORMAL Normal speed, no traffic delays.
SLOW Slowdown detected, medium amount of traffic.
TRAFFIC_JAM Traffic delays.

TollInfo

Encapsulates toll information on a Route or on a RouteLeg .

Поля
estimated_price[]

Money

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

TollPass

List of toll passes around the world that we support.

Перечисления
TOLL_PASS_UNSPECIFIED Not used. If this value is used, then the request fails.
AU_ETOLL_TAG Sydney toll pass. See additional details at https://www.myetoll.com.au .
AU_EWAY_TAG Sydney toll pass. See additional details at https://www.tollpay.com.au .
AU_LINKT Australia-wide toll pass. See additional details at https://www.linkt.com.au/ .
AR_TELEPASE Argentina toll pass. See additional details at https://telepase.com.ar
BR_AUTO_EXPRESO Brazil toll pass. See additional details at https://www.autoexpreso.com
BR_CONECTCAR Brazil toll pass. See additional details at https://conectcar.com .
BR_MOVE_MAIS Brazil toll pass. See additional details at https://movemais.com .
BR_PASSA_RAPIDO Brazil toll pass. See additional details at https://pasorapido.gob.do/
BR_SEM_PARAR Brazil toll pass. See additional details at https://www.semparar.com.br .
BR_TAGGY Brazil toll pass. See additional details at https://taggy.com.br .
BR_VELOE Brazil toll pass. See additional details at https://veloe.com.br/site/onde-usar .
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Canada to United States border crossing.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Canada to United States border crossing.
CA_US_BLUE_WATER_EDGE_PASS Ontario, Canada to Michigan, United States border crossing.
CA_US_CONNEXION Ontario, Canada to Michigan, United States border crossing.
CA_US_NEXUS_CARD Canada to United States border crossing.
ID_E_TOLL Indonesia. E-card provided by multiple banks used to pay for tolls. All e-cards via banks are charged the same so only one enum value is needed. Eg - Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG Индия.
IN_LOCAL_HP_PLATE_EXEMPT India, HP state plate exemption.
JP_ETC Japan ETC. Electronic wireless system to collect tolls. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. New version of ETC with further discount and bidirectional communication between devices on vehicles and antennas on the road. https://www.go-etc.jp/etc2/index.html
MX_IAVE Mexico toll pass. https://iave.capufe.gob.mx/#/
MX_PASE Mexico https://www.pase.com.mx
MX_QUICKPASS Mexico https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Мексика
MX_TAG_TELEVIA Mexico toll pass company. One of many operating in Mexico City. See additional details at https://www.televia.com.mx .
MX_TELEVIA Mexico toll pass company. One of many operating in Mexico City. https://www.televia.com.mx
MX_VIAPASS Mexico toll pass. See additional details at https://www.viapass.com.mx/viapass/web_home.aspx .
US_AL_FREEDOM_PASS AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Indicates driver has any FasTrak pass in addition to the DMV issued Clean Air Vehicle (CAV) sticker. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, USA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, USA.
US_FL_EPASS FL, USA.
US_FL_GIBA_TOLL_PASS FL, USA.
US_FL_LEEWAY FL, USA.
US_FL_SUNPASS FL, USA.
US_FL_SUNPASS_PRO FL, USA.
US_IL_EZPASSIL IL, USA.
US_IL_IPASS IL, USA.
US_IN_EZPASSIN IN, USA.
US_KS_BESTPASS_HORIZON KS, USA.
US_KS_KTAG KS, USA.
US_KS_NATIONALPASS KS, USA.
US_KS_PREPASS_ELITEPASS KS, USA.
US_LA_GEAUXPASS LA, USA.
US_LA_TOLL_TAG LA, USA.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD

MI, USA. Deprecated as this pass type no longer exists.

US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, USA.
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, USA.
US_NJ_EZPASSNJ NJ, USA.
US_NY_EXPRESSPASS NY, USA.
US_NY_EZPASSNY NY, USA.
US_OH_EZPASSOH OH, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_AVI_TAG TX, USA.
US_TX_BANCPASS TX, USA.
US_TX_DEL_RIO_PASS TX, USA.
US_TX_EFAST_PASS TX, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, USA.
US_TX_EPTOLL TX, USA.
US_TX_EZ_CROSS TX, USA.
US_TX_EZTAG TX, USA.
US_TX_FUEGO_TAG TX, USA.
US_TX_LAREDO_TRADE_TAG TX, USA.
US_TX_PLUSPASS TX, USA.
US_TX_TOLLTAG TX, USA.
US_TX_TXTAG TX, USA.
US_TX_XPRESS_CARD TX, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, USA.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

TrafficModel

This field specifies one of the following assumptions to use when calculating travel time in traffic conditions, shown in the enums below. Depending on the enum chosen, the duration field of the TrafficModel response will vary. The value contains the predicted time to destination in traffic, based on historical averages. TrafficModel is only available for requests that have set RoutingPreference to TRAFFIC_AWARE_OPTIMAL and RouteTravelMode to DRIVE .

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

TransitAgency

A transit agency that operates a transit line.

Поля
name

string

The name of this transit agency.

phone_number

string

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

uri

string

The transit agency's URI.

TransitLine

Contains information about the transit line used in this step.

Поля
agencies[]

TransitAgency

The transit agency (or agencies) that operates this transit line.

name

string

The full name of this transit line, For example, "8 Avenue Local".

uri

string

the URI for this transit line as provided by the transit agency.

color

string

The color commonly used in signage for this line. Represented in hexadecimal.

icon_uri

string

The URI for the icon associated with this line.

name_short

string

The short name of this transit line. This name will normally be a line number, such as "M7" or "355".

text_color

string

The color commonly used in text on signage for this line. Represented in hexadecimal.

vehicle

TransitVehicle

The type of vehicle that operates on this transit line.

TransitPreferences

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

Поля
allowed_travel_modes[]

TransitTravelMode

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

routing_preference

TransitRoutingPreference

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

TransitRoutingPreference

Specifies routing preferences for transit routes.

Перечисления
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED No preference specified.
LESS_WALKING Indicates that the calculated route should prefer limited amounts of walking.
FEWER_TRANSFERS Indicates that the calculated route should prefer a limited number of transfers.

TransitTravelMode

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

Перечисления
TRANSIT_TRAVEL_MODE_UNSPECIFIED No transit travel mode specified.
BUS Travel by bus.
SUBWAY Travel by subway.
TRAIN Travel by train.
LIGHT_RAIL Travel by light rail or tram.
RAIL Travel by rail. This is equivalent to a combination of SUBWAY , TRAIN , and LIGHT_RAIL .

TransitStop

Information about a transit stop.

Поля
name

string

The name of the transit stop.

location

Location

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

TransitVehicle

Information about a vehicle used in transit routes.

Поля
name

LocalizedText

The name of this vehicle, capitalized.

type

TransitVehicleType

The type of vehicle used.

icon_uri

string

The URI for an icon associated with this vehicle type.

local_icon_uri

string

The URI for the icon associated with this vehicle type, based on the local transport signage.

TransitVehicleType

The type of vehicles for transit routes.

Перечисления
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Неиспользованный.
BUS Автобус.
CABLE_CAR A vehicle that operates on a cable, usually on the ground. Aerial cable cars may be of the type GONDOLA_LIFT .
COMMUTER_TRAIN Commuter rail.
FERRY Перевозить.
FUNICULAR A vehicle that is pulled up a steep incline by a cable. A Funicular typically consists of two cars, with each car acting as a counterweight for the other.
GONDOLA_LIFT An aerial cable car.
HEAVY_RAIL Heavy rail.
HIGH_SPEED_TRAIN Высокоскоростной поезд.
INTERCITY_BUS Междугородний автобус.
LONG_DISTANCE_TRAIN Long distance train.
METRO_RAIL Light rail transit.
MONORAIL Monorail.
OTHER All other vehicles.
RAIL Железная дорога.
SHARE_TAXI Share taxi is a kind of bus with the ability to drop off and pick up passengers anywhere on its route.
SUBWAY Underground light rail.
TRAM Above ground light rail.
TROLLEYBUS Trolleybus.

Единицы

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

Перечисления
UNITS_UNSPECIFIED Units of measure not specified. Defaults to the unit of measure inferred from the request.
METRIC Metric units of measure.
IMPERIAL Imperial (English) units of measure.

VehicleEmissionType

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

Перечисления
VEHICLE_EMISSION_TYPE_UNSPECIFIED No emission type specified. Default to GASOLINE .
GASOLINE Gasoline/petrol fueled vehicle.
ELECTRIC Electricity powered vehicle.
HYBRID Hybrid fuel (such as gasoline + electric) vehicle.
DIESEL Diesel fueled vehicle.

VehicleInfo

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

Поля
emission_type

VehicleEmissionType

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

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

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

Поля
via

bool

Marks this waypoint as a milestone rather a stopping point. For each non-via waypoint in the request, the response appends an entry to the legs array to provide the details for stopovers on that leg of the trip. Set this value to true when you want the route to pass through this waypoint without stopping over. Via waypoints don't cause an entry to be added to the legs array, but they do route the journey through the waypoint. You can only set this value on waypoints that are intermediates. The request fails if you set this field on terminal waypoints. If ComputeRoutesRequest.optimize_waypoint_order is set to true then this field cannot be set to true; otherwise, the request fails.

vehicle_stopover

bool

Indicates that the waypoint is meant for vehicles to stop at, where the intention is to either pickup or drop-off. When you set this value, the calculated route won't include non- via waypoints on roads that are unsuitable for pickup and drop-off. This option works only for DRIVE and TWO_WHEELER travel modes, and when the location_type is Location .

side_of_road

bool

Indicates that the location of this waypoint is meant to have a preference for the vehicle to stop at a particular side of road. When you set this value, the route will pass through the location so that the vehicle can stop at the side of road that the location is biased towards from the center of the road. This option works only for DRIVE and TWO_WHEELER RouteTravelMode .

Union field location_type . Different ways to represent a location. location_type can be only one of the following:
location

Location

A point specified using geographic coordinates, including an optional heading.

place_id

string

The POI Place ID associated with the waypoint.

address

string

Human readable address or a plus code. See https://plus.codes for details.

navigation_point_token

string

A token that identifies a NavigationPoint , obtained from the SearchDestinations method of the Geocoding API.