교통정보 데이터 수준 설정

유럽 경제 지역 (EEA) 개발자

선택한 교통정보 환경설정은 다음 두 가지 방법 중 하나로 경로 세부정보의 정확성과 요청 성능의 균형을 맞춥니다.

  • 교통정보 인식 -- 가능한 가장 정확한 결과를 반환합니다 (지연 시간 증가 ).

  • 교통정보 인식 안 함 -- 결과를 최대한 빨리 반환합니다 (지연 시간 최소화).

요청을 할 때는 가능한 가장 정확한 결과를 반환하는 것이 좋은지 아니면 결과를 최대한 빨리 반환하는 것이 좋은지 고려하세요. 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를 사용하면 교통정보 인식 폴리라인을 따라 교통상황에 관한 정보를 요청할 수 있습니다. 자세한 내용은 폴리라인 요청을 참고하세요.