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" }