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

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

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

  • В 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 .