선택한 트래픽 환경설정에 따라 다음 두 가지 방법 중 하나로 경로 세부정보의 정확성과 요청 성능의 균형이 유지됩니다.
트래픽 인식: 최대한 정확한 결과를 반환합니다 (지연 시간 증가).
트래픽 인식 불가: 최대한 빨리 결과를 반환합니다 (최저 지연 시간).
요청할 때는 최대한 정확한 결과를 반환하는 것이 좋은지 아니면 최대한 빨리 결과를 반환하는 것이 좋은지 판단해야 합니다. Routes API는 응답 데이터의 품질과 응답 지연 시간을 제어할 수 있는 옵션을 제공합니다.
트래픽 수준을 설정하는 방법
Routes API는 경로 계산을 위한 라우팅 환경설정을 지정할 수 있는 RoutingPreference (REST) 및 RoutingPreference(gRPC)를 제공합니다.
기본값은 트래픽을 인식하지 않는 결과입니다. TRAFFIC_UNAWARE
, TRAFFIC_AWARE
, TRAFFIC_AWARE_OPTIMAL
라우팅 환경설정을 사용하여 트래픽 옵션을 선택합니다. 각 경로 설정에 따라 경로 품질, 예상 도착 시간, 응답 지연 시간이 달라집니다.
교통상황
교통상황은 트래픽 흐름의 비율을 나타냅니다.
일반적인 트래픽: 정상 속도로 흐르는 트래픽이 정체되지 않습니다.
경미~중간 수준의 트래픽: 정체가 증가하고 트래픽이 느린 속도로 흐릅니다.
교통량 많음: 심각한 정체로 인해 교통 속도가 크게 감소합니다.
트래픽을 인식하지 못함
TRAFFIC_UNAWARE
은 기본 설정입니다. 응답이 가장 빠르게 반환되기를 원하고 대략적인 라우팅 세부정보가 충분한 경우 이 라우팅 환경설정을 사용하세요.
TRAFFIC_UNAWARE
경로는 현재 교통상황을 고려하지 않고 계산됩니다. 이 라우팅 환경설정을 사용하면 가장 빠른 요청 응답(최소 지연 시간)이 발생합니다.
TRAFFIC_UNAWARE
를 선택하면 현재 도로상황이 아닌 도로망 및 평균 시간과 무관한 교통상황을 기반으로 경로 및 소요 시간이 선택됩니다. 따라서 경로에는 일시적으로 폐쇄된 도로가 포함될 수 있습니다. 지정된 요청의 결과는 도로망의 변화, 평균 교통상황의 업데이트 및 분산된 서비스 특성으로 인해 시간이 지남에 따라 달라질 수도 있습니다. 거의 동일한 경로 간에도 언제든지 또는 수시로 결과가 달라질 수 있습니다.
표시되는 응답은 다음과 같습니다.
duration
- 경로의 도착 예정 시간이 포함됩니다.staticDuration
: 이전 교통 정보만 고려한 경로의 도착 예정 시간입니다.TRAFFIC_UNAWARE
의 경우duration
와 동일한 값이 포함됩니다.
트래픽 인식
TRAFFIC_UNAWARE
보다 정확한 라우팅 세부정보를 원하지만 응답이 지연 시간이 약간 증가하여 반환되는 것은 괜찮다면 이 라우팅 환경설정을 사용하세요.
TRAFFIC_AWARE
라우팅 환경설정을 설정하면 서비스는 현재 교통 상황을 고려하여 경로를 계산합니다. 따라서 경로 및 경로 세부정보가 실제 상황을 더 정확하게 반영합니다. 데이터 품질이 향상되면 응답 지연 시간이 늘어나므로 성능 최적화가 적용되어 지연 시간을 크게 줄입니다.
표시되는 응답은 다음과 같습니다.
duration
: 실시간 교통정보를 고려한 도착 예정 시간입니다.staticDuration
이전 교통정보만 고려한 경로의 도착 예정 시간입니다.
트래픽 인식 최적
응답 시간이 얼마든지 간에 최고 품질의 결과를 얻으려면 이 라우팅 환경설정을 사용하세요. 이 라우팅 환경설정은 응답을 반환하는 데 가장 오래 지연됩니다 (지연 시간이 가장 큼).
TRAFFIC_AWARE_OPTIMAL
라우팅 환경설정을 설정하면 서비스는 현재 트래픽 상태를 고려하여 경로를 계산하지만 성능 최적화는 적용하지 않습니다. 이 모드에서는 서버가 도로망을 더 철저하게 검색하여 최적의 경로를 찾습니다.
TRAFFIC_AWARE_OPTIMAL
경로 탐색 환경설정은 maps.google.com 및 Google 지도 모바일 앱에서 사용하는 모드와 같습니다.
Compute Route Matrix와 함께 이 옵션을 사용하면 요청의 요소 수 (출발지 수 x 목적지 수)가
- Compute Route Matrix 한도에 관한 자세한 내용은 경로 매트릭스 계산을 참고하세요.
표시되는 응답은 다음과 같습니다.
duration
: 실시간 교통정보를 고려한 경로의 예상 도착 시간입니다.staticDuration
: 이전 교통 정보만 고려한 경로의 도착 예정 시간입니다.
출발 시간 설정 (선택사항)
출발 시간이 미래여야 하는 교통 인식 요청에만 이 속성을 사용하세요. departureTime
속성을 설정하지 않으면 기본값은 요청 시간입니다.
경로를 선택할 때 서비스가 트래픽을 예측하는 방식을 조정하려면 TRAFFIC_AWARE
및 TRAFFIC_AWARE_OPTIMAL
옵션과 함께 departureTime
속성을 사용하세요.
TRAFFIC_UNAWARE
: 도로망 및 평균 시간과 무관한 교통상황을 기반으로 경로 및 소요 시간이 선택되므로 권장하지 않습니다.TRAFFIC_AWARE
및TRAFFIC_AWARE_OPTIMAL
: 이러한 환경설정은 실시간 교통 상황을 고려하므로 조만간 출발하는 경우에 권장됩니다.departureTime
이 지금에 가까울수록 실시간 교통정보가 더 중요해지고 관련성이 높아집니다. 출발 시간을 더 늦게 설정할수록 경로를 선택할 때 이전의 교통 상황을 더 많이 고려합니다.
예: 트래픽 인식 라우팅을 선택하는 방법
다음 JSON 코드는 요청 메시지 항목 본문에서 TRAFFIC_AWARE_OPTIMAL
라우팅 환경설정을 설정하는 방법을 보여줍니다.
{ "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를 사용하면 교통 인식 다중선을 따라 교통 상황에 관한 정보를 요청할 수 있습니다. 자세한 내용은 다중선 요청을 참고하세요.