- HTTP-запрос
- Тело запроса
- Тело ответа
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Маршрут
- RouteLabel
- RouteLeg
- Polyline
- RouteLegStep
- NavigationInstruction
- Maneuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Область просмотра
- RouteLocalizedValues
- PolylineDetails
- TunnelInfo
- RoadFeatureState
- PolylinePointIndex
- RestrictionInfo
- FlyoverInfo
- NarrowRoadInfo
- BridgeInfo
- SkywayInfo
- GeocodingResults
- GeocodedWaypoint
Возвращает основной маршрут и, при необходимости, альтернативные маршруты, учитывая набор конечных и промежуточных путевых точек.
Примечание. При использовании этого метода необходимо указать маску поля ответа в поле ввода. Маску поля ответа можно указать с помощью параметра URL $fields или fields либо заголовка HTTP/gRPC X-Goog-FieldMask (см. доступные параметры URL и заголовки). Значение представляет собой список путей к полям, разделенный запятыми. Подробную информацию о том, как создавать пути к полям, вы найдете в документации.
Например, в этом методе:
- Маска поля для всех доступных полей (для проверки вручную):
X-Goog-FieldMask: *. - Маска поля для продолжительности, расстояния и ломаной линии на уровне маршрута (пример рабочей конфигурации):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline.
Мы не рекомендуем использовать маску поля ответа с подстановочным знаком (*) или указывать маску поля на верхнем уровне (routes) по следующим причинам:
- Выбирая только нужные поля, вы помогаете нашему серверу экономить вычислительные циклы, что позволяет нам возвращать вам результат с меньшей задержкой.
- Чтобы обеспечить стабильную задержку, выбирайте только те поля, которые нужны для рабочей задачи. В будущем мы можем добавить дополнительные поля ответов, для которых может потребоваться больше времени на вычисления. Если вы выберете все поля или все поля на верхнем уровне, то можете столкнуться со снижением производительности, поскольку любое новое поле, которое мы добавим, будет автоматически включено в ответ.
- Выбирая только нужные поля, вы уменьшаете размер ответа и повышаете пропускную способность сети.
HTTP-запрос
POST https://routes.googleapis.com/directions/v2:computeRoutes
URL имеет синтаксис gRPC Transcoding.
Тело запроса
Ниже приведена структура данных в теле запроса.
| JSON-представление |
|---|
{ "origin": { object ( |
| Поля | |
|---|---|
origin |
Обязательно. Начальная путевая точка. |
destination |
Обязательно. Путевая точка назначения. |
intermediates[] |
Необязательное поле. Набор путевых точек на маршруте (кроме конечных), в которых нужно остановиться или которые нужно проехать. Поддерживается до 25 промежуточных путевых точек. |
travelMode |
Необязательное поле. Указывает способ передвижения. |
routingPreference |
Необязательное поле. Указывает, как рассчитать маршрут. Сервер пытается использовать выбранные настройки маршрутизации для расчета маршрута. Если предпочтительный маршрут приводит к ошибке или слишком большой задержке, возвращается ошибка. Этот параметр можно указать, только если для |
polylineQuality |
Необязательное поле. Указывает предпочтительное качество ломаной линии. |
polylineEncoding |
Необязательное поле. Указывает предпочтительную кодировку для ломаной линии. |
departureTime |
Необязательное поле. Время отправления. Если вы не зададите значение, по умолчанию будет использоваться время, когда вы сделали запрос. Примечание. Вы можете указать Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
arrivalTime |
Необязательное поле. Время прибытия. Примечание. Это поле игнорируется, если в запросах указано значение Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
computeAlternativeRoutes |
Необязательное поле. Указывает, нужно ли рассчитывать альтернативные маршруты в дополнение к основному. Для запросов с промежуточными путевыми точками альтернативные маршруты не возвращаются. |
routeModifiers |
Необязательное поле. Набор условий, которые необходимо выполнить и которые влияют на расчет маршрутов. |
languageCode |
Необязательное поле. Код языка по стандарту BCP-47, например "ru-RU" или "sr-Latn". Подробнее об идентификаторах региональных настроек Unicode… Список поддерживаемых языков приведен в разделе Поддержка языков. Если вы не укажете это значение, язык интерфейса будет определяться на основе местоположения запроса маршрута. |
regionCode |
Необязательное поле. Код региона, указываемый как двухсимвольное значение национального домена верхнего уровня (ccTLD). Подробнее о национальных доменах верхнего уровня… |
units |
Необязательное поле. Указывает единицы измерения для полей отображения. К таким полям относится поле |
optimizeWaypointOrder |
Необязательное поле. Если установлено значение true, сервис пытается минимизировать общую стоимость маршрута, изменяя порядок указанных промежуточных путевых точек. Запрос не будет выполнен, если хотя бы одна из промежуточных путевых точек является точкой |
requestedReferenceRoutes[] |
Необязательное поле. Указывает, какие контрольные маршруты нужно рассчитать в рамках запроса в дополнение к маршруту по умолчанию. Опорный маршрут – это маршрут, цель расчета которого отличается от цели расчета маршрута по умолчанию. Например, при расчете маршрута |
extraComputations[] |
Необязательное поле. Список дополнительных вычислений, которые могут использоваться для выполнения запроса. Примечание. В результате этих дополнительных вычислений в ответе могут появиться дополнительные поля. Эти дополнительные поля также должны быть указаны в маске поля, чтобы они возвращались в ответе. |
trafficModel |
Необязательное поле. Определяет выбор модели расчета в зависимости от загруженности дорог. Этот параметр влияет на возвращаемое значение поля длительности в |
transitPreferences |
Необязательное поле. Задает предпочтения, которые влияют на маршрут, возвращаемый для маршрутов |
Тело ответа
v2.computeRoutes ответное сообщение.
Ниже приведена структура данных в ответе, полученном на запрос.
| JSON-представление |
|---|
{ "routes": [ { object ( |
| Поля | |
|---|---|
routes[] |
Содержит массив рассчитанных маршрутов (до трех), если вы указали |
fallbackInfo |
В некоторых случаях, когда сервер не может рассчитать результаты маршрута со всеми входными предпочтениями, он может вернуться к использованию другого способа расчета. Если используется резервный режим, это поле содержит подробную информацию о резервном ответе. В противном случае это поле не задано. |
geocodingResults |
Содержит информацию об ответе геокодирования для путевых точек, указанных в виде адресов. |
PolylineQuality
Набор значений, определяющих качество ломаной линии.
| Перечисления | |
|---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Не указано предпочтительное качество ломаной линии. Значение по умолчанию – OVERVIEW. |
HIGH_QUALITY |
Указывает ломаную линию высокого качества, которая состоит из большего количества точек, чем OVERVIEW, за счет увеличенного размера ответа. Используйте это значение, если вам нужна более высокая точность. |
OVERVIEW |
Задает обзорную ломаную линию, состоящую из небольшого количества точек. Используйте это значение при отображении обзора маршрута. При использовании этого варианта задержка запроса ниже, чем при использовании варианта HIGH_QUALITY. |
PolylineEncoding
Указывает предпочтительный тип возвращаемой ломаной линии.
| Перечисления | |
|---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Тип ломаной линии не указан. Значение по умолчанию – ENCODED_POLYLINE. |
ENCODED_POLYLINE |
Задает ломаную линию, закодированную с помощью алгоритма кодирования ломаной линии. |
GEO_JSON_LINESTRING |
Задает ломаную линию в формате GeoJSON LineString. |
ReferenceRoute
Поддерживаемый эталонный маршрут в ComputeRoutesRequest.
| Перечисления | |
|---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Не используется. Запросы, содержащие это значение, не выполняются. |
FUEL_EFFICIENT |
Маршрут с минимальным расходом топлива. |
SHORTER_DISTANCE |
Маршрут с меньшим расстоянием. Это экспериментальная функция. Для запросов Для запросов Эта функция несовместима с другими способами передвижения, промежуточными путевыми точками и |
ExtraComputation
Дополнительные вычисления, которые нужно выполнить при обработке запроса. В будущем могут быть добавлены дополнительные значения.
| Перечисления | |
|---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Не используется. Запросы, содержащие это значение, не будут выполняться. |
TOLLS |
Информация о платных дорогах на маршрутах. |
FUEL_CONSUMPTION |
Расчетный расход топлива на маршруте. |
TRAFFIC_ON_POLYLINE |
Ломаные линии маршрутов с учетом загруженности дорог. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstruction в виде форматированной текстовой строки HTML. Этот текст должен отображаться "как есть", без дополнительной программной обработки. Не анализируйте его программно. |
FLYOVER_INFO_ON_POLYLINE |
Информация об эстакадах на маршрутах. Чтобы получить эту информацию, необходимо указать маску поля routes.polyline_details.flyover_info. В настоящее время эти данные будут заполняться только для определенных агломераций в Индии. Это экспериментальная функция, и SKU/плата могут измениться. |
NARROW_ROAD_INFO_ON_POLYLINE |
Информация об узких дорогах на маршрутах. Чтобы получить эту информацию, необходимо указать маску поля routes.polyline_details.narrow_road_info. В настоящее время эти данные будут заполняться только для определенных агломераций в Индии. Это экспериментальная функция, и SKU/плата могут измениться. |
TUNNEL_INFO_ON_POLYLINE |
Информация о тоннелях на маршрутах. Чтобы получить эту информацию, необходимо указать маску поля routes.polyline_details.tunnel_info. |
BRIDGE_INFO_ON_POLYLINE |
Информация о мостах на маршрутах. Чтобы получить эту информацию, необходимо указать маску поля routes.polyline_details.bridge_info. |
SKYWAY_INFO_ON_POLYLINE |
Информация о надземных переходах на маршрутах. Чтобы получить эту информацию, необходимо указать маску поля routes.polyline_details.skyway_info. |
Маршрут
Содержит маршрут, состоящий из серии соединенных сегментов дороги, которые соединяют начальную, конечную и промежуточные путевые точки.
| JSON-представление |
|---|
{ "routeLabels": [ enum ( |
| Поля | |
|---|---|
routeLabels[] |
Ярлыки для |
legs[] |
Набор этапов (отрезков пути между путевыми точками), из которых состоит маршрут. Каждый этап соответствует поездке между двумя |
distanceMeters |
Расстояние маршрута в метрах. |
duration |
Время, необходимое для прохождения маршрута. Если для свойства Если для параметра
Во всех остальных случаях используются скорости легковых автомобилей, даже если в Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву |
staticDuration |
Продолжительность поездки по маршруту без учета загруженности дорог. Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву |
polyline |
Ломаная линия всего маршрута. Эта ломаная линия представляет собой комбинацию всех линий |
description |
Описание маршрута. |
warnings[] |
Массив предупреждений, которые необходимо показать вместе с этим маршрутом. |
viewport |
Граничная рамка области просмотра ломаной линии. |
travelAdvisory |
Дополнительная информация о маршруте. |
optimizedIntermediateWaypointIndex[] |
Если для параметра |
localizedValues |
Текстовые представления свойств |
routeToken |
Непрозрачный токен, который можно передать в Navigation SDK, чтобы восстановить маршрут во время навигации и, в случае изменения маршрута, сохранить исходное намерение при создании маршрута. Этот токен следует рассматривать как непрозрачный двоичный объект. Не сравнивайте его значение в разных запросах, так как оно может меняться, даже если сервис возвращает один и тот же маршрут.
|
polylineDetails |
Содержит информацию о деталях вдоль ломаной линии. |
RouteLabel
Ярлыки для , которые помогают определить конкретные свойства маршрута для сравнения с другими.Route
| Перечисления | |
|---|---|
ROUTE_LABEL_UNSPECIFIED |
По умолчанию не используется. |
DEFAULT_ROUTE |
"Лучший" маршрут, возвращаемый по умолчанию при расчете маршрута. |
DEFAULT_ROUTE_ALTERNATE |
Альтернатива маршруту по умолчанию. Такие маршруты будут возвращаться, если указан параметр . |
FUEL_EFFICIENT |
Маршрут с минимальным расходом топлива. Маршруты с этой меткой оптимизированы по экологическим параметрам, например по расходу топлива. |
SHORTER_DISTANCE |
Маршрут с меньшим расстоянием. Это экспериментальная функция. |
RouteLeg
Содержит сегмент между путевыми точками, не относящимися к via.
| JSON-представление |
|---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
| Поля | |
|---|---|
distanceMeters |
Расстояние этапа маршрута в метрах. |
duration |
Время, необходимое для прохождения участка. Если для Если для параметра
Во всех остальных случаях используются скорости легковых автомобилей, даже если в Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву |
staticDuration |
Продолжительность поездки по участку, рассчитанная без учета загруженности дорог. Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву |
polyline |
Общая ломаная линия для этого этапа, которая включает ломаную линию каждого |
startLocation |
Начальная точка отрезка. Это местоположение может отличаться от указанного в поле |
endLocation |
Конечная точка этого этапа. Это местоположение может отличаться от указанного в поле |
steps[] |
Массив шагов, обозначающих сегменты в пределах этого этапа. Каждый шаг представляет собой одну инструкцию по навигации. |
travelAdvisory |
Содержит дополнительную информацию, которую следует сообщить пользователю, например о возможных ограничениях в зоне движения на участке маршрута. |
localizedValues |
Текстовые представления свойств |
stepsOverview |
Общая информация об этапах в этом |
Polyline
Инкапсулирует закодированную ломаную линию.
| JSON-представление |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "encodedPolyline": string, "geoJsonLinestring": { object } // End of mutually exclusive fields. } |
| Поля | |
|---|---|
| Инкапсулирует тип ломаной линии. Значение по умолчанию: encoded_polyline. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
encodedPolyline |
Строковая кодировка ломаной линии, использующая алгоритм кодирования ломаной линии. |
geoJsonLinestring |
Задает ломаную линию в формате GeoJSON LineString. |
| Конец взаимоисключающих полей. | |
RouteLegStep
Содержит сегмент . Каждый шаг соответствует одной инструкции по навигации. Этапы маршрута состоят из шагов.RouteLeg
| JSON-представление |
|---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
| Поля | |
|---|---|
distanceMeters |
Расстояние, которое нужно преодолеть на этом этапе, в метрах. В некоторых случаях это поле может быть пустым. |
staticDuration |
Продолжительность поездки на этом этапе без учета загруженности дорог. В некоторых случаях это поле может быть пустым. Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву |
polyline |
Ломаная линия, связанная с этим шагом. |
startLocation |
Начальная точка этого шага. |
endLocation |
Конечная точка этого шага. |
navigationInstruction |
Инструкции по навигации. |
travelAdvisory |
Содержит дополнительную информацию, которую необходимо сообщить пользователю, например о возможных ограничениях в зоне движения, на этапе маршрута. |
localizedValues |
Текстовые представления свойств |
transitDetails |
Подробные сведения об этом этапе, если выбран способ передвижения |
travelMode |
Способ передвижения, используемый на этом этапе. |
Маневр
Набор значений, которые указывают, какое действие нужно выполнить на текущем шаге (например, повернуть налево, перестроиться или ехать прямо).
| Перечисления | |
|---|---|
MANEUVER_UNSPECIFIED |
Не используется. |
TURN_SLIGHT_LEFT |
Слегка поверните голову влево. |
TURN_SHARP_LEFT |
Резко поверните налево. |
UTURN_LEFT |
Развернитесь налево. |
TURN_LEFT |
Поверните налево. |
TURN_SLIGHT_RIGHT |
Слегка поверните направо. |
TURN_SHARP_RIGHT |
Резко поверните направо. |
UTURN_RIGHT |
Развернитесь направо. |
TURN_RIGHT |
Поверните направо. |
STRAIGHT |
Идите прямо. |
RAMP_LEFT |
Поверните на съезд слева. |
RAMP_RIGHT |
Поверните на съезд справа. |
MERGE |
Встройтесь в поток. |
FORK_LEFT |
Держитесь левее. |
FORK_RIGHT |
Поверните направо. |
FERRY |
На пароме. |
FERRY_TRAIN |
Сядьте на поезд, который идет до парома. |
ROUNDABOUT_LEFT |
На кольце поверните налево. |
ROUNDABOUT_RIGHT |
На кольце поверните направо. |
DEPART |
Начальный маневр. |
NAME_CHANGE |
Используется для указания изменения названия улицы. |
DESTINATION |
Используется для обозначения прибытия в пункт назначения. |
RouteLegStepTravelAdvisory
Содержит дополнительную информацию, о которой следует сообщить пользователю, например о возможных ограничениях зоны движения на этапе этапа.
| JSON-представление |
|---|
{
"speedReadingIntervals": [
{
object ( |
| Поля | |
|---|---|
speedReadingIntervals[] |
Примечание. В настоящее время это поле не заполнено. |
RouteLegStepLocalizedValues
Текстовые представления определенных свойств.
| JSON-представление |
|---|
{ "distance": { object ( |
| Поля | |
|---|---|
distance |
Расстояние в текстовом формате. |
staticDuration |
Продолжительность без учета загруженности дорог, представленная в текстовом виде. |
RouteLegStepTransitDetails
Дополнительная информация о RouteLegStep, связанная с маршрутами TRANSIT.
| JSON-представление |
|---|
{ "stopDetails": { object ( |
| Поля | |
|---|---|
stopDetails |
Информация об остановках прибытия и отправления для этапа. |
localizedValues |
Текстовые представления свойств |
headsign |
Направление линии общественного транспорта, в котором следует ехать (как указано на транспортном средстве или остановке). Обычно это конечная остановка маршрута. |
headway |
Ожидаемое время между отправлениями с одной и той же остановки. Например, если значение headway_secs равно 600, это означает, что следующий автобус придет через 10 минут. Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву |
transitLine |
Информация о маршруте общественного транспорта на этом шаге. |
stopCount |
Количество остановок от отправления до прибытия. Включает остановку прибытия, но не остановку отправления. Например, если вы выезжаете с остановки A, проезжаете остановки B и C и выходите на остановке D, значение |
tripShortText |
Текст, который пассажиры видят в расписаниях и на информационных табло. Текст должен однозначно идентифицировать поездку в течение дня обслуживания. Например, 538 – это |
TransitStopDetails
Информация об остановках общественного транспорта для RouteLegStep.
| JSON-представление |
|---|
{ "arrivalStop": { object ( |
| Поля | |
|---|---|
arrivalStop |
Информация об остановке прибытия для этапа. |
arrivalTime |
Расчетное время прибытия для шага. Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
departureStop |
Информация об остановке отправления для этапа. |
departureTime |
Расчетное время отправления для шага. Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: |
TransitStop
Информация об остановке общественного транспорта.
| JSON-представление |
|---|
{
"name": string,
"location": {
object ( |
| Поля | |
|---|---|
name |
Название остановки общественного транспорта. |
location |
Местоположение остановки, выраженное в координатах широты и долготы. |
TransitDetailsLocalizedValues
Локализованные описания значений для RouteTransitDetails.
| JSON-представление |
|---|
{ "arrivalTime": { object ( |
| Поля | |
|---|---|
arrivalTime |
Время в текстовом формате с указанием часового пояса. |
departureTime |
Время в текстовом формате с указанием часового пояса. |
LocalizedTime
Локализованное описание времени.
| JSON-представление |
|---|
{
"time": {
object ( |
| Поля | |
|---|---|
time |
Время в виде строки в заданном часовом поясе. |
timeZone |
Часовой пояс. в формате IANA (например, "America/New_York"). |
TransitLine
Содержит информацию о маршруте общественного транспорта на этом шаге.
| JSON-представление |
|---|
{ "agencies": [ { object ( |
| Поля | |
|---|---|
agencies[] |
Транспортное агентство (или агентства), которое управляет этим маршрутом. |
name |
Полное название маршрута, например "8 Avenue Local". |
uri |
URI маршрута, предоставленный транспортным агентством. |
color |
Цвет, которым обозначается этот маршрут. Представлен в шестнадцатеричном формате. |
iconUri |
URI значка, связанного с этим маршрутом. |
nameShort |
Краткое название маршрута. Как правило, это номер маршрута, например 7 или 355. |
textColor |
Цвет, который обычно используется в тексте на знаках этого вида транспорта. Представлен в шестнадцатеричном формате. |
vehicle |
Тип транспортного средства, которое используется на этом маршруте. |
TransitAgency
Транспортное агентство, которое обслуживает маршрут.
| JSON-представление |
|---|
{ "name": string, "phoneNumber": string, "uri": string } |
| Поля | |
|---|---|
name |
Название транспортного агентства. |
phoneNumber |
Номер телефона транспортного агентства в международном формате. |
uri |
URI транспортного агентства. |
TransitVehicle
Информация о транспортном средстве, используемом на маршрутах общественного транспорта.
| JSON-представление |
|---|
{ "name": { object ( |
| Поля | |
|---|---|
name |
Название транспортного средства, написанное заглавными буквами. |
type |
Тип транспортного средства. |
iconUri |
URI значка, связанного с этим типом транспортного средства. |
localIconUri |
URI значка, связанного с этим типом транспорта, на основе местных дорожных знаков. |
TransitVehicleType
Тип транспортных средств для маршрутов общественного транспорта.
| Перечисления | |
|---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Не используется. |
BUS |
Автобус |
CABLE_CAR |
Канатная дорога (транспорт, обычно наземный, приводимый в движение с помощью троса). Воздушные канатные дороги могут относиться к типу GONDOLA_LIFT. |
COMMUTER_TRAIN |
Электропоезд |
FERRY |
Паром |
FUNICULAR |
Фуникулер (канатная дорога для подъема в гору, Фуникулер обычно состоит из двух вагончиков, каждый из которых служит противовесом другому. |
GONDOLA_LIFT |
Воздушная канатная дорога |
HEAVY_RAIL |
Городской рельсовый транспорт |
HIGH_SPEED_TRAIN |
Скоростной поезд |
INTERCITY_BUS |
Междугородный автобус |
LONG_DISTANCE_TRAIN |
Поезд дальнего следования. |
METRO_RAIL |
Легкорельсовый транспорт |
MONORAIL |
Монорельс |
OTHER |
Все другие транспортные средства. |
RAIL |
Рельсовый транспорт |
SHARE_TAXI |
Маршрутное такси (вид автобуса с возможностью посадки и выхода пассажиров на любой точке своего маршрута). |
SUBWAY |
Подземный легкорельсовый транспорт |
TRAM |
Наземный легкорельсовый транспорт |
TROLLEYBUS |
Троллейбус |
RouteLegTravelAdvisory
Содержит дополнительную информацию, о которой пользователь должен быть проинформирован на этапе этапа, например о возможных ограничениях зоны движения.
| JSON-представление |
|---|
{ "tollInfo": { object ( |
| Поля | |
|---|---|
tollInfo |
Содержит информацию о платных дорогах на определенном маршруте |
speedReadingIntervals[] |
Интервалы скорости, указывающие на плотность трафика. Это поле заполняется только для запросов, в которых значение Пример: |
RouteLegLocalizedValues
Текстовые представления определенных свойств.
| JSON-представление |
|---|
{ "distance": { object ( |
| Поля | |
|---|---|
distance |
Расстояние в текстовом формате. |
duration |
Продолжительность в текстовом формате, локализованная для региона запроса. Учитывает загруженность дорог. Примечание. Если вы не запрашивали информацию о трафике, это значение будет совпадать со значением staticDuration. |
staticDuration |
Продолжительность без учета загруженности дорог, представленная в текстовом виде. |
StepsOverview
Общая информация о списке объектов типа RouteLegStep.
| JSON-представление |
|---|
{
"multiModalSegments": [
{
object ( |
| Поля | |
|---|---|
multiModalSegments[] |
Краткая информация о разных мультимодальных сегментах |
MultiModalSegment
Предоставляет сводную информацию о различных мультимодальных сегментах RouteLeg.steps. Мультимодальный сегмент – это один или несколько смежных сегментов RouteLegStep с одинаковым значением RouteTravelMode. Это поле не заполняется, если в шагах RouteLeg нет мультимодальных сегментов.
| JSON-представление |
|---|
{ "navigationInstruction": { object ( |
| Поля | |
|---|---|
navigationInstruction |
NavigationInstruction для мультимодального сегмента. |
travelMode |
Способ передвижения на мультимодальном сегменте. |
stepStartIndex |
Индекс |
stepEndIndex |
Индекс |
Область просмотра
Область просмотра, заданная координатами широты и долготы и представленная двумя диагонально противоположными точками low и high. Область просмотра считается замкнутым регионом, то есть включает в себя свои границы. Границы широты должны находиться в диапазоне от -90 до 90 градусов включительно, а границы долготы – в диапазоне от -180 до 180 градусов включительно. Примеры:
Если
low=high, область просмотра состоит из одной точки.Если
low.longitude>high.longitude, диапазон долготы инвертируется (область просмотра пересекает линию долготы 180 градусов).Если
low.longitude= -180 градусов, аhigh.longitude= 180 градусов, область просмотра включает все долготы.Если
low.longitude= 180 градусов, аhigh.longitude= -180 градусов, диапазон долготы пуст.Если
low.latitude>high.latitude, диапазон широт пуст.
Оба поля (low и high) должны быть заполнены, а представленная область не может быть пустой (как указано в определениях выше). Если область просмотра пуста, возникнет ошибка.
Например, эта область просмотра полностью охватывает Нью-Йорк:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
| JSON-представление |
|---|
{ "low": { object ( |
| Поля | |
|---|---|
low |
Обязательно. Нижняя точка области просмотра. |
high |
Обязательно. Верхняя точка области просмотра. |
RouteLocalizedValues
Текстовые представления определенных свойств.
| JSON-представление |
|---|
{ "distance": { object ( |
| Поля | |
|---|---|
distance |
Расстояние в текстовом формате. |
duration |
Продолжительность в текстовом формате, локализованная для региона запроса. Учитывает загруженность дорог. Примечание. Если вы не запрашивали информацию о трафике, это значение будет совпадать со значением |
staticDuration |
Продолжительность без учета загруженности дорог, представленная в текстовом виде. |
transitFare |
Стоимость проезда в текстовом формате. |
PolylineDetails
Сведения, соответствующие заданному индексу или смежному сегменту ломаной линии. Для ломаной линии с точками P_0, P_1, ... , P_N (индекс с отсчетом от нуля) PolylineDetails определяет интервал и связанные с ним метаданные.
| JSON-представление |
|---|
{ "tunnelInfo": [ { object ( |
| Поля | |
|---|---|
tunnelInfo[] |
Сведения о туннелях вдоль ломаной линии. Это поле заполняется, если в запросе указан модификатор маршрута |
restrictionInfo[] |
Сведения об ограничениях на ломаной линии. Это поле заполняется, только если в запросе указан модификатор маршрута |
flyoverInfo[] |
Информация об эстакаде вдоль ломаной линии. |
narrowRoadInfo[] |
Сведения об узких дорогах вдоль ломаной линии. |
bridgeInfo[] |
Сведения о мостах вдоль ломаной линии. |
skywayInfo[] |
Информация о надземных переходах вдоль ломаной линии. |
TunnelInfo
Содержит информацию о туннелях вдоль ломаной линии.
| JSON-представление |
|---|
{ "tunnelPresence": enum ( |
| Поля | |
|---|---|
tunnelPresence |
Указывает, есть ли туннель на определенном участке ломаной линии. |
polylinePointIndex |
Расположение информации о туннеле вдоль ломаной линии. |
RoadFeatureState
Инкапсулирует состояния дорожных объектов вдоль отрезка ломаной линии.
| Перечисления | |
|---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
Состояние объекта не вычислено (значение по умолчанию). |
EXISTS |
Дорожный объект существует. |
DOES_NOT_EXIST |
Дороги не существует. |
PolylinePointIndex
Инкапсулирует начальный и конечный индексы для детализации ломаной линии. Если данные соответствуют одной точке, значения startIndex и endIndex будут равны.
| JSON-представление |
|---|
{ "startIndex": integer, "endIndex": integer } |
| Поля | |
|---|---|
startIndex |
Начальный индекс этого элемента в ломаной линии. |
endIndex |
Конечный индекс этой детали в ломаной линии. |
RestrictionInfo
Содержит информацию о различных ограничениях на ломаной линии.
| JSON-представление |
|---|
{ "restrictionPresence": enum ( |
| Поля | |
|---|---|
restrictionPresence |
Только для вывода. Указывает, существует ли ограничение для данного участка ломаной линии. |
polylinePointIndex |
Местоположение информации об ограничении на ломаной линии. |
| Инкапсулирует типы ограничений, которые могут применяться к заданному участку ломаной линии. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
restrictedHeightMm |
Ограничение по высоте в миллиметрах. Это поле заполняется, если ограничение по высоте не позволяет проехать или приводит к низкому клиренсу для указанного транспортного средства. |
restrictedWeightKg |
Ограничение по весу в килограммах. Это поле заполняется, когда ограничение по весу не позволяет проехать или близко к весу указанного транспортного средства. |
hazardousGoods |
Если перевозка опасных грузов запрещена, в этом поле указывается значение true. |
trucksProhibited |
Если движение грузовиков запрещено, для этого поля задается значение true. |
| Конец взаимоисключающих полей. | |
FlyoverInfo
Содержит информацию об эстакадах вдоль ломаной линии.
| JSON-представление |
|---|
{ "flyoverPresence": enum ( |
| Поля | |
|---|---|
flyoverPresence |
Только для вывода. Указывает, есть ли эстакада на определенном участке ломаной линии. |
polylinePointIndex |
Местоположение информации об эстакаде вдоль ломаной линии. |
NarrowRoadInfo
Содержит информацию об узких дорогах вдоль ломаной линии.
| JSON-представление |
|---|
{ "narrowRoadPresence": enum ( |
| Поля | |
|---|---|
narrowRoadPresence |
Только для вывода. Указывает, есть ли узкая дорога на определенном участке ломаной линии. |
polylinePointIndex |
Местоположение информации об узкой дороге вдоль ломаной линии. |
BridgeInfo
Содержит информацию о мостах вдоль ломаной линии.
| JSON-представление |
|---|
{ "bridgePresence": enum ( |
| Поля | |
|---|---|
bridgePresence |
Указывает, есть ли мост на данном участке ломаной линии. |
polylinePointIndex |
Местоположение информации о мосте вдоль ломаной линии. |
SkywayInfo
Содержит информацию о надземных переходах вдоль ломаной линии.
| JSON-представление |
|---|
{ "skywayPresence": enum ( |
| Поля | |
|---|---|
skywayPresence |
Указывает, есть ли надземный переход на определенном участке ломаной линии. |
polylinePointIndex |
Местоположение информации о надземном переходе вдоль ломаной линии. |
GeocodingResults
Содержит для начальной, конечной и промежуточных точек маршрута. Заполняется только для путевых точек с адресом.GeocodedWaypoints
| JSON-представление |
|---|
{ "origin": { object ( |
| Поля | |
|---|---|
origin |
Геокодированная путевая точка отправления. |
destination |
Геокодированная путевая точка пункта назначения. |
intermediates[] |
Список промежуточных геокодированных путевых точек, каждая из которых содержит поле индекса, соответствующее позиции путевой точки в порядке, в котором они были указаны в запросе (начиная с нуля). |
GeocodedWaypoint
Сведения о местоположениях, используемых в качестве путевых точек. Заполняется только для путевых точек с адресом. Содержит подробные сведения о результатах геокодирования, которые позволяют определить, к какому адресу было применено геокодирование.
| JSON-представление |
|---|
{
"geocoderStatus": {
object ( |
| Поля | |
|---|---|
geocoderStatus |
Указывает код статуса, полученный в результате операции геокодирования. |
type[] |
Тип или типы результата в виде одного или нескольких тегов. Поддерживаемые типы: типы адресов и их компонентов. |
partialMatch |
Указывает, что геокодер не вернул точное соответствие для исходного запроса, хотя и обнаружил частичное совпадение с запрашиваемым адресом. Рекомендуется проверить исходный запрос на наличие в нем опечаток и/или неполного адреса. |
placeId |
Идентификатор места для этого результата. |
intermediateWaypointRequestIndex |
Индекс соответствующей промежуточной путевой точки в запросе. Заполняется, только если соответствующая путевая точка является промежуточной. |