Точки навигации

Разработчики Европейской экономической зоны (ЕЭЗ)

Поле 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 .