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_modeDRIVE или 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 , которое содержит прогнозируемое время в пробках на основе исторических средних значений. TrafficModel доступен только для запросов, в которых для RoutingPreference задано значение TRAFFIC_AWARE_OPTIMAL , а для RouteTravelMode — значение DRIVE . По умолчанию используется значение BEST_GUESS , если запрашивается трафик, а TrafficModel не указан.

transit_preferences

TransitPreferences

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

ExtraComputation

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

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

ComputeRoutesRequest

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

Поля
origin

Waypoint

Обязательно. Исходная точка маршрута.

destination

Waypoint

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

intermediates[]

Waypoint

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

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

Необязательный параметр. Указывает способ вычисления маршрута. Сервер пытается использовать выбранный параметр маршрутизации для вычисления маршрута. Если параметр маршрутизации приводит к ошибке или слишком большой задержке, возвращается ошибка. Этот параметр можно указать только в том случае, если параметр travel_modeDRIVE или 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

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

transit_preferences

TransitPreferences

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

ExtraComputation

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

Перечисления
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 .

GeocodedWaypoint

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

Поля
geocoder_status

Status

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

type[]

string

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

partial_match

bool

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

place_id

string

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

intermediate_waypoint_request_index

int32

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

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

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

Поля
origin

GeocodedWaypoint

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

destination

GeocodedWaypoint

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

intermediates[]

GeocodedWaypoint

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

LocalizedTime

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

Поля
time

LocalizedText

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

time_zone

string

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

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

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

Поля
lat_lng

LatLng

Географические координаты точки маршрута.

heading

Int32Value

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

Маневр

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

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

Инкапсулирует навигационные инструкции для 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 промежуточными точками), имеет один этап. Порядок этапов соответствует порядку intermediates точек от origin до 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 Более короткий маршрут. Это экспериментальная функция.

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 . Это поле заполняется только для маршрутов TRANSIT.

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

RouteLegStep

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

Поля
distance_meters

int32

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

static_duration

Duration

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

polyline

Polyline

Полилиния, связанная с этим шагом.

start_location

Location

Начальная точка этого шага.

end_location

Location

Конечное местоположение этого шага.

navigation_instruction

NavigationInstruction

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

travel_advisory

RouteLegStepTravelAdvisory

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

localized_values

RouteLegStepLocalizedValues

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

transit_details

RouteLegStepTransitDetails

Подробная информация, касающаяся этого шага, если вид передвижения — TRANSIT .

travel_mode

RouteTravelMode

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

RouteLegStepLocalizedValues

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

Поля
distance

LocalizedText

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

static_duration

LocalizedText

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

RouteLegStepTransitDetails

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

Поля
stop_details

TransitStopDetails

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

localized_values

TransitDetailsLocalizedValues

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

headsign

string

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

headway

Duration

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

transit_line

TransitLine

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

stop_count

int32

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

stop_count

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

trip_short_text

string

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

TransitDetailsLocalizedValues

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

Поля
arrival_time

LocalizedTime

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

departure_time

LocalizedTime

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

TransitStopDetails

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

Поля
arrival_stop

TransitStop

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

arrival_time

Timestamp

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

departure_stop

TransitStop

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

departure_time

Timestamp

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

RouteLegStepTravelAdvisory

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

Поля
speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

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

Поля
toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

Интервалы измерения скорости, указывающие на плотность движения. Это поле заполняется только для запросов, если запрос имеет значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference , а TRAFFIC_ON_POLYLINE включен в ComputeRoutesRequest.extra_computations . Интервалы охватывают всю полилинию RouteLeg без перекрытия. Начальная точка указанного интервала совпадает с конечной точкой предыдущего интервала.

Пример:

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

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

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

Поля
waypoint

Waypoint

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

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

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

Поля
status

Status

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

condition

RouteMatrixElementCondition

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

distance_meters

int32

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

duration

Duration

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

static_duration

Duration

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

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

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

localized_values

LocalizedValues

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

origin_index

int32

