Method: computeRoutes

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

Примечание. При использовании этого метода необходимо указать маску поля ответа в поле ввода. Маску поля ответа можно указать с помощью параметра 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 (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
Поля
origin

object (Waypoint)

Обязательно. Начальная путевая точка.

destination

object (Waypoint)

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

intermediates[]

object (Waypoint)

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

travelMode

enum (RouteTravelMode)

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

routingPreference

enum (RoutingPreference)

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

polylineQuality

enum (PolylineQuality)

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

polylineEncoding

enum (PolylineEncoding)

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

departureTime

string (Timestamp format)

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

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".

arrivalTime

string (Timestamp format)

Необязательное поле. Время прибытия. Примечание. Это поле игнорируется, если в запросах указано значение RouteTravelMode, отличное от TRANSIT. Вы можете указать либо departureTime, либо arrivalTime, но не оба значения. Вы можете посмотреть маршруты за последние 7 дней или на 100 дней вперед.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".

computeAlternativeRoutes

boolean

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

routeModifiers

object (RouteModifiers)

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

languageCode

string

Необязательное поле. Код языка по стандарту BCP-47, например "ru-RU" или "sr-Latn". Подробнее об идентификаторах региональных настроек Unicode… Список поддерживаемых языков приведен в разделе Поддержка языков. Если вы не укажете это значение, язык интерфейса будет определяться на основе местоположения запроса маршрута.

regionCode

string

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

units

enum (Units)

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

optimizeWaypointOrder

boolean

Необязательное поле. Если установлено значение true, сервис пытается минимизировать общую стоимость маршрута, изменяя порядок указанных промежуточных путевых точек. Запрос не будет выполнен, если хотя бы одна из промежуточных путевых точек является точкой via. Используйте ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index, чтобы найти новый порядок. Если в заголовке X-Goog-FieldMask не запрашивается ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index, запрос не выполняется. Если для правила optimizeWaypointOrder задано значение False, поле ComputeRoutesResponse.optimized_intermediate_waypoint_index будет пустым.

requestedReferenceRoutes[]

enum (ReferenceRoute)

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

extraComputations[]

enum (ExtraComputation)

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

trafficModel

enum (TrafficModel)

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

transitPreferences

object (TransitPreferences)

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

Тело ответа

v2.computeRoutes ответное сообщение.

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

JSON-представление
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
Поля
routes[]

object (Route)

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

fallbackInfo

object (FallbackInfo)

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

geocodingResults

object (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

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

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

Для запросов BICYCLE и TWO_WHEELER эта функция возвращает маршруты, аналогичные тем, которые возвращаются, если не указывать requestedReferenceRoutes.

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

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 (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
Поля
routeLabels[]

enum (RouteLabel)

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

legs[]

object (RouteLeg)

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

distanceMeters

integer

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

duration

string (Duration format)

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

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

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

Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву s. Пример: "3.5s".

staticDuration

string (Duration format)

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

Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву s. Пример: "3.5s".

polyline

object (Polyline)

Ломаная линия всего маршрута. Эта ломаная линия представляет собой комбинацию всех линий legs.

description

string

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

warnings[]

string

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

viewport

object (Viewport)

Граничная рамка области просмотра ломаной линии.

travelAdvisory

object (RouteTravelAdvisory)

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

optimizedIntermediateWaypointIndex[]

integer

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

localizedValues

object (RouteLocalizedValues)

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

routeToken

string

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

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

polylineDetails

object (PolylineDetails)

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

RouteLabel

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

Перечисления
ROUTE_LABEL_UNSPECIFIED По умолчанию не используется.
DEFAULT_ROUTE "Лучший" маршрут, возвращаемый по умолчанию при расчете маршрута.
DEFAULT_ROUTE_ALTERNATE Альтернатива маршруту по умолчанию. Такие маршруты будут возвращаться, если указан параметр computeAlternativeRoutes.
FUEL_EFFICIENT Маршрут с минимальным расходом топлива. Маршруты с этой меткой оптимизированы по экологическим параметрам, например по расходу топлива.
SHORTER_DISTANCE Маршрут с меньшим расстоянием. Это экспериментальная функция.

RouteLeg

Содержит сегмент между путевыми точками, не относящимися к via.

JSON-представление
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
Поля
distanceMeters

integer

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

duration

string (Duration format)

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

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

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

Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву s. Пример: "3.5s".

staticDuration

string (Duration format)

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

Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву s. Пример: "3.5s".

polyline

object (Polyline)

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

startLocation

object (Location)

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

endLocation

object (Location)

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

steps[]

object (RouteLegStep)

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

travelAdvisory

object (RouteLegTravelAdvisory)

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

localizedValues

object (RouteLegLocalizedValues)

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

stepsOverview

object (StepsOverview)

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

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

string

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

geoJsonLinestring

object (Struct format)

Задает ломаную линию в формате GeoJSON LineString.

Конец взаимоисключающих полей.

RouteLegStep

Содержит сегмент RouteLeg. Каждый шаг соответствует одной инструкции по навигации. Этапы маршрута состоят из шагов.

JSON-представление
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
Поля
distanceMeters

integer

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

staticDuration

string (Duration format)

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

Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву s. Пример: "3.5s".

polyline

object (Polyline)

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

startLocation

object (Location)

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

endLocation

object (Location)

Конечная точка этого шага.

navigationInstruction

object (NavigationInstruction)

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

travelAdvisory

object (RouteLegStepTravelAdvisory)

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

localizedValues

object (RouteLegStepLocalizedValues)

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

transitDetails

object (RouteLegStepTransitDetails)

Подробные сведения об этом этапе, если выбран способ передвижения TRANSIT.

travelMode

enum (RouteTravelMode)

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

Маневр

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

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

RouteLegStepTravelAdvisory

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

JSON-представление
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Поля
speedReadingIntervals[]

object (SpeedReadingInterval)

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

RouteLegStepLocalizedValues

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

JSON-представление
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Поля
distance

object (LocalizedText)

Расстояние в текстовом формате.

staticDuration

object (LocalizedText)

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

RouteLegStepTransitDetails

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

JSON-представление
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Поля
stopDetails

object (TransitStopDetails)

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

localizedValues

object (TransitDetailsLocalizedValues)

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

headsign

string

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

headway

string (Duration format)

Ожидаемое время между отправлениями с одной и той же остановки. Например, если значение headway_secs равно 600, это означает, что следующий автобус придет через 10 минут.

Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву s. Пример: "3.5s".

transitLine

object (TransitLine)

Информация о маршруте общественного транспорта на этом шаге.

stopCount

integer

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

tripShortText

string

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

TransitStopDetails

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

JSON-представление
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
Поля
arrivalStop

object (TransitStop)

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

arrivalTime

string (Timestamp format)

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

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".

departureStop

object (TransitStop)

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

departureTime

string (Timestamp format)

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

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".

TransitStop

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

JSON-представление
{
  "name": string,
  "location": {
    object (Location)
  }
}
Поля
name

string

Название остановки общественного транспорта.

location

object (Location)

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

TransitDetailsLocalizedValues

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

JSON-представление
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
Поля
arrivalTime

object (LocalizedTime)

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

departureTime

object (LocalizedTime)

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

LocalizedTime

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

JSON-представление
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
Поля
time

object (LocalizedText)

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

timeZone

string

Часовой пояс. в формате IANA (например, "America/New_York").

TransitLine

Содержит информацию о маршруте общественного транспорта на этом шаге.

JSON-представление
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
Поля
agencies[]

object (TransitAgency)

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

name

string

Полное название маршрута, например "8 Avenue Local".

uri

string

URI маршрута, предоставленный транспортным агентством.

color

string

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

iconUri

string

URI значка, связанного с этим маршрутом.

nameShort

string

Краткое название маршрута. Как правило, это номер маршрута, например 7 или 355.

textColor

string

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

vehicle

object (TransitVehicle)

Тип транспортного средства, которое используется на этом маршруте.

TransitAgency

Транспортное агентство, которое обслуживает маршрут.

JSON-представление
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
Поля
name

string

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

phoneNumber

string

Номер телефона транспортного агентства в международном формате.

uri

string

URI транспортного агентства.

TransitVehicle

Информация о транспортном средстве, используемом на маршрутах общественного транспорта.

JSON-представление
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
Поля
name

object (LocalizedText)

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

type

enum (TransitVehicleType)

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

iconUri

string

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

localIconUri

string

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": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Поля
tollInfo

object (TollInfo)

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

speedReadingIntervals[]

object (SpeedReadingInterval)

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

Пример:

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

RouteLegLocalizedValues

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

JSON-представление
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Поля
distance

object (LocalizedText)

Расстояние в текстовом формате.

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

StepsOverview

Общая информация о списке объектов типа RouteLegStep.

JSON-представление
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
Поля
multiModalSegments[]

object (MultiModalSegment)

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

MultiModalSegment

Предоставляет сводную информацию о различных мультимодальных сегментах RouteLeg.steps. Мультимодальный сегмент – это один или несколько смежных сегментов RouteLegStep с одинаковым значением RouteTravelMode. Это поле не заполняется, если в шагах RouteLeg нет мультимодальных сегментов.

JSON-представление
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Поля
navigationInstruction

object (NavigationInstruction)

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

travelMode

enum (RouteTravelMode)

Способ передвижения на мультимодальном сегменте.

stepStartIndex

integer

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

stepEndIndex

integer

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

Область просмотра

Область просмотра, заданная координатами широты и долготы и представленная двумя диагонально противоположными точками 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 (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Поля
low

object (LatLng)

Обязательно. Нижняя точка области просмотра.

high

object (LatLng)

Обязательно. Верхняя точка области просмотра.

RouteLocalizedValues

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

JSON-представление
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
Поля
distance

object (LocalizedText)

Расстояние в текстовом формате.

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

transitFare

object (LocalizedText)

Стоимость проезда в текстовом формате.

PolylineDetails

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

JSON-представление
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
Поля
tunnelInfo[]

object (TunnelInfo)

Сведения о туннелях вдоль ломаной линии. Это поле заполняется, если в запросе указан модификатор маршрута avoidTunnels и в результате маршрут не избегает их, ИЛИ если TUNNEL_INFO_ON_POLYLINE указан в extraComputations и маршрут содержит туннели.

restrictionInfo[]

object (RestrictionInfo)

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

flyoverInfo[]

object (FlyoverInfo)

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

narrowRoadInfo[]

object (NarrowRoadInfo)

Сведения об узких дорогах вдоль ломаной линии.

bridgeInfo[]

object (BridgeInfo)

Сведения о мостах вдоль ломаной линии.

skywayInfo[]

object (SkywayInfo)

Информация о надземных переходах вдоль ломаной линии.

TunnelInfo

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

JSON-представление
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Поля
tunnelPresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

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

RoadFeatureState

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

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

PolylinePointIndex

Инкапсулирует начальный и конечный индексы для детализации ломаной линии. Если данные соответствуют одной точке, значения startIndex и endIndex будут равны.

JSON-представление
{
  "startIndex": integer,
  "endIndex": integer
}
Поля
startIndex

integer

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

endIndex

integer

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

RestrictionInfo

Содержит информацию о различных ограничениях на ломаной линии.

JSON-представление
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
Поля
restrictionPresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

Местоположение информации об ограничении на ломаной линии.

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

string (int64 format)

Ограничение по высоте в миллиметрах. Это поле заполняется, если ограничение по высоте не позволяет проехать или приводит к низкому клиренсу для указанного транспортного средства.

restrictedWeightKg

string (int64 format)

Ограничение по весу в килограммах. Это поле заполняется, когда ограничение по весу не позволяет проехать или близко к весу указанного транспортного средства.

hazardousGoods

boolean

Если перевозка опасных грузов запрещена, в этом поле указывается значение true.

trucksProhibited

boolean

Если движение грузовиков запрещено, для этого поля задается значение true.

Конец взаимоисключающих полей.

FlyoverInfo

Содержит информацию об эстакадах вдоль ломаной линии.

JSON-представление
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Поля
flyoverPresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

Местоположение информации об эстакаде вдоль ломаной линии.

NarrowRoadInfo

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

JSON-представление
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Поля
narrowRoadPresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

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

BridgeInfo

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

JSON-представление
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Поля
bridgePresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

Местоположение информации о мосте вдоль ломаной линии.

SkywayInfo

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

JSON-представление
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Поля
skywayPresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

Местоположение информации о надземном переходе вдоль ломаной линии.

GeocodingResults

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

JSON-представление
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
Поля
origin

object (GeocodedWaypoint)

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

destination

object (GeocodedWaypoint)

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

intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

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

JSON-представление
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
Поля
geocoderStatus

object (Status)

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

type[]

string

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

partialMatch

boolean

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

placeId

string

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

intermediateWaypointRequestIndex

integer

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