Route
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Инкапсулирует маршрут, состоящий из ряда соединенных сегментов дороги, соединяющих начальную, конечную и промежуточную точки.
JSON-представление |
---|
{
"legs": [
{
object (RouteLeg )
}
],
"distanceMeters": integer,
"duration": string,
"staticDuration": string,
"polyline": {
object (Polyline )
},
"description": string,
"warnings": [
string
],
"viewport": {
object (Viewport )
},
"travelAdvisory": {
object (RouteTravelAdvisory )
},
"optimizedIntermediateWaypointIndex": [
integer
]
} |
Поля |
---|
legs[] | object ( RouteLeg ) Набор участков (сегментов пути между путевыми точками), составляющих маршрут. Каждый этап соответствует поездке между двумя via маршрутными точками. Например, маршрут без промежуточных точек имеет только один участок. Маршрут, включающий одну промежуточную точку, не via имеет два участка. A route that includes one via intermediate waypoint has one leg. Порядок этапов соответствует порядку точек пути от origin к intermediates и к destination . |
distance Meters | integer Дальность прохождения маршрута в метрах. |
duration | string ( Duration format) Время, необходимое для прохождения маршрута. Если вы установите для routingPreference TRAFFIC_UNAWARE , то это значение будет таким же, как staticDuration . Если для routingPreference установлено значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL , то это значение рассчитывается с учетом условий трафика. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" . |
static Duration | string ( Duration format) Продолжительность проезда по маршруту без учета условий движения. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" . |
polyline | object ( Polyline ) Общая полилиния маршрута. This polyline is the combined polyline of all legs . |
description | string Описание маршрута. |
warnings[] | string Массив предупреждений, отображаемых при отображении маршрута. |
viewport | object ( Viewport ) Ограничивающая рамка полилинии видового экрана. |
travel Advisory | object ( RouteTravelAdvisory ) Дополнительная информация о маршруте. |
optimized Intermediate Waypoint Index[] | integer Если для ComputeRoutesRequest.optimize_waypoint_order установлено значение true, это поле содержит оптимизированный порядок промежуточных путевых точек. в противном случае это поле пусто. Например, предположим, что входные данные: Происхождение: Лос-Анджелес; Промежуточные уровни: Даллас, Бангор, Финикс; Пункт назначения: Нью-Йорк; и оптимизированный порядок промежуточных точек: Феникс, Даллас, Бангор. Тогда это поле содержит значения [2, 0, 1]. Индекс начинается с 0 для первой промежуточной точки. |
МаршрутНога
Инкапсулирует сегмент между точками маршрута, не являющимися via
.
JSON-представление |
---|
{
"distanceMeters": integer,
"duration": string,
"staticDuration": string,
"polyline": {
object (Polyline )
},
"startLocation": {
object (Location )
},
"endLocation": {
object (Location )
},
"steps": [
{
object (RouteLegStep )
}
],
"travelAdvisory": {
object (RouteLegTravelAdvisory )
}
} |
Поля |
---|
distance Meters | integer Расстояние прохождения участка маршрута в метрах. |
duration | string ( Duration format) Время, необходимое для перемещения по ноге. Если для route_preference установлено значение TRAFFIC_UNAWARE , то это значение совпадает со значением staticDuration . Если route_preference имеет значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL , то это значение рассчитывается с учетом условий дорожного движения. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" . |
static Duration | string ( Duration format) Продолжительность проезда по участку рассчитана без учета условий движения. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" . |
polyline | object ( Polyline ) Общая полилиния для этого участка. Сюда входит полилиния каждого step . |
start Location | object ( Location ) Начальное местоположение этого этапа. Это может отличаться от указанного origin . Например, если указанное origin находится не рядом с дорогой, это точка на дороге. |
end Location | object ( Location ) Конечное расположение этой ноги. Это может отличаться от указанного destination . Например, если указанный destination находится не рядом с дорогой, это точка на дороге. |
steps[] | object ( RouteLegStep ) Массив шагов, обозначающий сегменты внутри этого участка. Каждый шаг представляет одну инструкцию навигации. |
travel Advisory | object ( RouteLegTravelAdvisory ) Содержит дополнительную информацию, о которой следует сообщить пользователю, например возможное ограничение зоны движения и т. д. на участке маршрута. |
Полилиния
Инкапсулирует закодированную полилинию.
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 может быть только одним из следующих: |
encoded Polyline | string The string encoding of the polyline using the polyline encoding algorithm . |
geo Json Linestring | object ( Struct format) Указывает полилинию с использованием формата GeoJSON LineString . |
МаршрутНогаШаг
Инкапсулирует сегмент RouteLeg
. Шаг соответствует одной инструкции навигации. Участки маршрута состоят из ступеней.
Поля |
---|
distance Meters | integer Расстояние перемещения этого шага в метрах. В некоторых случаях это поле может не иметь значения. |
static Duration | string ( Duration format) Продолжительность прохождения этого этапа без учета дорожных условий. В некоторых случаях это поле может не иметь значения. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" . |
polyline | object ( Polyline ) Полилиния, связанная с этим шагом. |
start Location | object ( Location ) Начальное местоположение этого шага. |
end Location | object ( Location ) Конечная позиция этого шага. |
navigation Instruction | object ( NavigationInstruction ) Инструкции по навигации. |
travel Advisory | object ( RouteLegStepTravelAdvisory ) Инкапсулирует дополнительную информацию, о которой следует сообщить пользователю, например возможное ограничение зоны движения на шаге ноги. |
НавигацияИнструкция
JSON-представление |
---|
{
"maneuver": enum (Maneuver ),
"instructions": string
} |
Поля |
---|
maneuver | enum ( Maneuver ) Инкапсулирует инструкции навигации для текущего шага (например, повернуть налево, объединиться или прямо). Это поле определяет, какой значок отображать. |
instructions | string Инструкции по навигации на этом этапе. |
МаршрутНогаШагПутешествиеКонсультационный совет
Инкапсулирует дополнительную информацию, о которой следует сообщить пользователю, например возможное ограничение зоны движения на шаге ноги.
Поля |
---|
speed Reading Intervals[] | object ( SpeedReadingInterval ) ПРИМЕЧАНИЕ. Это поле в настоящее время не заполнено. |
МаршрутНогаПутешествиеРекомендации
Содержит дополнительную информацию, о которой следует сообщить пользователю, например возможное ограничение зоны движения и т. д. на участке маршрута.
Поля |
---|
toll Info | object ( TollInfo ) Инкапсулирует информацию о дорожных сборах на конкретном RouteLeg . Это поле заполняется только в том случае, если мы ожидаем, что на RouteLeg есть платные дороги. Если это поле установлено, но подполе estimatedPrice не заполнено, мы ожидаем, что дорога содержит плату за проезд, но мы не знаем ориентировочную цену. Если это поле не существует, то плата за проезд на RouteLeg не взимается. |
speed Reading Intervals[] | object ( SpeedReadingInterval ) Интервалы считывания скорости с подробным описанием плотности трафика. Применимо в случае предпочтений маршрутизации TRAFFIC_AWARE и TRAFFIC_AWARE_OPTIMAL . Интервалы охватывают всю полилинию RouteLeg без перекрытия. Начальная точка указанного интервала совпадает с конечной точкой предыдущего интервала. Пример: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).
|
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-17 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2024-11-17 UTC."],[[["A Route object encapsulates directions between an origin, a destination, and optional intermediate waypoints, providing distance, duration, and step-by-step instructions."],["Each Route is comprised of one or more RouteLegs, representing segments between waypoints, with details like distance, duration, and a polyline for the path."],["RouteLegs are further divided into RouteLegSteps, providing turn-by-turn navigation instructions, including maneuvers and textual guidance."],["A Polyline object represents the path of the route or a segment, encoded using the polyline algorithm or as a GeoJSON LineString."],["Route and RouteLeg objects may contain TravelAdvisory information, such as tolls or speed reading intervals related to traffic conditions, to enhance user awareness."]]],["This document details the structure and information related to route data. Key components include: **Route**, comprised of multiple **RouteLegs** (segments between waypoints); **RouteLegSteps** (individual navigation instructions within a leg). Key actions include calculating the `distanceMeters`, `duration`, and `staticDuration` for routes, legs, and steps. **Polyline** represents the visual path, with `encodedPolyline` or `geoJsonLinestring` options. Additional information is provided through `NavigationInstruction`, `RouteLegStepTravelAdvisory`, and `RouteLegTravelAdvisory` covering maneuvers, warnings, and traffic conditions. The `optimizedIntermediateWaypointIndex` field lists the optimized intermediate waypoint order if requested.\n"]]