Индекс источника запроса, начинающийся с нуля.

destination_index

int32

Индекс назначения в запросе, начинающийся с нуля.

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

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

Поля
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

transit_fare

LocalizedText

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

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

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

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

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

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

Поля
waypoint

Waypoint

Обязательно. Исходная путевая точка

route_modifiers

RouteModifiers

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

RouteModifiers

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

Поля
avoid_tolls

bool

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

avoid_highways

bool

Если установлено значение true, избегает шоссе, где это возможно, отдавая предпочтение маршрутам, не содержащим шоссе. Применяется только к DRIVE и TWO_WHEELER RouteTravelMode .

avoid_ferries

bool

Если установлено значение true, паромы избегаются, где это возможно, отдавая предпочтение маршрутам, не содержащим паромов. Применяется только к DRIVE и TWO_WHEELER RouteTravelMode .

avoid_indoor

bool

Если установлено значение true, навигация в помещении избегается, где это возможно, отдавая предпочтение маршрутам, не содержащим навигацию в помещении. Применяется только к WALK RouteTravelMode .

vehicle_info

VehicleInfo

Указывает информацию об автомобиле.

toll_passes[]

TollPass

Инкапсулирует информацию о платных проездных. Если предусмотрены проездные, API пытается вернуть стоимость проезда. Если проездные билеты не предоставлены, API рассматривает проездной билет как неизвестный и пытается вернуть цену наличными. Применяется только к DRIVE и TWO_WHEELER RouteTravelMode .

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

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

Поля
toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

Интервалы измерения скорости, указывающие на плотность движения. Это поле заполняется только для запросов, если запрос имеет значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference , а TRAFFIC_ON_POLYLINE включен в ComputeRoutesRequest.extra_computations . Интервалы охватывают всю полилинию маршрута без перекрытия. Начальная точка указанного интервала совпадает с конечной точкой предыдущего интервала.

Пример:

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

int64

Прогнозируемый расход топлива в микролитрах. Это поле заполняется только в том случае, если FUEL_CONSUMPTION включен в ComputeRoutesRequest.extra_computations запроса.

route_restrictions_partially_ignored

bool

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

transit_fare

Money

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

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

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

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

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

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

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

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

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

Поля
start_polyline_point_index

int32

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

end_polyline_point_index

int32

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

Поле объединения speed_type . Тип скорости в этом интервале. speed_type может быть только одним из следующих:
speed

Speed

Скорость движения в этом интервале.

Скорость

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

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

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

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

Поля
estimated_price[]

Money

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

TollPass

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

