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

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

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