경로 검색 개요
경로 검색 기능은 다음 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에서 반환된 경로의 인코딩된 폴리라인을 전달합니다. 인코딩된 다중선은 경로의 다중선을 문자열로 나타낼 수 있는 위도 및 경도 지점의 인코딩된 목록입니다.
-
구간: 경로에 있는 한 경유지에서 다음 경유지까지의 경로입니다. 각 구간은 하나 이상의 개별 단계로 구성됩니다.
경로에는 각 경유지에서 다음 경유지까지의 경로에 대한 개별 구간이 포함됩니다. 예를 들어 경로에 출발 웨이포인트 1개와 도착 웨이포인트 1개가 포함된 경우 경로에 구간이 1개 포함된 것입니다.
출발지와 도착지 뒤에 경로에 추가하는 추가 중간 지점(중간 중간 지점)마다 API는 별도의 구간을 추가합니다.
경로 및 경로 계산에 대한 자세한 내용은 Routes API를 참고하세요.
경로를 따라 검색하여 경로 요약 계산
경로 요약 계산을 경로를 따라 검색과 결합할 수 있습니다. 이 경우 텍스트 검색 (신규)은 응답에서 각 장소까지의 이동 시간과 거리를 반환한 다음 각 장소에서 경로의 최종 목적지까지의 거리를 반환합니다. 이 계산은 지정된 경로에서 우회하여 검색 결과의 특정 장소로 이동했다가 최종 목적지까지 계속할 경우 이동 시간과 거리를 제공하는 것으로 생각하면 됩니다.
예를 들어 Routes API에서 계산한 출발지에서 목적지로의 다음 경로를 생각해 보겠습니다. 이 경로를 검색 기준과 함께 Text Search (New) API에 전달합니다.
이 예에서 위치 A는 텍스트 검색 (신규)의 검색 결과에 반환된 장소입니다. 응답의 각 장소마다 검색에는 해당 장소까지 우회하는 데 필요한 시간과 거리가 두 구간 이동으로 포함됩니다.
- 첫 번째 구간에는 경로 출발지에서 장소까지의 이동 시간과 거리가 포함됩니다. 이 예시에서는 출발지에서 장소 A로 이동합니다.
- 두 번째 구간에는 장소에서 경로 목적지까지의 이동 시간과 거리가 포함됩니다. 이 예에서는 A에서 목적지로 이동합니다.
응답의 정보를 바탕으로 우회 경로의 시간 및 거리를 계산할 수 있습니다. 여기서
- \(t_{OD}\) 는 출발지에서 목적지까지의 이동 시간이고, \(s_{OD}\) 는 출발지에서 목적지까지의 이동 거리입니다.
- \(t_{OA}\) 은 출발지에서 A까지의 이동 시간이고 \(s_{OA}\) 는 출발지에서 A까지의 이동 거리입니다.
- \(t_{AD}\) 는 A에서 목적지까지의 이동 시간이고, \(s_{AD}\) 는 A에서 목적지까지의 이동 거리입니다.
우회 경로 시간은 원래 경로(출발지에서 목적지까지)와 새 경로 (출발지에서 목적지까지 A를 경유) 간의 시간 차이입니다.
우회 거리는 원래 이동(출발지에서 목적지까지)과 새 이동 (출발지에서 목적지까지 A를 경유) 사이의 거리 차이입니다.