Method: computeRoutes

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

ПРИМЕЧАНИЕ: Этот метод требует указания маски поля ответа во входных данных. Маску поля ответа можно задать с помощью параметра URL $fields или fields , либо с помощью заголовка HTTP/gRPC X-Goog-FieldMask (см. доступные параметры URL и заголовки ). Значение представляет собой список путей к полям, разделенных запятыми. Подробную информацию о создании путей к полям см . в документации.

Например, в этом методе:

  • Маска поля всех доступных полей (для ручной проверки): X-Goog-FieldMask: *
  • Маска поля длительности, расстояния и полилинии на уровне маршрута (пример производственной настройки): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google не рекомендует использовать маску поля ответа с подстановочными знаками ( * ) или указывать маску поля на верхнем уровне ( routes ), потому что:

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

HTTP-запрос

POST https://routes.googleapis.com/directions/v2:computeRoutes

URL использует синтаксис перекодировки gRPC .

Текст запроса

Тело запроса содержит данные со следующей структурой:

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 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "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 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "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, например «en-US» или «sr-Latn». Подробнее см. в разделе «Идентификатор локали Unicode» . Список поддерживаемых языков см. в разделе «Поддержка языков». Если это значение не указано, язык отображения определяется на основе местоположения запроса маршрута.

regionCode

string

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

units

enum ( Units )

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

optimizeWaypointOrder

boolean

Необязательно. Если установлено значение true, сервис попытается минимизировать общую стоимость маршрута, переупорядочивая указанные промежуточные точки маршрута. Запрос не будет выполнен, если какая-либо из промежуточных точек маршрута является via точкой. Используйте ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index для определения нового порядка. Если ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index не запрошен в заголовке X-Goog-FieldMask , запрос не будет выполнен. Если 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 . По умолчанию используется значение BEST_GUESS , если запрашивается трафик, а TrafficModel не указан.

transitPreferences

object ( TransitPreferences )

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

Тело ответа

v2.computeМаршрутизирует ответное сообщение.

В случае успеха тело ответа содержит данные со следующей структурой:

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.

Справочный маршрут

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

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

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

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

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

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

ExtraComputation

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

Перечисления
EXTRA_COMPUTATION_UNSPECIFIED Не используется. Запросы, содержащие это значение, не будут выполнены.
TOLLS Информация о платных маршрутах.
FUEL_CONSUMPTION Расчетный расход топлива по маршруту(ам).
TRAFFIC_ON_POLYLINE Полилинии с учетом дорожного движения для маршрута(ов).
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions представлен в виде отформатированной текстовой строки HTML. Этот контент предназначен только для отображения и не требует программного анализа.
FLYOVER_INFO_ON_POLYLINE Информация о пролётах для маршрута(ов). Для возврата этой информации необходимо указать маску поля routes.polyline_details.flyover_info . В настоящее время эти данные будут заполняться только для некоторых агломераций в Индии. Эта функция экспериментальная, и артикул/стоимость могут быть изменены.
NARROW_ROAD_INFO_ON_POLYLINE Информация об узких дорогах для маршрута(ов). Для возврата этой информации необходимо указать маску поля routes.polyline_details.narrow_road_info . В настоящее время эти данные будут заполняться только для некоторых агломераций в Индии. Эта функция экспериментальная, и артикул/стоимость могут быть изменены.

Маршрут

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

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 промежуточными точками), имеет один этап. Порядок этапов соответствует порядку intermediates точек от origin до destination .

distanceMeters

integer

Пройденное расстояние маршрута в метрах.

duration

string ( Duration format)

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

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивается на « 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 не поддерживается для запросов с промежуточными точками Via.

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)

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

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивается на « 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 . Это поле заполняется только для маршрутов TRANSIT.

Полилиния

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

JSON-представление 
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
Поля
Поле объединения polyline_type . Инкапсулирует тип полилинии. По умолчанию — encoded_polyline. polyline_type может быть только одним из следующих:
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 Используется для обозначения изменения названия улицы.

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)

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

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивается на « 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 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "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 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "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

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

textColor

string

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

vehicle

object ( TransitVehicle )

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

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

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

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

string

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

phoneNumber

string

Номер телефона транспортного агентства, отформатированный в соответствии с местными условиями.

uri

string

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

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

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

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 и TOLLS включено в ComputeRoutesRequest.extra_computations запроса. Если это поле задано, но подполе estimatePrice не заполнено, мы ожидаем, что дорога содержит платные дороги, но предполагаемая стоимость проезда неизвестна. Если tollInfo отсутствует, то на этом участке RouteLeg плата за проезд отсутствует.

speedReadingIntervals[]

object ( SpeedReadingInterval )

Интервалы измерения скорости, указывающие на плотность трафика. Это поле заполняется только для запросов, у которых есть значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference , а параметр 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 )

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

Обзор шагов

Предоставляет обзорную информацию о списке RouteLegStep .

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

object ( MultiModalSegment )

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

Мультимодальный сегмент

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

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

object ( 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 должны быть заполнены, и отображаемое поле не может быть пустым (как указано в определениях выше). Пустая область просмотра приведёт к ошибке.

Например, эта область просмотра полностью охватывает Нью-Йорк:

{ "низкая": { "широта": 40.477398, "долгота": -74.259087 }, "высокая": { "широта": 40.91618, "долгота": -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-представление 
{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}
Поля
flyoverInfo[]

object ( FlyoverInfo )

Детали пролета вдоль полилинии.

narrowRoadInfo[]

object ( NarrowRoadInfo )

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

FlyoverInfo

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

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

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

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

NarrowRoadInfo

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

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

enum ( RoadFeatureState )

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

polylinePointIndex

object ( PolylinePointIndex )

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

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

Содержит 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

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