Поле navigation_points
в ответе Geocoding содержит список точек, которые полезны для навигации к месту. В частности, их следует использовать как начальные или конечные точки при маршрутизации по дорожной сети от или к месту. Каждая навигационная точка содержит следующие значения:
-
location
содержит значение широты и долготы точки навигации. Это местоположение всегда будет очень близко к дорожной сети и представляет собой идеальную остановку или отправную точку для навигации в место и из него. Точка намеренно немного смещена от центральной линии дороги, чтобы четко обозначить сторону дороги, где находится это место. -
restricted_travel_modes
— это список режимов передвижения, при которых точка навигации недоступна: -
"DRIVE"
— режим движения, соответствующий указаниям по проезду. -
"WALK"
— режим передвижения, соответствующий пешеходным маршрутам. -
road_name
содержит название дороги, относительно которой смещена точка навигации.
Навигационные точки возвращаются для большинства мест с точным местоположением, таких как адреса улиц, здания и учреждения. Места, представляющие большие площади, такие как города и регионы, где точное местоположение может быть неоднозначным, могут не возвращать никаких навигационных точек.
Уведомление о миграции
Начиная с 17 апреля, теперь необходимо предоставить параметр дополнительных вычислений NAVIGATION_POINTS
в запросе на получение навигационных точек. Клиенты могут проверить это, подтвердив, что поле road_name
в некоторых навигационных точках возвращается и что поле location
в каждой навигационной точке имеет следующие четыре подполя ( lat
, lng
, latitude
, longitude
).
Кроме того, необходимо перейти на поля location.lat
и location.lng
вместо полей location.latitude
и location.longitude
. В будущем выпуске запросы, не содержащие параметр дополнительных вычислений NAVIGATION_POINTS
, не будут включать в ответ никаких навигационных точек, а поля location.latitude
и location.longitude
больше не будут возвращаться.
Запросить подробности
Получить навигационные точки можно в следующих типах запросов:
Для любого из этих запросов вы указываете этот параметр: extra_computations=NAVIGATION_POINTS
.
Пример запроса
Следующий запрос использует геокодирование места для получения точек навигации для ресторана в Маунтин-Вью, Калифорния, США:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY
Пример ответа
Ответ на запрос выше показывает массив точек навигации:
{
"navigation_points": [
{
"location": {
"lat": 37.3940894,
"lng": -122.0788389,
},
"restricted_travel_modes": ["WALK"],
"road_name": "Castro Street"
},
{
"location": {
"lat": 37.394273,
"lng": -122.0793078,
},
"restricted_travel_modes": ["WALK"],
"road_name": "Wild Cherry Lane"
},
{
"location": {
"lat": 37.3941202,
"lng": -122.0789189,
},
"restricted_travel_modes": ["DRIVE"]
}
]
}
Обратная связь
Это экспериментальная функция. Мы будем признательны за обратную связь по адресу geocoding-feedback-channel@google.com .