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

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 .

Примеры

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

URL 

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

локон 

curl -L -X GET 'https://roads.googleapis.com/v1/nearestRoads?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796&key=YOUR_API_KEY'

Ответы

Для каждого корректного запроса Roads API вернет ответ в формате, указанном в URL-адресе запроса.

{
  "snappedPoints":
    [
      {
        "location":
          { "latitude": 60.170878428876755, "longitude": 24.94269540970182 },
        "originalIndex": 0,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.17087741412199, "longitude": 24.942695474405202 },
        "originalIndex": 1,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.170875416131736, "longitude": 24.942695601802203 },
        "originalIndex": 2,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
    ],
}

В ответе используется следующая схема.

NearestRoadsResponse

Поле Необходимый Тип Описание
необязательный Массив <SnappedPoint>

Массив привязанных точек. Иногда содержит несколько привязанных точек для одной и той же точки с разными идентификаторами мест (placeId) или местоположением.

Дополнительную информацию см. на сайте SnappedPoint .

SnappedPoint

Поле Необходимый Тип Описание
необходимый ШиротаДолготаБуквальный Дополнительную информацию см. в разделе LatitudeLongitudeLiteral .
необходимый нить

Уникальный идентификатор места. Все идентификаторы мест, возвращаемые API дорог, соответствуют участкам дорог.

необязательный число

Целочисленное значение, указывающее на соответствующее значение в исходном запросе. Каждое значение в запросе должно соответствовать зафиксированному значению в ответе. Однако, если вы установили interpolate=true или используете ближайшие дороги, то ответ может содержать больше координат, чем запрос. Интерполированные значения не будут иметь originalIndex . Эти значения индексируются с 0 , поэтому точка с originalIndex, равным 4 будет зафиксированным значением 5-й широты/долготы, переданной в параметр path. Точки ближайших дорог могут содержать несколько точек для одной и той же координаты с различным местоположением или placeId.

ШиротаДолготаБуквальный

Объект, описывающий конкретное местоположение с указанием широты и долготы в десятичных градусах.

Поле Необходимый Тип Описание
необходимый число

Широта в десятичных градусах

необходимый число

Долгота в десятичных градусах