Package google.maps.routing.v2

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

RouteMatrixOrigin

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

• Сумма количества отправителей + количества пунктов назначения, указанных в качестве place_id или address не должна превышать 50.
• В любом случае произведение количества отправлений × количество пунктов назначения не должно превышать 625.
• Произведение количества отправителей × количество пунктов назначения не должно превышать 100, если для параметра router_preference установлено значение TRAFFIC_AWARE_OPTIMAL .
• Произведение количества пунктов отправления × количество пунктов назначения не должно превышать 100, если для параметра travel_mode установлено значение TRANSIT .

RouteMatrixDestination

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

RouteTravelMode

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

RoutingPreference

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

Timestamp

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

Timestamp

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

string

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

string

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

Units

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

ExtraComputation

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

TrafficModel

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

TransitPreferences

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

Waypoint

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

Waypoint

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

Waypoint

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

RouteTravelMode

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

RoutingPreference

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

PolylineQuality

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

PolylineEncoding

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

Timestamp

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

Timestamp

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

bool

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

RouteModifiers

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

string

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

string

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

Units

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

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 будет пустым.

ReferenceRoute

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

ExtraComputation

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

TrafficModel

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

TransitPreferences

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

Route

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

FallbackInfo

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

GeocodingResults

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

FallbackRoutingMode

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

FallbackReason

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

Status

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

string

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

bool

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

string

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

int32

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

GeocodedWaypoint

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

GeocodedWaypoint

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

GeocodedWaypoint

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

LocalizedText

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

string

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

LatLng

Географические координаты путевой точки.

Int32Value

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

Maneuver

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

string

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

string

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

Struct

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

FlyoverInfo

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

NarrowRoadInfo

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

RoadFeatureState

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

PolylinePointIndex

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

RoadFeatureState

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

PolylinePointIndex

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

int32

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

int32

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

RouteLabel

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

RouteLeg

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

int32

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

Duration

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

Duration

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

Polyline

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

string

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

string

Массив предупреждений, отображаемых при отображении маршрута.

Viewport

Ограничивающая рамка полилинии видового экрана.

RouteTravelAdvisory

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

int32

Если вы установите optimize_waypoint_order значение true, это поле будет содержать оптимизированный порядок промежуточных путевых точек. В противном случае это поле пусто. Например, если вы введете Origin: LA; Промежуточные путевые точки: Даллас, Бангор, Феникс; Пункт назначения: Нью-Йорк; и оптимизированный порядок промежуточных точек — Феникс, Даллас, Бангор, тогда это поле содержит значения [2, 0, 1]. Индекс начинается с 0 для первой промежуточной точки, указанной во входных данных.

RouteLocalizedValues

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

string

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

ПРИМЕЧАНИЕ. Route.route_token доступен только для запросов, в которых для ComputeRoutesRequest.routing_preference установлено значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL . Route.route_token не поддерживается для запросов, содержащих промежуточные точки.

PolylineDetails

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

LocalizedText

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

LocalizedText

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

LocalizedText

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

LocalizedText

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

int32

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

Duration

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

Duration

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

Polyline

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

Location

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

Location

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

RouteLegStep

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

RouteLegTravelAdvisory

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

RouteLegLocalizedValues

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

StepsOverview

Обзорная информация о шагах в этом RouteLeg . Это поле заполняется только для ТРАНЗИТНЫХ маршрутов.

LocalizedText

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

LocalizedText

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

LocalizedText

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

MultiModalSegment

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

NavigationInstruction

NavigationInstruction для мультимодального сегмента.

RouteTravelMode

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

int32

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

int32

Соответствующий индекс RouteLegStep , который является концом мультимодального сегмента.

int32

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

Duration

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

Polyline

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

Location

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

Location

Конечная позиция этого шага.

NavigationInstruction

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

RouteLegStepTravelAdvisory

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

RouteLegStepLocalizedValues

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

RouteLegStepTransitDetails

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

RouteTravelMode

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

LocalizedText

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

LocalizedText

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

TransitStopDetails

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

TransitDetailsLocalizedValues

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

string

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

Duration

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

TransitLine

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

int32

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

stop_count

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

string

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

LocalizedTime

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

LocalizedTime

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

TransitStop

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

Timestamp

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

TransitStop

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

Timestamp

Ориентировочное время выхода на шаг.

SpeedReadingInterval

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

TollInfo

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

