선택한 트래픽 환경설정에 따라 경로 세부정보의 정확성과 요청 성능의 균형이 유지됩니다. 요청할 때는 최대한 정확한 결과를 반환하는 것이 좋은지 아니면 최대한 빨리 결과를 반환하는 것이 좋은지 판단해야 합니다. Routes API는 응답 데이터의 품질과 응답 지연 시간을 제어할 수 있는 옵션을 제공합니다.
트래픽 데이터 수준 설정
Routes API는 경로 계산을 위한 라우팅 환경설정을 지정할 수 있는 RoutingPreference (REST) 및 RoutingPreference(gRPC)를 제공합니다. 이러한 환경설정은 경로 계산에 교통상황을 반영하는 정도에 따라 다릅니다. 각 경로 우선순위에 따라 경로 품질, 예상 도착 시간, 응답 지연 시간과 관련하여 어느 정도 다른 결과가 생성됩니다.
교통상황은 교통 흐름의 비율을 나타냅니다. 예를 들면 다음과 같습니다.
- 정체가 없으면 교통상황이 정상으로 간주되며 트래픽이 방해받지 않고 정상 속도로 흐릅니다.
- 출퇴근 시간에 접어들면 교통량이 증가하여 교통이 느려지고 경미하거나 보통 수준의 교통 상황이 발생합니다.
- 차량이 밀집된 정체 상황에서는 흐름 속도가 급격히 느려져 트래픽이 증가합니다.
트래픽을 인식하지 못함
TRAFFIC_UNAWARE 라우팅 환경설정을 설정하면 현재 교통상황을 고려하지 않고 경로가 계산됩니다. 이 라우팅 환경설정은 가장 낮은 응답 지연 시간을 제공합니다 (응답이 가장 빠르게 반환됨).
TRAFFIC_UNAWARE은 기본 설정입니다.
응답에서 각 항목의 의미는 다음과 같습니다.
ETA는
duration응답 속성에 포함되어 있습니다.duration및staticDuration응답 속성에는 동일한 값이 포함됩니다.
응답이 가장 빠르게 반환되기를 원하고 대략적인 라우팅 세부정보가 충분한 경우 이 라우팅 환경설정을 사용하세요.
트래픽 인식
TRAFFIC_AWARE 라우팅 환경설정을 설정하면 현재 교통 상황을 고려하여 경로가 계산됩니다. 따라서 경로 및 경로 세부정보가 실제 상황을 더 정확하게 반영합니다. 데이터 품질이 향상되면 응답 지연 시간이 늘어나므로 성능 최적화를 적용하여 지연 시간을 최대한 줄입니다.
응답에서 각 항목의 의미는 다음과 같습니다.
실시간 트래픽을 고려한 도착 예정 시간은
duration응답 속성에 포함되어 있습니다.staticDuration응답 속성에는 교통 상황을 고려하지 않은 경로를 통한 이동 시간(분)이 포함됩니다.
TRAFFIC_UNAWARE보다 정확한 라우팅 세부정보를 원하지만 응답이 지연 시간이 약간 증가하여 반환되는 것은 괜찮다면 이 라우팅 환경설정을 사용하세요.
트래픽 인식 최적
TRAFFIC_AWARE_OPTIMAL 라우팅 환경설정을 설정하면 현재 교통 상황을 고려하여 경로가 계산되지만 성능 최적화는 적용되지 않습니다. 이 모드에서는 서버가 도로망을 더 철저하게 검색하여 최적의 경로를 찾습니다.
TRAFFIC_AWARE_OPTIMAL 경로 탐색 환경설정은 maps.google.com 및 Google 지도 모바일 앱에서 사용하는 모드와 같습니다.
Compute Route Matrix와 함께 이 옵션을 사용하면 요청의 요소 수 (출발지 수 x 목적지 수)가 100을 초과할 수 없습니다. Compute Route Matrix 한도에 관한 자세한 내용은 경로 매트릭스 계산을 참고하세요.
응답에서 각 항목의 의미는 다음과 같습니다.
실시간 트래픽을 고려한 도착 예정 시간은
duration응답 속성에 포함되어 있습니다.staticDuration응답 속성에는 교통 상황을 고려하지 않은 경로를 통한 이동 시간(분)이 포함됩니다.
이 라우팅 환경설정은 가장 긴 응답 지연 시간을 제공합니다 (즉, 응답이 가장 긴 지연으로 반환됨). 응답 시간이 얼마가 걸리든 가장 높은 품질의 결과를 얻으려면 이 라우팅 환경설정을 사용하세요.
출발 시간 설정의 효과
원하는 경우 departureTime 속성을 사용하여 이동의 출발 시간을 설정할 수 있습니다. departureTime 속성을 설정하지 않으면 기본값은 요청 시점입니다.
TRAFFIC_UNAWARE의 경우 경로 및 소요 시간이 도로망 및 평균 시간과 무관한 교통상황을 기반으로 선택되므로departureTime를 설정할 수 없습니다.실시간 교통 상황을 고려하는
TRAFFIC_AWARE및TRAFFIC_AWARE_OPTIMAL의 경우departureTime이 현재에 가까울수록 실시간 교통정보가 더 중요해집니다. 출발 시간을 더 늦게 설정할수록 이전 트래픽 상태가 더 많이 고려됩니다.
라우팅 환경설정 설정 예시
다음 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" }
다중선의 트래픽 구성
Routes API를 사용하면 교통 인식 다중선을 따라 교통 상황에 관한 정보를 요청할 수 있습니다. 자세한 내용은 다중선 요청을 참고하세요.