선택한 트래픽 환경설정은 다음 두 가지 방법 중 하나로 경로 세부정보의 정확성과 요청 성능의 균형을 맞춥니다.
트래픽 인식: 가능한 가장 정확한 결과를 반환합니다 (지연 시간 증가).
트래픽 인식 안 함: 결과를 최대한 빨리 반환합니다 (최저 지연 시간).
요청을 할 때는 가능한 한 가장 정확한 결과를 반환하는 것이 나은지 아니면 가능한 한 빨리 결과를 반환하는 것이 나은지 고려하세요. 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와 함께 사용하는 경우 요청의 요소 수 (출발지 수 × 목적지 수)는
- 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를 사용하면 교통 상황 인식 폴리라인을 따라 교통 상황에 관한 정보를 요청할 수 있습니다. 자세한 내용은 폴리라인 요청을 참고하세요.