Routes Preferred API는 경로 계산을 위한 세 가지 경로 설정을 제공합니다. 경로 계산에 교통 상황을 반영하는 정도가 다릅니다. 각 경로 설정은 경로 품질, 예상 도착 시간, 응답 지연 시간과 관련하여 어느 정도 다른 결과를 생성합니다.
교통상황 정보
교통상황은 교통 흐름의 비율을 나타냅니다. 예를 들면 다음과 같습니다.
정체가 없으면 교통상황이 정상으로 간주되며 트래픽이 방해받지 않고 정상 속도로 흐릅니다.
출퇴근 시간에 접어들면 교통량이 증가하여 교통이 느려지고 경미하거나 보통 수준의 교통 상황이 발생합니다.
차량이 밀집된 정체 상황에서는 흐름 속도가 급격히 느려져 트래픽이 증가합니다.
트래픽을 인식하지 못함
TRAFFIC_UNAWARE 경로 설정을 지정하면 교통 상황을 고려하지 않고 경로가 계산됩니다. 이 라우팅 환경설정은 가장 낮은 응답 지연 시간을 제공합니다(응답이 가장 빠르게 반환됨).
응답이 가장 빠르게 반환되기를 원하고 대략적인 라우팅 세부정보가 충분한 경우 이 라우팅 환경설정을 사용하세요.
트래픽 인식
TRAFFIC_AWARE 경로 설정을 지정하면 교통 상황을 고려하여 경로가 계산됩니다. 따라서 경로와 경로 세부정보가 실제 상황을 더 정확하게 반영합니다. 데이터 품질이 향상되면 응답 지연 시간이 늘어나므로 성능 최적화가 적용되어 지연 시간을 크게 줄입니다.
더 정확한 라우팅 세부정보를 원하지만 응답이 지연 시간이 약간 증가하여 반환되는 것은 괜찮다면 이 라우팅 환경설정을 사용하세요.
트래픽 인식 최적
TRAFFIC_AWARE_OPTIMAL 라우팅 환경설정을 설정하면 교통 상황을 고려하여 경로가 계산되지만 실적 최적화는 적용되지 않습니다. 이 모드에서는 서버가 도로망을 더 철저하게 검색하여 최적의 경로를 찾습니다.
이 라우팅 환경설정은 가장 긴 응답 지연 시간을 제공합니다(즉, 응답이 가장 긴 지연으로 반환됨). 응답 시간이 얼마인지와 관계없이 최고 품질의 결과를 얻으려면 이 라우팅 환경설정을 사용하세요.
예
다음 JSON 코드는 요청 메시지 항목 본문에서 라우팅 환경설정을 설정하는 방법을 보여줍니다.
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }