- HTTP-запрос
- Тело запроса
- Тело ответа
- PolylineQuality
- ПолилинияКодирование
- Единицы
- СсылкаМаршрут
- Дополнительные вычисления
- Маршрут
- Метка маршрута
- МаршрутЭтап
- Полилиния
- МаршрутLegStep
- Инструкция по навигации
- Маневр
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- ТранзитОстановкаДетали
- ТранзитОстановка
- TransitDetailsLocalizedValues
- Локализованное время
- Транзитная линия
- ТранзитАгентство
- ТранзитАвтомобиль
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- ШагиОбзор
- Мультимодальный сегмент
- Область просмотра
- Маршрутлокализованные значения
- Результаты геокодирования
- GeocodedWaypoint
Возвращает основной маршрут вместе с необязательными альтернативными маршрутами с заданным набором конечных и промежуточных путевых точек.
ПРИМЕЧАНИЕ. Этот метод требует, чтобы вы указали маску поля ответа во входных данных. Вы можете указать маску поля ответа, используя параметр 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 ( |
Поля | |
---|---|
origin | Необходимый. Исходная путевая точка. |
destination | Необходимый. Пункт назначения. |
intermediates[] | Необязательный. Набор путевых точек на маршруте (исключая конечные точки), на которых можно остановиться или проехать. Поддерживается до 25 промежуточных путевых точек. |
travelMode | Необязательный. Определяет вид транспорта. |
routingPreference | Необязательный. Указывает, как вычислить маршрут. Сервер пытается использовать выбранный параметр маршрутизации для расчета маршрута. Если предпочтение маршрутизации приводит к ошибке или слишком большой задержке, возвращается ошибка. Вы можете указать эту опцию, только если для |
polylineQuality | Необязательный. Определяет ваши предпочтения в отношении качества полилинии. |
polylineEncoding | Необязательный. Задает предпочтительную кодировку полилинии. |
departureTime | Необязательный. Время отправления. Если вы не зададите это значение, то оно будет по умолчанию равно времени, когда вы сделали запрос. ПРИМЕЧАНИЕ. Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: |
arrivalTime | Необязательный. Время прибытия. ПРИМЕЧАНИЕ. Можно установить, только если для Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: |
computeAlternativeRoutes | Необязательный. Указывает, следует ли рассчитывать альтернативные маршруты в дополнение к маршруту. Для запросов с промежуточными путевыми точками альтернативные маршруты не возвращаются. |
routeModifiers | Необязательный. Набор условий, которые влияют на способ расчета маршрутов. |
languageCode | Необязательный. Код языка BCP-47, например «en-US» или «sr-Latn». Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . Список поддерживаемых языков см. в разделе Языковая поддержка . Если вы не укажете это значение, язык интерфейса выводится из расположения запроса маршрута. |
regionCode | Необязательный. Код региона, указанный как двухсимвольное значение ccTLD («домен верхнего уровня»). Для получения дополнительной информации см. https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains . |
units | Необязательный. Указывает единицы измерения для отображаемых полей. Эти поля включают поле |
optimizeWaypointOrder | Необязательный. Если установлено значение true, служба пытается минимизировать общую стоимость маршрута, переупорядочив указанные промежуточные путевые точки. Запрос не выполняется, если какая-либо из промежуточных путевых точек является |
requestedReferenceRoutes[] | Необязательный. Указывает, какие эталонные маршруты следует рассчитать как часть запроса в дополнение к маршруту по умолчанию. Эталонный маршрут — это маршрут с целью расчета маршрута, отличной от маршрута по умолчанию. Например, при расчете эталонного маршрута |
extraComputations[] | Необязательный. Список дополнительных вычислений, которые могут быть использованы для выполнения запроса. Примечание. Эти дополнительные вычисления могут возвращать дополнительные поля в ответе. Эти дополнительные поля также должны быть указаны в маске поля, которая будет возвращена в ответе. |
trafficModel | Необязательный. Указывает допущения, используемые при расчете времени в пробке. Этот параметр влияет на значение, возвращаемое в поле длительности в |
transitPreferences | Необязательный. Указывает предпочтения, влияющие на маршрут, возвращаемый для |
Тело ответа
v2.compute перенаправляет ответное сообщение.
В случае успеха тело ответа содержит данные со следующей структурой:
Представление JSON |
---|
{ "routes": [ { object ( |
Поля | |
---|---|
routes[] | Содержит массив вычисленных маршрутов (до трех), если вы укажете calculate_alternatives_routes, и содержит только один маршрут, если вы этого не сделаете. Когда этот массив содержит несколько записей, наиболее рекомендуемым маршрутом является первая. Если массив пуст, значит маршрут не найден. |
fallbackInfo | В некоторых случаях, когда сервер не может вычислить результаты маршрута со всеми параметрами ввода, он может вернуться к использованию другого способа вычисления. При использовании резервного режима это поле содержит подробную информацию о резервном ответе. В противном случае это поле не установлено. |
geocodingResults | Содержит информацию ответа геокодирования для путевых точек, указанных как адреса. |
PolylineQuality
Набор значений, определяющих качество полилинии.
перечисления | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED | Не заданы предпочтения качества полилиний. По умолчанию OVERVIEW . |
HIGH_QUALITY | Указывает высококачественную полилинию, которая состоит из большего количества точек, чем OVERVIEW , за счет увеличения размера ответа. Используйте это значение, когда вам нужна большая точность. |
OVERVIEW | Определяет обзорную полилинию, состоящую из небольшого количества точек. Используйте это значение при отображении обзора маршрута. Использование этого параметра имеет меньшую задержку запроса по сравнению с использованием параметра HIGH_QUALITY . |
ПолилинияКодирование
Указывает предпочтительный тип возвращаемой полилинии.
перечисления | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED | Не указан предпочтительный тип полилинии. По умолчанию ENCODED_POLYLINE . |
ENCODED_POLYLINE | Указывает полилинию, закодированную с использованием алгоритма кодирования полилинии . |
GEO_JSON_LINESTRING | Задает полилинию, используя формат GeoJSON LineString. |
Единицы
Набор значений, определяющих единицу измерения, используемую при отображении.
перечисления | |
---|---|
UNITS_UNSPECIFIED | Единицы измерения не указаны. По умолчанию используется единица измерения, полученная из запроса. |
METRIC | Метрические единицы измерения. |
IMPERIAL | Имперские (английские) единицы измерения. |
СсылкаМаршрут
Поддерживаемый эталонный маршрут в ComputeRoutesRequest.
перечисления | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED | Не используется. Запросы, содержащие это значение, не выполняются. |
FUEL_EFFICIENT | Топливоэффективный маршрут. Маршруты, отмеченные этим значением, определены как оптимизированные по таким параметрам, как расход топлива. |
Дополнительные вычисления
Дополнительные вычисления для выполнения при выполнении запроса.
перечисления | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED | Не используется. Запросы, содержащие это значение, не будут выполнены. |
TOLLS | Информация о платных проездах по маршруту(ам). |
FUEL_CONSUMPTION | Расчетный расход топлива по маршруту(ам). |
TRAFFIC_ON_POLYLINE | Полилинии с учетом трафика для маршрута(ов). |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS | Инструкции по навигации представлены в виде форматированной текстовой строки HTML. Этот контент предназначен для чтения как есть. Этот контент предназначен только для отображения. Не анализируйте его программно. |
Маршрут
Содержит маршрут, состоящий из ряда соединенных сегментов дороги, соединяющих начальную, конечную и промежуточную путевые точки.
Представление JSON |
---|
{ "routeLabels": [ enum ( |
Поля | |
---|---|
routeLabels[] | Метки для |
legs[] | Набор участков (сегментов пути между путевыми точками), составляющих маршрут. Каждый этап соответствует поездке между двумя |
distanceMeters | Протяженность маршрута, в метрах. |
duration | Время, необходимое для прохождения маршрута. Если вы установите для Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « |
staticDuration | Продолжительность проезда по маршруту без учета условий движения. Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « |
polyline | Общая полилиния маршрута. Эта полилиния представляет собой комбинированную полилинию всех |
description | Описание маршрута. |
warnings[] | Массив предупреждений для отображения при отображении маршрута. |
viewport | Ограничивающая рамка области просмотра полилинии. |
travelAdvisory | Дополнительная информация о маршруте. |
optimizedIntermediateWaypointIndex[] | Если вы установите для параметра |
localizedValues | Текстовые представления свойств |
routeToken | Веб-безопасный токен маршрута в кодировке base64, который можно передать в пакет SDK для навигации, который позволяет пакету навигации для навигации реконструировать маршрут во время навигации и, в случае изменения маршрута, соблюдать исходное намерение при создании маршрута путем вызова v2.computeRoutes. Клиенты должны рассматривать этот токен как непрозрачный большой двоичный объект. Он не предназначен для чтения или изменения. ПРИМЕЧАНИЕ. |
Метка маршрута
Метки для Route
, которые полезны для определения конкретных свойств маршрута для сравнения с другими.
перечисления | |
---|---|
ROUTE_LABEL_UNSPECIFIED | По умолчанию - не используется. |
DEFAULT_ROUTE | «Лучший» маршрут по умолчанию, возвращенный для расчета маршрута. |
DEFAULT_ROUTE_ALTERNATE | Альтернатива «лучшему» маршруту по умолчанию. Маршруты, подобные этому, будут возвращены, если указан параметр computeAlternativeRoutes . |
FUEL_EFFICIENT | Топливоэффективный маршрут. Маршруты, помеченные этим значением, оптимизированы для таких параметров Eco, как расход топлива. |
МаршрутЭтап
Содержит сегмент между via
путевыми точками.
Представление JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Поля | |
---|---|
distanceMeters | Протяженность участка маршрута, в метрах. |
duration | Продолжительность времени, необходимого для прохождения ноги. Если для Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « |
staticDuration | Продолжительность проезда по этапу, рассчитанная без учета условий движения. Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « |
polyline | Общая полилиния для этого отрезка, включающая полилинию каждого |
startLocation | Место начала этого этапа. Это местоположение может отличаться от указанного |
endLocation | Конечное место этой ноги. Это местоположение может отличаться от указанного |
steps[] | Массив шагов, обозначающих сегменты в пределах этой ветви. Каждый шаг представляет собой одну инструкцию навигации. |
travelAdvisory | Содержит дополнительную информацию, о которой должен быть проинформирован пользователь, например, возможные ограничения зоны движения на участке маршрута. |
localizedValues | Текстовые представления свойств |
stepsOverview | Обзорная информация о шагах в этом |
Полилиния
Инкапсулирует закодированную полилинию.
Представление JSON |
---|
{ // Union field |
Поля | |
---|---|
Поле объединения polyline_type . Инкапсулирует тип полилинии. По умолчанию используется encoded_polyline. polyline_type может быть только одним из следующих: | |
encodedPolyline | Строковое кодирование полилинии с использованием алгоритма кодирования полилинии |
geoJsonLinestring | Задает полилинию, используя формат GeoJSON LineString. |
МаршрутLegStep
Содержит сегмент RouteLeg
. Шаг соответствует одной инструкции навигации. Участки маршрута состоят из ступенек.
Представление JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Поля | |
---|---|
distanceMeters | Расстояние прохождения этого шага в метрах. В некоторых случаях это поле может не иметь значения. |
staticDuration | Продолжительность проезда через этот этап без учета условий движения. В некоторых случаях это поле может не иметь значения. Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « |
polyline | Полилиния, связанная с этим шагом. |
startLocation | Место начала этого шага. |
endLocation | Место окончания этого шага. |
navigationInstruction | Инструкции по навигации. |
travelAdvisory | Содержит дополнительную информацию, о которой должен быть проинформирован пользователь, например, возможные ограничения зоны движения на шаге ноги. |
localizedValues | Текстовые представления свойств |
transitDetails | Подробности, относящиеся к этому шагу, если выбран режим передвижения |
travelMode | Режим движения, используемый для этого шага. |
Маневр
Набор значений, определяющих действие навигации для текущего шага (например, повернуть налево, объединиться, прямо и т. д.).
перечисления | |
---|---|
MANEUVER_UNSPECIFIED | Не используется. |
TURN_SLIGHT_LEFT | Поверните немного влево. |
TURN_SHARP_LEFT | Резко повернуть налево. |
UTURN_LEFT | Сделайте левый разворот. |
TURN_LEFT | Поверните налево. |
TURN_SLIGHT_RIGHT | Поверните немного вправо. |
TURN_SHARP_RIGHT | Резко поверните направо. |
UTURN_RIGHT | Сделайте правый разворот. |
TURN_RIGHT | Поверните направо. |
STRAIGHT | Езжайте прямо. |
RAMP_LEFT | Возьмите левый пандус. |
RAMP_RIGHT | Возьмите правый пандус. |
MERGE | Слиться с трафиком. |
FORK_LEFT | Возьмите левую развилку. |
FORK_RIGHT | Возьмите правую вилку. |
FERRY | Сядьте на паром. |
FERRY_TRAIN | Сядьте на поезд, ведущий на паром. |
ROUNDABOUT_LEFT | Поверните налево на кольцевой развязке. |
ROUNDABOUT_RIGHT | Поверните направо на кольцевой развязке. |
DEPART | Начальный маневр. |
NAME_CHANGE | Используется для обозначения изменения названия улицы. |
RouteLegStepTravelAdvisory
Содержит дополнительную информацию, о которой должен быть проинформирован пользователь, например, возможные ограничения зоны движения на шаге ноги.
Представление JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Поля | |
---|---|
speedReadingIntervals[] | ПРИМЕЧАНИЕ. В настоящее время это поле не заполнено. |
RouteLegStepLocalizedValues
Текстовые представления определенных свойств.
Представление JSON |
---|
{ "distance": { object ( |
Поля | |
---|---|
distance | Пройденное расстояние представлено в текстовой форме. |
staticDuration | Продолжительность без учета условий движения, представленная в текстовом виде. |
RouteLegStepTransitDetails
Дополнительная информация для RouteLegStep
, относящаяся к TRANSIT
маршрутам.
Представление JSON |
---|
{ "stopDetails": { object ( |
Поля | |
---|---|
stopDetails | Информация о прибытии и отправлении остановок для шага. |
localizedValues | Текстовые представления свойств |
headsign | Указывает направление движения по этой линии, отмеченное на транспортном средстве или на остановке отправления. Направление часто является конечной станцией. |
headway | Указывает ожидаемое время как продолжительность между отправлениями с одной и той же остановки в это время. Например, при значении интервала в секундах, равном 600, вы ожидаете десятиминутное ожидание, если опоздаете на автобус. Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся на « |
transitLine | Информация о транзитной линии, используемой на этом этапе. |
stopCount | Количество остановок от отправления до остановки прибытия. Этот подсчет включает остановку прибытия, но не включает остановку отправления. Например, если ваш маршрут отправляется с остановки A, проходит через остановки B и C и прибывает на остановку D, stopCount вернет 3. |
tripShortText | Текст, который появляется в расписании и на вывесках для обозначения транзитной поездки для пассажиров. Текст должен однозначно идентифицировать поездку в течение служебного дня. Например, «538» — это |
ТранзитОстановкаДетали
Подробная информация об остановках общественного транспорта для RouteLegStep
Представление JSON |
---|
{ "arrivalStop": { object ( |
Поля | |
---|---|
arrivalStop | Информация об остановке прибытия на этап. |
arrivalTime | Расчетное время прибытия на шаг. Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: |
departureStop | Информация об остановке отправления на ступень. |
departureTime | Расчетное время выхода на этап. Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: |
ТранзитОстановка
Информация о транзитной остановке.
Представление JSON |
---|
{
"name": string,
"location": {
object ( |
Поля | |
---|---|
name | Название транзитной остановки. |
location | Расположение остановки, выраженное в координатах широта/долгота. |
TransitDetailsLocalizedValues
Локализованные описания значений RouteTransitDetails.
Представление JSON |
---|
{ "arrivalTime": { object ( |
Поля | |
---|---|
arrivalTime | Время в форматированном текстовом представлении с соответствующим часовым поясом. |
departureTime | Время в форматированном текстовом представлении с соответствующим часовым поясом. |
Локализованное время
Локализованное описание времени.
Представление JSON |
---|
{
"time": {
object ( |
Поля | |
---|---|
time | Время, указанное в виде строки в заданном часовом поясе. |
timeZone | Содержит часовой пояс. Значение представляет собой название часового пояса, определенное в базе данных часовых поясов IANA , например, «Америка/Нью-Йорк». |
Транзитная линия
Содержит информацию о транспортной линии, используемой на этом шаге.
Представление JSON |
---|
{ "agencies": [ { object ( |
Поля | |
---|---|
agencies[] | Транзитное агентство (или агентства), которое управляет этой транзитной линией. |
name | Полное название этой линии общественного транспорта, например, «8 Avenue Local». |
uri | URI для этой транзитной линии, предоставленный транспортным агентством. |
color | Цвет, обычно используемый в вывесках для этой линии. Представлено в шестнадцатеричном формате. |
iconUri | URI значка, связанного с этой строкой. |
nameShort | Краткое название этой транзитной линии. Обычно это имя представляет собой номер строки, например «M7» или «355». |
textColor | Цвет, обычно используемый в тексте на вывесках для этой строки. Представлено в шестнадцатеричном формате. |
vehicle | Тип транспортного средства, которое работает на этой транзитной линии. |
ТранзитАгентство
Транзитное агентство, управляющее транзитной линией.
Представление JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
Поля | |
---|---|
name | Название этого транзитного агентства. |
phoneNumber | Отформатированный номер телефона транспортного агентства в определенном формате. |
uri | URI транспортного агентства. |
ТранзитАвтомобиль
Информация о транспортном средстве, используемом в транзитных маршрутах.
Представление JSON |
---|
{ "name": { object ( |
Поля | |
---|---|
name | Название этого автомобиля с большой буквы. |
type | Тип используемого транспортного средства. |
iconUri | URI значка, связанного с этим типом транспортного средства. |
localIconUri | URI значка, связанного с этим типом транспортного средства, на основе вывесок местного транспорта. |
TransitVehicleType
Тип транспортных средств для транзитных маршрутов.
перечисления | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED | Неиспользованный. |
BUS | Автобус. |
CABLE_CAR | Транспортное средство, работающее на тросе, обычно на земле. Воздушные канатные дороги могут быть типа GONDOLA_LIFT . |
COMMUTER_TRAIN | Пригородная железная дорога. |
FERRY | Перевозить. |
FUNICULAR | Транспортное средство, которое поднимается по крутому склону тросом. Фуникулер обычно состоит из двух вагонов, каждый из которых служит противовесом другому. |
GONDOLA_LIFT | Воздушная канатная дорога. |
HEAVY_RAIL | Тяжелый рельс. |
HIGH_SPEED_TRAIN | Высокоскоростной поезд. |
INTERCITY_BUS | Междугородний автобус. |
LONG_DISTANCE_TRAIN | Поезд дальнего следования. |
METRO_RAIL | Легкорельсовый транспорт. |
MONORAIL | Монорельс. |
OTHER | Все остальные транспортные средства. |
RAIL | Железнодорожный. |
SHARE_TAXI | Маршрутное такси — это вид автобуса с возможностью высаживать и забирать пассажиров в любом месте своего маршрута. |
SUBWAY | Подземный легкорельсовый транспорт. |
TRAM | Надземный легкорельсовый транспорт. |
TROLLEYBUS | Троллейбус. |
RouteLegTravelAdvisory
Содержит дополнительную информацию, о которой пользователь должен быть проинформирован на этапе перехода, например, возможные ограничения зоны движения.
Представление JSON |
---|
{ "tollInfo": { object ( |
Поля | |
---|---|
tollInfo | Содержит информацию о платных проездах по конкретному |
speedReadingIntervals[] | Интервалы скорочтения с подробным описанием плотности трафика. Применимо в случае настроек маршрутизации Пример:
|
RouteLegLocalizedValues
Текстовые представления определенных свойств.
Представление JSON |
---|
{ "distance": { object ( |
Поля | |
---|---|
distance | Пройденное расстояние представлено в текстовой форме. |
duration | Продолжительность с учетом условий движения представлена в текстовом виде. Примечание. Если вы не запрашивали информацию о трафике, это значение будет таким же, как staticDuration. |
staticDuration | Продолжительность без учета условий движения, представленная в текстовом виде. |
ШагиОбзор
Предоставляет обзорную информацию о списке RouteLegStep
s.
Представление JSON |
---|
{
"multiModalSegments": [
{
object ( |
Поля | |
---|---|
multiModalSegments[] | Обобщенная информация о различных мультимодальных сегментах |
Мультимодальный сегмент
Предоставляет сводную информацию о различных мультимодальных сегментах RouteLeg.steps
. Мультимодальный сегмент определяется как один или несколько смежных RouteLegStep
, которые имеют один и тот же RouteTravelMode
. Это поле не заполняется, если RouteLeg
не содержит мультимодальных сегментов в шагах.
Представление JSON |
---|
{ "navigationInstruction": { object ( |
Поля | |
---|---|
navigationInstruction | NavigationInstruction для мультимодального сегмента. |
travelMode | Режим движения мультимодального сегмента. |
stepStartIndex | Соответствующий индекс |
stepEndIndex | Соответствующий индекс |
Область просмотра
Окно просмотра широта-долгота, представленное двумя диагонально противоположными low
и high
точками. Окно просмотра считается замкнутой областью, т.е. включает в себя свою границу. Границы широты должны находиться в диапазоне от -90 до 90 градусов включительно, а границы долготы должны находиться в диапазоне от -180 до 180 градусов включительно. Различные случаи включают в себя:
Если
low
=high
, окно просмотра состоит из этой единственной точки.Если
low.longitude
>high.longitude
, диапазон долготы инвертируется (окно просмотра пересекает линию долготы 180 градусов).Если
low.longitude
= -180 градусов иhigh.longitude
= 180 градусов, в окне просмотра отображаются все значения долготы.Если
low.longitude
= 180 градусов иhigh.longitude
= -180 градусов, диапазон долгот пуст.Если
low.latitude
>high.latitude
, диапазон широт пуст.
И low
, и high
должны быть заполнены, и представленное поле не может быть пустым (как указано в определениях выше). Пустое окно просмотра приведет к ошибке.
Например, это окно просмотра полностью закрывает Нью-Йорк:
{ "низкий": { "широта": 40,477398, "долгота": -74,259087}, "высокий": { "широта": 40,91618, "долгота": -73,70018 } }
Представление JSON |
---|
{ "low": { object ( |
Поля | |
---|---|
low | Необходимый. Нижняя точка окна просмотра. |
high | Необходимый. Верхняя точка смотрового окна. |
Маршрутлокализованные значения
Текстовые представления определенных свойств.
Представление JSON |
---|
{ "distance": { object ( |
Поля | |
---|---|
distance | Пройденное расстояние представлено в текстовой форме. |
duration | Продолжительность с учетом дорожных условий, представленная в текстовом виде. Примечание. Если вы не запрашивали информацию о трафике, это значение будет таким же, как staticDuration. |
staticDuration | Продолжительность без учета условий движения, представленная в текстовом виде. |
transitFare | Транзитный тариф представлен в текстовом виде. |
Результаты геокодирования
Содержит GeocodedWaypoints
для начальной, конечной и промежуточных путевых точек. Заполняется только для адресных путевых точек.
Представление JSON |
---|
{ "origin": { object ( |
Поля | |
---|---|
origin | Исходная геокодированная путевая точка. |
destination | Геокодированная путевая точка назначения. |
intermediates[] | Список промежуточных геокодированных путевых точек, каждая из которых содержит поле индекса, соответствующее отсчитываемому от нуля положению путевой точки в том порядке, в котором они были указаны в запросе. |
GeocodedWaypoint
Подробная информация о местах, используемых в качестве путевых точек. Заполняется только для адресных путевых точек. Включает сведения о результатах геокодирования для целей определения того, к какому адресу был геокодирован.
Представление JSON |
---|
{
"geocoderStatus": {
object ( |
Поля | |
---|---|
geocoderStatus | Указывает код состояния, полученный в результате операции геокодирования. |
type[] | Тип(ы) результата в виде нуля или более тегов типа. Поддерживаемые типы: https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types . |
partialMatch | Указывает, что геокодер не вернул точное совпадение с исходным запросом, хотя смог сопоставить часть запрошенного адреса. Вы можете проверить первоначальный запрос на наличие опечаток и/или неполного адреса. |
placeId | Идентификатор места для этого результата. |
intermediateWaypointRequestIndex | Индекс соответствующей промежуточной путевой точки в запросе. Заполняется только в том случае, если соответствующая путевая точка является промежуточной путевой точкой. |