SpeedReadingInterval

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

Пример:

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

Waypoint

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

Status

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

RouteMatrixElementCondition

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

int32

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

Duration

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

Duration

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

RouteTravelAdvisory

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

FallbackInfo

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

LocalizedValues

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

int32

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

int32

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

LocalizedText

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

LocalizedText

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

LocalizedText

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

LocalizedText

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

Waypoint

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

RouteModifiers

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

bool

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

bool

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

bool

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

bool

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

VehicleInfo

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

TollPass

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

TollInfo

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

SpeedReadingInterval

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

Пример:

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

int64

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

bool

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

Money

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

int32

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

int32

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

Speed

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

Money

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

string

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

string

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

string

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

TransitAgency

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

string

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

string

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

string

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

string

URI для значка, связанной с этой линией.

string

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

string

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

TransitVehicle

Тип транспортного средства, который работает на этой транзитной линии.

TransitTravelMode

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

TransitRoutingPreference

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

string

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

Location

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

LocalizedText

Название этого автомобиля, капитализированное.

TransitVehicleType

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

string

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

string

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

VehicleEmissionType

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

bool

На этой путевой точке отмечается как веха, а не остановка. Для каждой не VIA Waypoint в запросе ответ добавляет запись в массив legs , чтобы предоставить подробности остановок на этой ноге поездки. Установите это значение True, когда вы хотите, чтобы маршрут прошел через эту путевую точку, не останавливаясь. С через путевые точки не приводят к добавлению входа в массив legs , но они направляют путешествие по дорожной точке. Вы можете установить это значение только на путевые точки, которые являются промежуточными. Запрос не удается, если вы установите это поле на пути к терминалу. Если ComputeRoutesRequest.optimize_waypoint_order установлен на TRUE, то это поле не может быть установлено на TRUE; В противном случае запрос не удается.

bool

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

bool

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

Location

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

string

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

string

Человеческий читаемый адрес или код плюс. См. Https://plus.codes для получения подробной информации.

RouteMatrixOrigin

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

• Сумма количества источников + количество направлений, указанных как place_id или address должна быть не больше 50.
• В любом случае произведение количества отправлений × количество пунктов назначения не должно превышать 625.
• Продукт количества источников × количество направлений должно быть не больше 100, если routing_preference установлен на TRAFFIC_AWARE_OPTIMAL .
• Продукт количества источников × количество направлений должно быть не больше 100, если Travel_Mode установлен на TRANSIT .

RouteMatrixDestination

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

RouteTravelMode

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

RoutingPreference

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

Timestamp

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

Timestamp

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

string

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

string

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

Units

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

ExtraComputation

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

TrafficModel

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

TransitPreferences

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

Waypoint

Необходимый. Происхождение путешественника.

Waypoint

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

Waypoint

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

RouteTravelMode

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

RoutingPreference

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

PolylineQuality

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

PolylineEncoding

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

Timestamp

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

Timestamp

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

bool

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

RouteModifiers

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

string

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

string

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

Units

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

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 будет пустой.

ReferenceRoute

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

ExtraComputation

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

TrafficModel

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

TransitPreferences

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

Route

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

FallbackInfo

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

GeocodingResults

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

FallbackRoutingMode

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

FallbackReason

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

Status

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

string

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

bool

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

string

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

int32

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

GeocodedWaypoint

Происхождение геокодированной путевой точки.

GeocodedWaypoint

Путешествие по геокодированию назначения.

GeocodedWaypoint

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

LocalizedText

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

string

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

LatLng

Географические координаты путевой точки.

Int32Value

Заголовок компаса, связанный с направлением потока трафика. Это значение указывает сторону дороги для получения и высадки. Значения заголовка могут быть от 0 до 360, где 0 указывает заголовок «Средства на север», 90 определяет заголовок «Считай» на восток и так далее. Вы можете использовать это поле только для DRIVE и TWO_WHEELER RouteTravelMode .

Maneuver

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

string

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

string

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

Struct

Определяет полилин, используя формат Linestring Geojson .

FlyoverInfo

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

NarrowRoadInfo

Узкие дорожные детали вдоль полилины.

RoadFeatureState

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

PolylinePointIndex

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

RoadFeatureState

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

PolylinePointIndex

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

int32

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

int32

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

RouteLabel

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

RouteLeg

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

int32

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

Duration

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

Duration

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

Polyline

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

