가장 가까운 도로

Roads API는 최대 100개의 독립된 좌표를 가져와 각 지점의 가장 가까운 도로 구간을 반환합니다. 전달된 지점은 연속 경로의 일부일 필요가 없습니다.

순차적 GPS 지점을 사용하는 경우 Snap to Roads를 사용하세요.

요청

가장 가까운 도로에 대한 요청은 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

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

필드 필수 유형 설명
선택사항 Array<SnappedPoint>

스냅된 지점의 배열입니다. 때로는 placeId 또는 위치가 다른 동일한 지점에 대해 여러 개의 스냅된 지점이 포함됩니다.

자세한 내용은 SnappedPoint를 참고하세요.

SnappedPoint

필드 필수 유형 설명
필수 LatitudeLongitudeLiteral 자세한 내용은 LatitudeLongitudeLiteral 을 참고하세요.
필수 문자열

장소의 고유 식별자입니다. Roads API에서 반환된 모든 장소 ID는 도로 구간에 해당합니다.

선택사항 숫자

원래 요청의 해당 값을 나타내는 정수입니다. 요청의 각 값은 응답의 스냅된 값에 매핑되어야 합니다. 하지만 interpolate=true를 설정했거나 가장 가까운 도로를 사용하는 경우 응답에 요청보다 많은 좌표가 포함될 수 있습니다. 보간된 값에는 `originalIndex`originalIndex가 없습니다. 이러한 값은 0부터 색인이 생성되므로 originalIndex가 4인 지점은 경로 매개변수에 전달된 5번째 위도/경도의 스냅된 값입니다. 가장 가까운 도로 지점에는 위치 또는 placeId가 다른 단일 좌표에 대한 여러 지점이 포함될 수 있습니다.

LatitudeLongitudeLiteral

십진법 각도로 위도와 경도를 사용하여 특정 위치를 설명하는 객체입니다.

필드 필수 유형 설명
필수 숫자

십진법 각도로 표기되는 위도입니다.
필수 숫자

십진법 각도로 표기되는 경도입니다.