Перечисления
TOLL_PASS_UNSPECIFIED Не используется. Если это значение используется, запрос завершается неудачей.
AU_ETOLL_TAG Платный перевал в Сиднее. Дополнительную информацию см. на https://www.myetoll.com.au .
AU_EWAY_TAG Платный перевал в Сиднее. Дополнительную информацию см. на https://www.tollpay.com.au .
AU_LINKT Платный проезд по всей Австралии. Дополнительную информацию см. на https://www.linkt.com.au/ .
AR_TELEPASE Платный перевал в Аргентине. Дополнительную информацию см. на https://telepase.com.ar.
BR_AUTO_EXPRESO Платный перевал в Бразилии. Дополнительную информацию см. на https://www.autoexpreso.com.
BR_CONECTCAR Платный перевал в Бразилии. Дополнительную информацию см. на https://conectcar.com .
BR_MOVE_MAIS Платный перевал в Бразилии. Дополнительную информацию см. на https://movemais.com .
BR_PASSA_RAPIDO Платный перевал в Бразилии. Дополнительную информацию см. на https://pasorapido.gob.do/.
BR_SEM_PARAR Платный перевал в Бразилии. Дополнительную информацию см. на https://www.semparar.com.br .
BR_TAGGY Платный перевал в Бразилии. Дополнительную информацию см. на https://taggy.com.br .
BR_VELOE Платный перевал в Бразилии. Дополнительную информацию см. на https://veloe.com.br/site/onde-usar .
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Пограничный переход между Канадой и США.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Пограничный переход между Канадой и США.
CA_US_BLUE_WATER_EDGE_PASS Пограничный переход Онтарио, Канада, Мичиган, США.
CA_US_CONNEXION Пограничный переход Онтарио, Канада, Мичиган, США.
CA_US_NEXUS_CARD Пограничный переход между Канадой и США.
ID_E_TOLL Индонезия. Электронная карта, предоставленная несколькими банками, используемая для оплаты дорожных сборов. Все электронные карты через банки взимаются одинаково, поэтому требуется только одно перечисляемое значение. Например – Банк Мандири 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.
JP_ETC Япония и т. д. Электронная беспроводная система для взимания платы за проезд. https://www.go-etc.jp/
JP_ETC2 Япония ETC2.0. Новая версия ETC с дополнительной скидкой и двунаправленной связью между устройствами на транспортных средствах и антеннами на дороге. https://www.go-etc.jp/etc2/index.html
MX_IAVE Платный перевал в Мексике. https://iave.capufe.gob.mx/#/
MX_PASE Мексика https://www.pase.com.mx
MX_QUICKPASS Мексика https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Мексика
MX_TAG_TELEVIA Компания по взиманию платы за проезд в Мексике. Один из многих, работающих в Мехико. Дополнительную информацию см. на https://www.televia.com.mx .
MX_TELEVIA Компания по взиманию платы за проезд в Мексике. Один из многих, работающих в Мехико. https://www.televia.com.mx
MX_VIAPASS Платный перевал в Мексике. Дополнительную информацию см. на странице https://www.viapass.com.mx/viapass/web_home.aspx .
US_AL_FREEDOM_PASS АЛ, США.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS АК, США.
US_CA_FASTRAK Калифорния, США.
US_CA_FASTRAK_CAV_STICKER Указывает, что у водителя есть пропуск FasTrak в дополнение к наклейке транспортного средства с чистым воздухом (CAV), выданной DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL Колорадо, США.
US_CO_GO_PASS Колорадо, США.
US_DE_EZPASSDE Делавэр, США.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Флорида, США.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Флорида, США.
US_FL_EPASS Флорида, США.
US_FL_GIBA_TOLL_PASS Флорида, США.
US_FL_LEEWAY Флорида, США.
US_FL_SUNPASS Флорида, США.
US_FL_SUNPASS_PRO Флорида, США.
US_IL_EZPASSIL Иллинойс, США.
US_IL_IPASS Иллинойс, США.
US_IN_EZPASSIN ИН, США.
US_KS_BESTPASS_HORIZON КС, США.
US_KS_KTAG КС, США.
US_KS_NATIONALPASS КС, США.
US_KS_PREPASS_ELITEPASS КС, США.
US_LA_GEAUXPASS Лос-Анджелес, США.
US_LA_TOLL_TAG Лос-Анджелес, США.
US_MA_EZPASSMA Массачусетс, США.
US_MD_EZPASSMD Доктор медицины, США.
US_ME_EZPASSME Я, США.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD Мичиган, США.
US_MI_BCPASS Мичиган, США.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG Мичиган, США.
US_MI_IQ_PROX_CARD

Мичиган, США. Устарело, поскольку этот тип пропуска больше не существует.

