탐색 포인트

지오코딩 응답 내의 navigation_points 필드에는 장소로 이동하는 데 유용한 포인트 목록이 포함됩니다. 특히 도로망에서 장소로 또는 장소에서 도로망으로 경로를 탐색할 때 시작 지점 또는 종료 지점으로 사용해야 합니다. 각 탐색 지점에는 다음 값이 포함됩니다.

  • location에는 탐색 지점의 위도, 경도 값이 포함됩니다. 이 위치는 항상 도로망과 매우 가까우며 장소를 오가는 데 이상적인 중지 또는 출발 지점을 나타냅니다. 장소가 위치한 도로 측면을 명확하게 표시하기 위해 의도적으로 도로의 중심선에서 약간 벗어난 지점이 표시됩니다.
  • restricted_travel_modes는 내비게이션 지점에서 액세스할 수 없는 이동 수단 목록입니다.
    • "DRIVE"는 운전 경로에 해당하는 이동 모드입니다.
    • "WALK"는 도보 경로에 해당하는 이동 모드입니다.
  • road_name에는 탐색 지점이 오프셋된 도로의 이름이 포함됩니다.

탐색 포인트는 정확한 위치가 있는 대부분의 장소(예: 상세 주소, 건물, 시설)에 대해 반환됩니다. 정확한 위치가 모호할 수 있는 도시나 지역과 같이 넓은 지역을 나타내는 장소는 경로 안내 지점을 반환하지 않을 수 있습니다.

이전 알림

이제 4월 17일부터는 탐색 포인트를 수신하기 위한 요청에 NAVIGATION_POINTS extra computations 매개변수를 제공해야 합니다. 클라이언트는 일부 탐색 포인트 내의 road_name 필드가 반환되고 각 탐색 포인트 내의 location 필드에 다음 네 가지 하위 필드 (lat, lng, latitude, longitude)가 있는지 확인하여 이를 테스트할 수 있습니다.

또한 location.latitude 및 location.longitude 필드가 아닌 location.lat 및 location.lng 필드로 이전해야 합니다. 향후 출시에서는 NAVIGATION_POINTS 추가 계산 매개변수가 포함되지 않은 요청의 경우 응답에 탐색 포인트가 포함되지 않으며 location.latitude 및 location.longitude 필드가 더 이상 반환되지 않습니다.

요청 세부정보

다음과 같은 유형의 요청에서 탐색 포인트를 가져올 수 있습니다.

이러한 요청의 경우 extra_computations=NAVIGATION_POINTS 매개변수를 제공합니다.

요청 예시

다음 쿼리는 장소 지오코딩을 사용하여 미국 캘리포니아 주 마운틴뷰에 있는 식당의 경로 포인트를 가져옵니다.

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

응답 예

위 쿼리의 응답은 내비게이션 포인트 배열을 보여줍니다.

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

의견

실험용으로 제공되는 기능입니다. [email protected]으로 의견을 보내 주세요.