탐색 포인트

유럽 경제 지역 (EEA) 개발자

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

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

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

이전 알림

이제 4월 17일부터 탐색 포인트를 받으려면 요청에 NAVIGATION_POINTS 추가 계산 매개변수를 제공해야 합니다. 클라이언트는 일부 탐색 포인트 내의 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"]
    }
  ]
}

의견

실험용으로 제공되는 기능입니다. geocoding-feedback-channel@google.com으로 의견을 보내주시면 감사하겠습니다.