US_MI_IQ_TAG Мичиган, США.
US_MI_MACKINAC_BRIDGE_MAC_PASS Мичиган, США.
US_MI_NEXPRESS_TOLL Мичиган, США.
US_MN_EZPASSMN Миннесота, США.
US_NC_EZPASSNC Северная Каролина, США.
US_NC_PEACH_PASS Северная Каролина, США.
US_NC_QUICK_PASS Северная Каролина, США.
US_NH_EZPASSNH Нью-Хэмпшир, США.
US_NJ_DOWNBEACH_EXPRESS_PASS Нью-Джерси, США.
US_NJ_EZPASSNJ Нью-Джерси, США.
US_NY_EXPRESSPASS Нью-Йорк, США.
US_NY_EZPASSNY Нью-Йорк, США.
US_OH_EZPASSOH О, США.
US_PA_EZPASSPA Пенсильвания, США.
US_RI_EZPASSRI Ри, США.
US_SC_PALPASS СК, США.
US_TX_AVI_TAG Техас, США.
US_TX_BANCPASS Техас, США.
US_TX_DEL_RIO_PASS Техас, США.
US_TX_EFAST_PASS Техас, США.
US_TX_EAGLE_PASS_EXPRESS_CARD Техас, США.
US_TX_EPTOLL Техас, США.
US_TX_EZ_CROSS Техас, США.
US_TX_EZTAG Техас, США.
US_TX_FUEGO_TAG Техас, США.
US_TX_LAREDO_TRADE_TAG Техас, США.
US_TX_PLUSPASS Техас, США.
US_TX_TOLLTAG Техас, США.
US_TX_TXTAG Техас, США.
US_TX_XPRESS_CARD Техас, США.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD ЮТ, США.
US_VA_EZPASSVA Вирджиния, США.
US_WA_BREEZEBY WA, США.
US_WA_GOOD_TO_GO WA, США.
US_WV_EZPASSWV Западная Вирджиния, США.
US_WV_MEMORIAL_BRIDGE_TICKETS Западная Вирджиния, США.
US_WV_MOV_PASS Западная Вирджиния, США
US_WV_NEWELL_TOLL_BRIDGE_TICKET Западная Вирджиния, США.

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

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

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

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

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

Поля
name

string

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

phone_number

string

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

uri

string

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

ТранзитЛайн

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

Поля
agencies[]

TransitAgency

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

name

string

Полное название этой транспортной линии, например, «8 Avenue Local».

uri

string

URI для этой транзитной линии, предоставленный транзитным агентством.

color

string

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

icon_uri

string

URI значка, связанного с этой строкой.

name_short

string

Краткое название этой транзитной линии. Обычно это имя представляет собой номер строки, например «M7» или «355».

text_color

string

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

vehicle

TransitVehicle

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

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

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

Поля
allowed_travel_modes[]

TransitTravelMode

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

routing_preference

TransitRoutingPreference

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

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

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

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

Транзитный режим путешествия

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

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

ТранзитСтоп

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

Поля
name

string

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

location

Location

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

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

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

Поля
name

LocalizedText

Название этого автомобиля, с большой буквы.

type

TransitVehicleType

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

icon_uri

string

URI для значка, связанного с этим типом транспортного средства.

local_icon_uri

string

URI для значка, связанного с этим типом транспортного средства, на основе знаков местного транспорта.

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

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

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

Единицы

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

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

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

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

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

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

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

Поля
emission_type

VehicleEmissionType

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

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

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

Поля
via

bool

Отмечает эту путевую точку как веху, а не как точку остановки. Для каждой путевой точки в запросе, не являющейся транзитным, ответ добавляет запись в массив legs , чтобы предоставить подробную информацию об остановках на этом этапе поездки. Установите для этого значения значение true, если вы хотите, чтобы маршрут проходил через эту точку без остановок. Через путевые точки не добавляется запись в массив legs , но они маршрутизируют путешествие через путевую точку. Вы можете установить это значение только для промежуточных точек маршрута. Запрос не будет выполнен, если вы установите это поле для путевых точек терминала. Если ComputeRoutesRequest.optimize_waypoint_order установлено значение true, то для этого поля нельзя установить значение true; в противном случае запрос не будет выполнен.

vehicle_stopover

bool

Указывает, что путевая точка предназначена для остановки транспортных средств с намерением либо посадить, либо высадить ее. Если вы установите это значение, расчетный маршрут не будет включать via точки на дорогах, которые непригодны для посадки и высадки. Эта опция работает только для режимов движения DRIVE и TWO_WHEELER , а также когда location_type равен Location .

side_of_road

bool

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

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

Location

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

place_id

string

Идентификатор места POI, связанный с путевой точкой.

address

string

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