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

선택한 교통정보 환경설정에 따라 경로 세부정보의 정확성이 균형을 유지합니다. 더 높은 성능을 발휘할 수 있습니다 요청할 때는 최대한 정확한 결과를 반환하는 것이 좋은지 아니면 최대한 빨리 결과를 반환하는 것이 좋은지 판단해야 합니다. Routes API는 Google Cloud에서 제공하는 응답 데이터의 품질과 응답의 지연 시간을 비교합니다.

트래픽 데이터 수준 설정

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 경로 매트릭스 한도에 대한 자세한 내용은 다음을 참조하세요. 경로 행렬을 계산합니다.

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

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