경로를 따라 검색 개요
경로를 따라 검색 기능은 다음 Places (New) API에서 사용할 수 있습니다.
- 텍스트 검색 (신규)만 해당: 미리 정의된 이동 경로를 따라 장소를 검색합니다.
- 텍스트 검색 (신규) 및 주변 검색 (신규): 지정된 라우팅 출발지 위치에서 검색 결과의 각 장소까지의 라우팅 요약을 계산합니다.
- 텍스트 검색 (신규)만 해당: 미리 정의된 이동 경로를 따라 각 장소의 라우팅 요약을 계산합니다.
경로를 따라 검색
Routes API를 사용하여 두 위치 간의 이동 경로 를 계산합니다. Routes API는 자동차, 자전거, 이륜차, 대중교통 시스템 또는 도보 경로를 계산할 수 있습니다.
텍스트 검색 (신규)을 사용하면 이 계산된 경로를 사용하여 경로를 따라 검색을 실행할 수 있습니다. 이 옵션을 사용하면 Routes API에서 미리 계산된 경로를 텍스트 검색 (신규) 요청에 전달합니다. 그러면 응답에 검색 기준과 일치하고 지정된 경로 근처에 있는 장소가 포함됩니다.
경로를 따라 검색은 locationRestriction 또는 locationBias 요청 옵션을 사용하여 검색 결과에 편중하는 것과 비슷합니다. locationRestriction
은 표시 영역 경계 내에 있는 검색 결과를 반환하는 반면 locationBias는 표시 영역 외부에 있는 검색 결과를 반환할 수 있습니다. 그러나 locationBias 및 locationRestriction 옵션을 사용하면 검색 결과에 편중할 지역을 지정할 수 있지만 텍스트 검색의 경로를 따라 검색 기능을 사용하면 경로 출발지에서 경로 목적지까지 최소 우회 시간이 있는 검색 결과를 포함하도록 검색 결과에 편중할 수도 있습니다. 다중선과 함께 locationBias 또는 locationRestriction을 사용하여 검색 결과에 편중할 수 있습니다.
예를 들어 Routes API에서 경유지 라고 하는 출발지에서 Routes API에서 계산한 목적지까지의 경로를 고려해 보겠습니다.
경로를 따라 검색하면 출발지에서 목적지까지 우회 시간이 최소인 경로 근처의 장소를 반환하도록 검색이 편중됩니다. 이 예에서 A, B, C 지점은 검색에서 반환된 장소입니다.
라우팅 요약 계산
텍스트 검색(신규) 및 주변 검색(신규)은 요청에 지정된 라우팅 출발지 위치를 기반으로 응답의 각 장소까지의 라우팅 요약(즉, 기간 및 거리)을 계산할 수 있습니다. 라우팅 출발지를 지정하면 응답에 검색과 일치하는 장소 목록뿐만 아니라 라우팅 출발지에서 각 장소까지의 이동 시간과 거리도 포함됩니다.
다음 이미지에서 A, B, C 지점은 검색 응답에서 반환된 장소입니다.
결과의 각 장소에 대해 응답에는 라우팅 출발지에서 장소까지의 이동 시간과 거리가 포함됩니다(사용 가능한 경우).
기본적으로 이동 시간과 거리는 Routes API의 TRAFFIC_UNAWARE
옵션을 사용하여 계산됩니다. 선택적으로 라우팅 환경설정을 지정하여
실시간 교통상황 TRAFFIC_AWARE_OPTIMAL
또는 지연 시간이 줄어든 실시간 교통상황 TRAFFIC_AWARE
을 고려할 수 있습니다.
경로, 구간, 경유지 정보
Routes API에서 계산한 대로 경로를 구성하는 여러 구성요소가 있습니다.
경로는 다음 구성요소로 구성됩니다.
- Waypoint: 경로를 계산하려면 최소한 출발지와 목적지의 위치를 지정해야 합니다. 이러한 위치를 경로의 경유지로 정의합니다. 중간 경유지는 경로가 통과하도록 하려는 출발지와 목적지 사이의 위치입니다.
-
경로: 출발지 경유지에서 중간 경유지를 거쳐 목적지 경유지까지의 전체 이동입니다. 경로는 하나 이상의 구간으로 구성됩니다.
경로를 텍스트 검색에 전달할 때는 경로의 인코딩된 다중선을 Routes API에서 반환된 대로 전달합니다. 인코딩된 다중선은 경로의 다중선을 문자열로 나타낼 수 있는 위도 및 경도 지점의 인코딩된 목록입니다.
-
구간: 경로의 한 경유지에서 경로의 다음 경유지까지의 경로입니다. 각 구간은 하나 이상의 개별 단계 로 구성됩니다.
경로에는 각 경유지에서 다음 경유지까지의 경로에 대한 별도의 구간이 포함됩니다. 예를 들어 경로에 단일 출발지 경유지와 단일 목적지 경유지가 포함된 경우 경로에는 단일 구간이 포함됩니다.
출발지와 목적지 이후에 경로에 추가하는 각 추가 경유지(중간 경유지라고 함)에 대해 API는 별도의 구간을 추가합니다.
경로 및 경로 계산에 관한 자세한 내용은 Routes API를 참고하세요.
경로를 따라 검색으로 라우팅 요약 계산
라우팅 요약 계산을 경로를 따라 검색 과 결합할 수 있습니다. 이 경우 텍스트 검색 (신규)은 응답의 각 장소까지의 이동 시간과 거리를 반환한 다음 각 장소에서 경로의 최종 목적지까지의 이동 시간과 거리를 반환합니다. 이 계산은 지정된 경로에서 우회하여 검색 결과의 장소로 이동한 다음 최종 목적지로 계속 이동하는 경우 이동 시간과 거리를 제공하는 것으로 생각하면 됩니다.
예를 들어 Routes API에서 계산한 출발지에서 목적지까지의 다음 경로를 고려해 보겠습니다. 검색 기준과 함께 이 경로를 텍스트 검색 (신규) API에 전달합니다.
이 예에서 위치 A는 텍스트 검색 (신규)의 검색 결과에서 반환된 장소입니다. 응답의 각 장소에 대해 검색에는 해당 장소로 우회하는 데 필요한 기간 과 거리가 2구간 이동으로 포함됩니다.
- 첫 번째 구간에는 경로 출발지 에서 장소 까지의 이동 시간과 거리가 포함됩니다. 이 예에서는 출발지에서 장소 A까지입니다.
- 두 번째 구간에는 장소 에서 경로 목적지 까지의 이동 시간과 거리가 포함됩니다. 이 예에서는 A에서 목적지까지입니다.
그런 다음 응답의 정보를 사용하여 우회 기간 및 거리 를 계산할 수 있습니다. 여기서
- \(t_{OD}\) 는 출발지에서 목적지까지의 이동 기간 이고 \(s_{OD}\) 는 출발지에서 목적지까지의 이동 거리 입니다.
- \(t_{OA}\) 는 출발지에서 A까지의 이동 기간 이고 \(s_{OA}\) 는 출발지에서 A까지의 이동 거리 입니다.
- \(t_{AD}\) 는 A에서 목적지까지의 이동 기간 이고 \(s_{AD}\) 는 A에서 목적지까지의 이동 거리 입니다.
우회 기간 은 원래 이동(출발지에서 목적지까지)과 새 이동 (출발지에서 A를 통해 목적지까지) 간의 기간 차이 입니다.
우회 거리 는 원래 이동(출발지에서 목적지까지)과 새 이동 (출발지에서 A를 통해 목적지까지) 간의 거리 차이 입니다.