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

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

  • В любом случае количество элементов (отправление × место назначения) не должно превышать 625.
  • Количество элементов (отправные точки × пункты назначения) не должно превышать 100, если для параметра routing_preference установлено значение TRAFFIC_AWARE_OPTIMAL .
  • Количество путевых точек (отправление + пункт назначения), указанное как place_id , не должно превышать 50.
destinations[]

RouteMatrixDestination

Необходимый. Массив адресатов, определяющий столбцы матрицы ответов.

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

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

departure_time

Timestamp

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

language_code

string

Необязательный. Код языка BCP-47, например «en-US» или «sr-Latn». Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . Список поддерживаемых языков см. в разделе Языковая поддержка . Если вы не укажете это значение, язык отображения выводится из местоположения первого источника.

region_code

string

Необязательный. Код региона, указанный как двухсимвольное значение ccTLD («домен верхнего уровня»). Для получения дополнительной информации см. https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains .

extra_computations[]

ExtraComputation

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

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

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

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

ComputeRoutesRequest

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

Поля
origin

Waypoint

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

destination

Waypoint

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

intermediates[]

Waypoint

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

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

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

polyline_quality

PolylineQuality

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

polyline_encoding

PolylineEncoding

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

departure_time

Timestamp

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

compute_alternative_routes

bool

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

route_modifiers

RouteModifiers

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

language_code

string

Необязательный. Код языка BCP-47, например «en-US» или «sr-Latn». Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . Список поддерживаемых языков см. в разделе Языковая поддержка . Если вы не укажете это значение, язык интерфейса выводится из расположения запроса маршрута.

region_code

string

Необязательный. Код региона, указанный как двухсимвольное значение ccTLD («домен верхнего уровня»). Для получения дополнительной информации см. https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains .

units

Units

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

requested_reference_routes[]

ReferenceRoute

Необязательный. Указывает, какие эталонные маршруты следует рассчитать как часть запроса в дополнение к маршруту по умолчанию. Эталонный маршрут — это маршрут с целью расчета маршрута, отличной от маршрута по умолчанию. Например, при расчете эталонного маршрута FUEL_EFFICIENT учитываются различные параметры, которые позволяют создать оптимальный маршрут с эффективным расходом топлива.

extra_computations[]

ExtraComputation

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

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

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

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

СсылкаМаршрут

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

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

ComputeRoutesResponse

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

Поля
routes[]

Route

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

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

FallbackInfo

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

Поля
routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

ОткатПричина

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

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

FallbackRoutingMode

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

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

GeocodedWaypoint

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

Поля
geocoder_status

Status

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

type[]

string

Тип(ы) результата в виде нуля или более тегов типа. Поддерживаемые типы: https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types .

partial_match

bool

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

place_id

string

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

intermediate_waypoint_request_index

int32

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

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

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

Поля
origin

GeocodedWaypoint

Исходная геокодированная путевая точка.

destination

GeocodedWaypoint

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

intermediates[]

GeocodedWaypoint

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

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

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

Поля
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 Поверните направо на кольцевой развязке.

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

Поля
maneuver

Maneuver

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

instructions

string

Инструкции по прохождению этого шага.

Полилиния

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

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

string

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

geo_json_linestring

Struct

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

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

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

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

PolylineQuality

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

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

Маршрут

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

Поля
route_labels[]

RouteLabel

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

legs[]

RouteLeg

Набор участков (сегментов пути между путевыми точками), составляющих маршрут. Каждый этап соответствует поездке между двумя via Waypoints . Например, маршрут без промежуточных путевых точек имеет только один этап. Маршрут, включающий одну via путевую точку, не являющуюся промежуточной, имеет два этапа. Маршрут, который включает в себя один маршрут via промежуточную путевую точку, имеет один этап. Порядок этапов соответствует порядку путевых точек от origin к intermediates и к destination .

distance_meters

int32

Протяженность маршрута, в метрах.

duration

Duration

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

static_duration

Duration

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

polyline

Polyline

Общая полилиния маршрута. Эта полилиния будет объединенной полилинией всех legs .

description

string

Описание маршрута.

warnings[]

string

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

viewport

Viewport

Ограничивающая рамка области просмотра полилинии.

travel_advisory

RouteTravelAdvisory

Дополнительная информация о маршруте.

route_token

string

Безопасный для Интернета токен маршрута в кодировке base64, который можно передать в NavigationSDK, что позволяет пакету Navigation SDK реконструировать маршрут во время навигации и в случае перемаршрутизации учитывать исходное намерение при вызове Routes ComputeRoutes. Клиенты должны рассматривать этот токен как непрозрачный большой двоичный объект. ПРИМЕЧАНИЕ. Route.route_token доступен только для запросов, в которых для ComputeRoutesRequest.routing_preference задано значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL . Route.route_token также не поддерживается для запросов, содержащих путевые точки Via.

Метка маршрута

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

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

МаршрутЭтап

Инкапсулирует сегмент между via путевыми точками.

Поля
distance_meters

int32

Протяженность участка маршрута, в метрах.

duration

Duration

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

static_duration

Duration

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

polyline

Polyline

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

start_location

Location

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

end_location

Location

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

steps[]

RouteLegStep

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

travel_advisory

RouteLegTravelAdvisory

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

МаршрутLegStep

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

Поля
distance_meters

int32

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

static_duration

Duration

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

polyline

Polyline

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

start_location

Location

Место начала этого шага.

end_location

Location

Место окончания этого шага.

navigation_instruction

NavigationInstruction

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

travel_advisory

RouteLegStepTravelAdvisory

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

RouteLegStepTravelAdvisory

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

Поля
speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

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

Поля
toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

