트래픽 데이터를 포함할지 여부와 방법을 지정합니다.

선택한 트래픽 환경설정에 따라 경로 세부정보의 정확성과 요청 성능이 균형을 이루게 됩니다. 요청을 할 때는 가능한 한 가장 정확한 결과를 반환하는 것이 더 나은지 아니면 가능한 한 빨리 결과를 반환하는 것이 더 나은지 여부를 따져봐야 합니다. Routes API는 응답 데이터의 품질과 응답 지연 시간을 비교하여 제어할 수 있는 옵션을 제공합니다.

트래픽 데이터 수준 설정

Routes API는 경로 계산을 위한 라우팅 환경설정을 지정할 수 있는 RoutingPreference (REST)와 RoutingPreference(gRPC)를 제공합니다. 이러한 환경설정은 경로 계산에 교통 상황을 고려한다는 점에서 다릅니다. 각 경로 환경설정은 경로 품질, 예상 ETA, 응답 지연 시간과 관련하여 어느 정도 다른 결과를 생성합니다.

교통 상황은 트래픽 흐름의 속도를 특징짓습니다. 예를 들면 다음과 같습니다.

• 혼잡이 없으면 교통상황이 정상인 것으로 간주되며 교통체증이 정상 속도로 유동적으로 이동합니다.
• 출퇴근 시간에 다가오면 교통량이 늘어나고 이로 인해 교통량이 적어지고 교통상황이 약하거나 중간 수준입니다.
• 범퍼 간 트래픽에서는 유속이 멈춰서 과도한 교통상황이 발생합니다.

트래픽을 인식하지 못함

TRAFFIC_UNAWARE 경로 환경설정을 지정하면 현재 교통상황을 고려하지 않고 경로가 계산됩니다. 이 라우팅 환경설정은 응답 지연 시간이 가장 짧습니다 (응답이 가장 빨리 반환됨).

TRAFFIC_UNAWARE가 기본 설정입니다.

응답에서 각 항목의 의미는 다음과 같습니다.

• ETA는 duration 응답 속성에 포함되어 있습니다.

• duration 및 staticDuration 응답 속성에는 동일한 값이 포함됩니다.

응답을 가장 빨리 반환하고 대략적인 라우팅 세부정보만 있으면 이 라우팅 환경설정을 사용합니다.

트래픽 인식

TRAFFIC_AWARE 라우팅 환경설정을 지정하면 현재 교통상황을 고려하여 경로가 계산됩니다. 따라서 경로 및 경로 세부정보가 실제 조건을 더 정확하게 반영합니다. 이러한 데이터 품질 향상으로 인해 응답 지연 시간이 줄어들기 때문에 성능 최적화를 적용하여 지연 시간을 크게 줄일 수 있습니다.

응답에서 각 항목의 의미는 다음과 같습니다.

• 실시간 트래픽을 고려하는 ETA는 duration 응답 속성에 포함되어 있습니다.

• staticDuration 응답 속성에는 교통 상황을 고려하지 않고 경로를 통해 이동하는 시간이 포함됩니다.

TRAFFIC_UNAWARE보다 더 정확한 라우팅 세부정보를 원하면서도 지연 시간이 어느 정도 증가하여 응답이 반환되는 경우에도 이 라우팅 환경설정을 사용합니다.

트래픽 인식 최적화

TRAFFIC_AWARE_OPTIMAL 라우팅 환경설정을 지정하면 현재 교통상황을 고려하여 경로가 계산되지만 성능 최적화는 적용되지 않습니다. 이 모드에서 서버는 최적의 경로를 찾기 위해 도로망을 더 철저하게 검색합니다.

TRAFFIC_AWARE_OPTIMAL 경로 환경설정은 maps.google.com 및 Google 지도 모바일 앱에서 사용하는 모드와 동일합니다.

Compute Route Matrix에서 이 옵션을 사용할 때는 요청의 요소 수 (출발지 수 × 목적지 수)가 100개를 초과할 수 없습니다. 컴퓨팅 경로 행렬 한도에 대한 자세한 내용은 경로 행렬 계산을 참조하세요.

응답에서 각 항목의 의미는 다음과 같습니다.

• 실시간 트래픽을 고려하는 ETA는 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를 사용하면 교통정보 인식 다중선을 따라 교통상황에 대한 정보를 요청할 수 있습니다. 자세한 내용은 다중선 요청을 참고하세요.