경로에 따른 검색 개요

경로 검색 기능은 다음 Places(신규) API에서 사용할 수 있습니다.

• 텍스트 검색 (신규)만 해당: 사전 정의된 경로를 따라 장소를 검색합니다. 있습니다.
• 텍스트 검색 (신규) 및 주변 검색 (신규): 경로를 계산합니다. 지정된 경로 출발지 위치에서 검색의 각 위치로의 요약 있습니다.
• 텍스트 검색(신규)만 해당: 사전 정의된 이동 경로를 따라 각 장소의 경로 요약을 계산합니다.

경로에서 검색

Routes API를 사용하여 이동 경로를 계산합니다. 있습니다. Routes API는 자동차, 자전거, 이동 수단의 경로를 계산할 수 있습니다. 오토바이, 대중교통 시스템 또는 도보용 자동차

참고: Places API에서는 대중교통 시스템 경로가 지원되지 않습니다.

텍스트 검색(신규)을 사용하면 계산된 경로를 사용하여 경로를 따라 검색할 수 있습니다. 이 옵션을 사용하면 미리 계산된 경로를 Routes API에서 Text Search (신규) 요청으로 이동합니다. 응답에는 검색 기준과 일치하고 지정된 있습니다.

경로를 따라 검색하는 것은 locationRestriction 또는 locationBias 요청 옵션을 사용하여 검색 결과에 편향을 적용하는 것과 유사합니다. locationRestriction는 표시 영역 경계 내에 있는 검색 결과를 반환하지만 locationBias는 표시 영역 외부의 검색 결과를 반환할 수 있습니다. 그러나 locationBias 및 locationRestriction 옵션을 사용하면 검색 결과에 편향이 적용되도록 지역을 지정할 수 있지만 텍스트 검색의 경로 검색 기능을 사용하면 경로 출발지에서 경로 도착지까지의 우회 시간이 가장 짧은 검색 결과를 포함하도록 검색 결과에 편향이 적용되도록 할 수도 있습니다. 폴리라인과 함께 locationBias 또는 locationRestriction를 사용하여 검색 결과에 편향을 줄 수 있습니다.

예를 들어 Routes API에서 중간 지점이라고 하는 출발지에서 Routes API에서 계산한 목적지로의 경로를 생각해 보겠습니다.

경로를 따라 검색하면 출발지에서 목적지까지의 우회 시간이 최소인 경로 근처의 장소가 반환되도록 검색이 편향됩니다. 이 예를 들어 A, B, C는 검색에서 반환된 장소입니다.

경로 계산 요약

텍스트 검색 (신규) 및 주변 검색 (신규)은 각 경로까지의 소요 시간 및 거리를 의미하는 라우팅 요약을 계산합니다. 지정된 라우팅 출발지 위치를 기준으로 응답의 요청을 수행합니다. 경로 출발지를 지정하면 응답에 검색어와 일치하는 장소 목록뿐만 아니라 경로 출발지에서 각 장소까지의 이동 시간과 거리도 포함됩니다.

다음 이미지에서 점 A, B, C는 검색에서 반환된 장소입니다. 응답:

결과의 각 장소에 대한 응답에는 이동 시간 및 경로 출발지에서 장소까지의 거리(해당하는 경우)

참고: 이는 라우팅 정보의 추정치일 뿐입니다. 단계별 경로 안내를 포함한 실제 경로 세부정보를 가져오려면 Routes API를 사용하세요.

기본적으로 이동 시간 및 거리는 Routes API의 TRAFFIC_UNAWARE 옵션을 사용하여 계산됩니다. 원하는 경우 계산 중에 실시간 교통상황 TRAFFIC_AWARE_OPTIMAL 또는 지연 시간이 줄어든 실시간 교통상황 TRAFFIC_AWARE을 고려하도록 경로 설정을 지정할 수 있습니다.

참고: TRAFFIC_AWARE 및 TRAFFIC_OPTIMAL는 DRIVE 및 TWO_WHEELER 이동 모드에만 적용됩니다. 경로 환경설정이 가 지원되지 않는 이동수단으로 지정된 경우, 경로 요약 계산은 기본적으로 TRAFFIC_UNAWARE 옵션. TWO_WHEELER가 지원되지 않는 리전의 경우 API는 비어 있는 라우팅 요약입니다.

TRAFFIC_AWARE 경로 환경설정을 설정하면 교통 상황을 고려하여 경로가 계산됩니다. 따라서 경로와 경로 세부정보가 실제 상황을 더 정확하게 반영합니다. 이러한 데이터 품질 향상은 대응을 희생해야 하기 때문입니다. 지연 시간을 크게 줄이는 데 성능 최적화가 적용됩니다. 이 TRAFFIC_AWARE_OPTIMAL 교통상황을 고려하여 경로가 계산되지만 성능 최적화가 적용되지 않습니다. 이 모드에서는 서버가 도로망을 더 철저하게 검색하여 최적의 경로를 찾습니다.

경로, 구간 및 경유지 정보

Routes API에서 계산한 여러 구성요소가 경로를 구성합니다.

경로는 다음 구성요소로 구성됩니다.

• 경유지: 경로를 계산하기 위해 최소한 확인할 수 있습니다 이러한 위치를 경유지로 경로 중간 경유지는 경로가 통과하도록 지정하는 출발지와 목적지 사이의 위치입니다.

• 경로: 출발 웨이포인트에서 중간 웨이포인트를 거쳐 목적지 웨이포인트까지의 전체 여정입니다. 경로는 이상의 다리.

  텍스트 검색에 경로를 전달할 때는 Routes API에서 반환한 경로의 인코딩된 폴리라인을 전달합니다. 인코딩된 폴리라인은 위도 및 경도 점의 인코딩된 목록으로, 경로의 폴리라인을 문자열로 반환합니다.

• 구간: 경로의 한 웨이포인트에서 경로의 다음 웨이포인트로 이어지는 경로입니다. 각 구간은 하나 이상의 개별 단계로 구성됩니다.

  경로에는 각 경유지에서 다음 경유지까지의 경로에 대한 개별 구간이 포함됩니다. 예를 들어 경로에 하나의 출발지 경유지와 하나의 경유지가 포함된 경우 목적지가 있다면 경로에 단일 구간이 포함됩니다.

  출발지와 목적지 뒤에 경로에 추가하는 각 경유지에 대해 중간 경유지라고 하는 경우 API는 별도의 구간을 추가합니다.

경로 및 경로 계산에 대한 자세한 내용은 경로 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를 경유) 간의 시간 차이입니다.

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

우회 거리는 원래 경로(출발지에서 목적지까지)와 새 경로(출발지에서 목적지까지 A를 경유)의 거리 차이입니다.

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$