Все готово!

Прежде чем приступить к разработке, ознакомьтесь с документацией для разработчиков.

Активировать Google Maps Roads API

Чтобы помочь вам освоиться, мы покажем, как выполнить некоторые необходимые действия в консоли разработчика Google:

  1. Создание или выбор проекта
  2. Активировать Google Maps Roads API
  3. Создание соответствующих ключей

Ближайшие дороги

Интерфейс Google Maps Roads API воспринимает до 100 независимых координат и возвращает ближайший участок дороги для каждой точки. Передаваемые точки не обязательно должны быть частью непрерывного пути.

Если вы работаете с последовательными точками GPS, пользуйтесь службой привязки к дорогам.

Запросы

Запрос на ближайшие участки дорог отправляется по протоколу HTTPS и выглядит следующим образом:

https://roads.googleapis.com/v1/nearestRoads?parameters&key=YOUR_API_KEY

Использование параметров

Обязательные параметры

  • points – список, состоящий из парных значений координат широты и долготы. Значения широты и долготы должны быть разделены запятыми. Отдельные пары координат должны разделяться вертикальной чертой: "|". Например:points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
  • key – ключ API вашего приложения. Приложение должно выполнять автоматическую аутентификацию при каждой отправке запроса в Google Maps Roads API, указывая ключ API в каждом запросе. См. дополнительную информацию о получении ключа.

Ответы

Для каждого допустимого запроса Google Maps Roads API возвращает данные в формате, указанном в URL-адресе запроса. В ответе службы привязки к дорогам могут содержаться следующие элементы.

  • snappedPoints – массив привязанных точек. Каждая точка состоит из следующих полей.
    • location – содержит значение latitude и longitude.
    • originalIndex – целое число, обозначающее соответствующее значение в исходном запросе. Каждая точка в запросе связана максимум с двумя участками в ответе.
      • Если поблизости дорог нет, участок не возвращается.
      • Если ближайшая дорога односторонняя, возвращается один участок.
      • Если ближайшая дорога двусторонняя, возвращаются два участка.
    • placeId – уникальный идентификатор места. Все идентификаторы мест, возвращенные Google Maps Roads API, будут соответствовать участкам дороги. [Идентификаторы мест] можно использовать и с другими API-интерфейсами Google, включая Google Places API и Google Maps JavaScript API. Например, чтобы получить названия дорог для привязанных точек, возвращенных Google Maps Roads API, следует передать placeId в Google Places API или Google Maps Geocoding API. В Google Maps Roads API можно передавать placeId в запросе для определения ограничений скорости на указанном участке дороги.

Пример запроса

Следующий запрос возвращает ряд участков дорог с учетом указанного списка координат.

Запрос

https://roads.googleapis.com/v1/nearestRoads?points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796&key=YOUR_API_KEY

Ответ

{
  "snappedPoints": [
    {
      "location": {
        "latitude": 60.170877918672588,
        "longitude": 24.942699821922421
      },
      "originalIndex": 0,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170876898776406,
        "longitude": 24.942699912064771
      },
      "originalIndex": 1,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170874902634374,
        "longitude": 24.942700088491474
      },
      "originalIndex": 2,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    }
  ]
}

Оставить отзыв о...

Текущей странице
Google Maps Roads API
Google Maps Roads API
Нужна помощь? Обратитесь в службу поддержки.