가장 가까운 도로

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

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

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

선택사항 숫자

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

LatitudeLongitudeLiteral

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

필드 필수 유형 설명
required 숫자

위도(십진법 각도)
required 숫자

십진법 각도로 표기되는 경도