Интервалы скорочтения с подробным описанием плотности трафика. Применимо в случае настроек маршрутизации TRAFFIC_AWARE и TRAFFIC_AWARE_OPTIMAL . Интервалы охватывают всю полилинию RouteLg без перекрытия. Начальная точка указанного интервала совпадает с конечной точкой предыдущего интервала.

Пример:

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

RouteMatrixDestination

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

Поля
waypoint

Waypoint

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

RouteMatrixElement

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

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

origin_index

int32

Отсчитываемый от нуля индекс источника в запросе.

destination_index

int32

Отсчитываемый от нуля индекс адресата в запросе.

RouteMatrixElementCondition

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

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

RouteMatrixOrigin

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

Поля
waypoint

Waypoint

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

route_modifiers

RouteModifiers

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

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

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

Поля
avoid_tolls

bool

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

avoid_highways

bool

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

avoid_ferries

bool

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

avoid_indoor

bool

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

vehicle_info

VehicleInfo

Указывает информацию о транспортном средстве.

toll_passes[]

TollPass

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

RouteTravelAdvisory

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

Поля
toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

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

Пример:

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

int64

Прогноз расхода топлива в микролитрах.

RouteTravelMode

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

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

RoutingPreference

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

перечисления
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 Обнаружена пробка.

TollInfo

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

Поля
estimated_price[]

Money

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

проездной

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

перечисления
TOLL_PASS_UNSPECIFIED Не используется. Если это значение используется, то запрос завершается ошибкой.
AU_ETOLL_TAG Плата за проезд в Сиднее. Дополнительную информацию см. на https://www.myetoll.com.au .
AU_EWAY_TAG Плата за проезд в Сиднее. Дополнительную информацию см. на https://www.tollpay.com.au .
AU_LINKT Плата за проезд по всей Австралии. Дополнительную информацию см. на https://www.linkt.com.au/ .
AR_TELEPASE Плата за проезд в Аргентине. Дополнительную информацию см. на https://telepase.com.ar
BR_AUTO_EXPRESO Плата за проезд в Бразилии. Дополнительную информацию см. на https://www.autoexpreso.com
BR_CONECTCAR Плата за проезд в Бразилии. Дополнительную информацию см. на https://conectcar.com .
BR_MOVE_MAIS Плата за проезд в Бразилии. Дополнительную информацию см. на https://movemais.com .
BR_PASSA_RAPIDO Плата за проезд в Бразилии. Дополнительную информацию см. на https://pasorapido.gob.do/
BR_SEM_PARAR Плата за проезд в Бразилии. Дополнительную информацию см. на https://www.semparar.com.br .
BR_TAGGY Плата за проезд в Бразилии. Дополнительную информацию см. на https://taggy.com.br .
BR_VELOE Плата за проезд в Бразилии. Дополнительную информацию см. на странице https://veloe.com.br/site/onde-usar .
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Канадско-американский пограничный переход.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Канадско-американский пограничный переход.
CA_US_BLUE_WATER_EDGE_PASS Онтарио, Канада, в Мичиган, пограничный переход США.
CA_US_CONNEXION Онтарио, Канада, в Мичиган, пограничный переход США.
CA_US_NEXUS_CARD Канадско-американский пограничный переход.
ID_E_TOLL Индонезия. Электронная карта, предоставленная несколькими банками, использовалась для оплаты дорожных сборов. Все электронные карты через банки оплачиваются одинаково, поэтому требуется только одно значение перечисления. Например – Bank Mandiri https://www.bankmandiri.co.id/e-money – BCA https://www.bca.co.id/flazz – BNI https://www.bni.co.id/id- id/ebanking/tapcash
IN_FASTAG Индия.
IN_LOCAL_HP_PLATE_EXEMPT Индия, освобождение от государственного номерного знака HP.
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 в дополнение к выданной DMV наклейке Clean Air Vehicle (CAV). https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL КО, США.
US_CO_GO_PASS КО, США.
US_DE_EZPASSDE Делавэр, США.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Флорида, США.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Флорида, США.
US_FL_EPASS Флорида, США.
US_FL_GIBA_TOLL_PASS Флорида, США.
US_FL_LEEWAY Флорида, США.
US_FL_SUNPASS Флорида, США.
US_FL_SUNPASS_PRO Флорида, США.
US_IL_EZPASSIL Иллинойс, США.
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_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG Мичиган, США.
US_MI_IQ_PROX_CARD Мичиган, США.
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_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_LAREDO_TRADE_TAG Техас, США.
US_TX_PLUSPASS Техас, США.
US_TX_TOLLTAG Техас, США.
US_TX_TXTAG Техас, США.
US_TX_XPRESS_CARD Техас, США.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD Юта, США.
US_VA_EZPASSVA Вирджиния, США.
US_WA_BREEZEBY Вашингтон, США.
US_WA_GOOD_TO_GO Вашингтон, США.
US_WV_EZPASSWV Западная Вирджиния, США.
US_WV_MEMORIAL_BRIDGE_TICKETS Западная Вирджиния, США.
US_WV_NEWELL_TOLL_BRIDGE_TICKET Западная Вирджиния, США.

Единицы

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

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

VehicleEmissionType

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

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

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

Инкапсулирует информацию о транспортном средстве, например, последний символ номерного знака.

Поля
emission_type

VehicleEmissionType

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

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

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

Поля
via

bool

Отмечает эту путевую точку как веху, а не точку остановки. Для каждой не промежуточной путевой точки в запросе ответ добавляет запись к массиву legs , чтобы предоставить подробную информацию о промежуточных остановках на этом этапе поездки. Установите это значение в true, если вы хотите, чтобы маршрут проходил через эту путевую точку без остановок. Через путевые точки запись не добавляется в массив legs , но они направляют путешествие через путевую точку. Вы можете установить это значение только для путевых точек, которые являются промежуточными. 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.