string

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

string

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

Viewport

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

RouteTravelAdvisory

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

int32

Если вы установите optimize_waypoint_order true, это поле содержит оптимизированный упорядочение промежуточных путевых точек. В противном случае это поле пустое. Например, если вы даете вклад в происхождение: LA; Промежуточные путевые точки: Даллас, Бангор, Феникс; Назначение: Нью -Йорк; и оптимизированный промежуточный порядок путевой точки - Феникс, Даллас, Бангор, тогда это поле содержит значения [2, 0, 1]. Индекс начинается с 0 для первой промежуточной путевой точки, предоставленной на входе.

RouteLocalizedValues

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

string

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

Примечание: Route.route_token доступен только для запросов, которые имеют установку ComputeRoutesRequest.routing_preference на TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL . Route.route_token не поддерживается для запросов, которые имеют путевые точки.

PolylineDetails

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

LocalizedText

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

LocalizedText

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

LocalizedText

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

LocalizedText

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

int32

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

Duration

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

Duration

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

Polyline

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

Location

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

Location

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

RouteLegStep

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

RouteLegTravelAdvisory

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

RouteLegLocalizedValues

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

StepsOverview

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

LocalizedText

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

LocalizedText

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

LocalizedText

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

MultiModalSegment

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

NavigationInstruction

Навигационная инструкция для мультимодального сегмента.

RouteTravelMode

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

int32

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

int32

Соответствующий индекс RouteLegStep , который является конец мультимодального сегмента.

int32

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

Duration

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

Polyline

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

Location

Начало этого шага.

Location

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

NavigationInstruction

Навигационные инструкции.

RouteLegStepTravelAdvisory

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

RouteLegStepLocalizedValues

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

RouteLegStepTransitDetails

Детали, относящиеся к этому шагу, если режим путешествий TRANSIT .

RouteTravelMode

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

LocalizedText

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

LocalizedText

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

TransitStopDetails

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

TransitDetailsLocalizedValues

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

string

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

Duration

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

TransitLine

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

int32

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

stop_count

Возврат 3.

string

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

LocalizedTime

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

LocalizedTime

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

TransitStop

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

Timestamp

Расчетное время прибытия для шага.

TransitStop

Информация о остановке отъезда для шага.

Timestamp

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

SpeedReadingInterval

Примечание: это поле в настоящее время не заполнено.

TollInfo

Contains information about tolls on the specific RouteLeg . This field is only populated if we expect there are tolls on the RouteLeg . If this field is set but the estimated_price subfield is not populated, we expect that road contains tolls but we do not know an estimated price. If this field does not exist, then there is no toll on the RouteLeg .

SpeedReadingInterval

Speed reading intervals detailing traffic density. Applicable in case of TRAFFIC_AWARE and TRAFFIC_AWARE_OPTIMAL routing preferences. The intervals cover the entire polyline of the RouteLeg without overlap. The start point of a specified interval is the same as the end point of the preceding interval.

Пример:

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

Waypoint

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

Status

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

RouteMatrixElementCondition

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

int32

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

Duration

Время, необходимое для прохождения маршрута. If you set the routing_preference to TRAFFIC_UNAWARE , then this value is the same as static_duration . If you set the routing_preference to either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

Duration

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

RouteTravelAdvisory

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

FallbackInfo

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

LocalizedValues

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

int32

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

int32

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

LocalizedText

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

LocalizedText

Продолжительность представлена ​​в текстовой форме с учетом условий дорожного движения. Note: If traffic information was not requested, this value is the same value as static_duration.

LocalizedText

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

LocalizedText

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

Waypoint

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

RouteModifiers

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

bool

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

bool

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

bool

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

bool

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

VehicleInfo

Specifies the vehicle information.

TollPass

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

TollInfo

Contains information about tolls on the route. This field is only populated if tolls are expected on the route. If this field is set, but the estimatedPrice subfield is not populated, then the route contains tolls, but the estimated price is unknown. If this field is not set, then there are no tolls expected on the route.

SpeedReadingInterval

Speed reading intervals detailing traffic density. Applicable in case of TRAFFIC_AWARE and TRAFFIC_AWARE_OPTIMAL routing preferences. The intervals cover the entire polyline of the route without overlap. The start point of a specified interval is the same as the end point of the preceding interval.

Пример:

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

int64

The predicted fuel consumption in microliters.

bool

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

