가장 가까운 도로

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

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

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

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

선택사항 숫자

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

LatitudeLongitudeLiteral

십진수 위도와 경도로 특정 위치를 설명하는 객체입니다.

필드 필수 유형 설명
required 숫자

위도(십진법)
required 숫자

경도(십진법 각도)