Money

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

int32

The starting index of this interval in the polyline.

int32

The ending index of this interval in the polyline.

Speed

Traffic speed in this interval.

Money

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

string

The name of this transit agency.

string

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

string

The transit agency's URI.

TransitAgency

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

string

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

string

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

string

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

string

The URI for the icon associated with this line.

string

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

string

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

TransitVehicle

The type of vehicle that operates on this transit line.

TransitTravelMode

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

TransitRoutingPreference

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

string

The name of the transit stop.

Location

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

LocalizedText

The name of this vehicle, capitalized.

TransitVehicleType

The type of vehicle used.

string

The URI for an icon associated with this vehicle type.

string

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

VehicleEmissionType

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

bool

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

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 .

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 .

Location

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

string

The POI Place ID associated with the waypoint.

string

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

RouteMatrixOrigin

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

• The sum of the number of origins + the number of destinations specified as either place_id or address must be no greater than 50.
• В любом случае произведение количества отправлений × количество пунктов назначения не должно превышать 625.
• The product of the number of origins × number of destinations must be no greater than 100 if routing_preference is set to TRAFFIC_AWARE_OPTIMAL .
• The product of the number of origins × number of destinations must be no greater than 100 if travel_mode is set to TRANSIT .

RouteMatrixDestination

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

RouteTravelMode

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

RoutingPreference

Необязательный. Указывает, как вычислить маршрут. Сервер пытается использовать выбранную настройку маршрутизации для расчета маршрута. Если предпочтения маршрутизации приводят к ошибке или слишком большой задержке, возвращается ошибка. You can specify this option only when the travel_mode is DRIVE or TWO_WHEELER , otherwise the request fails.

Timestamp

Необязательный. Время отправления. Если вы не установите это значение, то по умолчанию это значение будет соответствовать времени, когда вы сделали запрос. NOTE: You can only specify a departure_time in the past when RouteTravelMode is set to TRANSIT .

Timestamp

Необязательный. Время прибытия. ПРИМЕЧАНИЕ. Можно установить только в том случае, если для параметра RouteTravelMode установлено значение TRANSIT . You can specify either departure_time or arrival_time , but not both.

string

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

string

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

Units

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

ExtraComputation

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

TrafficModel

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

TransitPreferences

Необязательный. Указывает предпочтения, влияющие на маршрут, возвращаемый для TRANSIT маршрутов. NOTE: You can only specify a transit_preferences when RouteTravelMode is set to TRANSIT .

Waypoint

Необходимый. Origin waypoint.

Waypoint

Необходимый. Destination waypoint.

Waypoint

Необязательный. A set of waypoints along the route (excluding terminal points), for either stopping at or passing by. Up to 25 intermediate waypoints are supported.

RouteTravelMode

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

RoutingPreference

Необязательный. Указывает, как вычислить маршрут. Сервер пытается использовать выбранную настройку маршрутизации для расчета маршрута. If the routing preference results in an error or an extra long latency, then an error is returned. You can specify this option only when the travel_mode is DRIVE or TWO_WHEELER , otherwise the request fails.

PolylineQuality

Необязательный. Specifies your preference for the quality of the polyline.

PolylineEncoding

Необязательный. Specifies the preferred encoding for the polyline.

Timestamp

Необязательный. Время отправления. Если вы не установите это значение, то по умолчанию это значение будет соответствовать времени, когда вы сделали запрос. NOTE: You can only specify a departure_time in the past when RouteTravelMode is set to TRANSIT . Transit trips are available for up to 7 days in the past or 100 days in the future.

Timestamp

Необязательный. Время прибытия. ПРИМЕЧАНИЕ. Можно установить только в том случае, если для параметра RouteTravelMode установлено значение TRANSIT . You can specify either departure_time or arrival_time , but not both. Transit trips are available for up to 7 days in the past or 100 days in the future.

bool

Необязательный. Specifies whether to calculate alternate routes in addition to the route. No alternative routes are returned for requests that have intermediate waypoints.

RouteModifiers

Необязательный. A set of conditions to satisfy that affect the way routes are calculated.

string

Необязательный. Код языка BCP-47, например «en-US» или «sr-Latn». Дополнительные сведения см. в разделе Идентификатор локали Unicode . Список поддерживаемых языков см. в разделе «Поддержка языков». When you don't provide this value, the display language is inferred from the location of the route request.

string

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