품질과 지연 시간 절충점 구성

Routes Preferred API는 경로를 계산하는 세 가지 경로 환경설정을 제공합니다. 경로 계산에 교통 상황을 반영하는 정도가 다릅니다. 각 경로 환경설정은 경로 품질, 예상 도착 시간, 응답 지연 시간과 관련하여 어느 정도 다른 결과를 생성합니다.

교통 상황 정보

교통 상황은 교통 흐름의 속도를 나타냅니다. 예를 들면 다음과 같습니다.

  • 정체가 없으면 교통 상황이 정상으로 간주되고 교통 흐름이 방해받지 않는 일반적인 속도로 진행됩니다.

  • 출퇴근 시간이 다가오면 교통 밀도가 증가하여 교통 속도가 느려지고 교통 상황이 원활에서 보통으로 바뀝니다.

  • 교통 체증이 심한 경우 흐름 속도가 정지되어 교통 상황이 발생합니다.

트래픽 인식 안 함

TRAFFIC_UNAWARE 경로 환경설정을 설정하면 교통 상황을 고려하지 않고 경로가 계산됩니다. 이 라우팅 환경설정은 가장 낮은 응답 지연 시간을 제공합니다(응답이 가장 빠르게 반환됨).

응답이 가장 빠르게 반환되고 대략적인 경로 세부정보로 충분한 경우 이 경로 환경설정을 사용합니다.

교통 상황 인식

TRAFFIC_AWARE 경로 환경설정을 설정하면 교통 상황을 고려하여 경로가 계산됩니다. 따라서 경로 및 경로 세부정보가 실제 상황을 더 정확하게 반영합니다. 이러한 데이터 품질 향상은 응답 지연 시간을 희생하여 이루어지므로 성능 최적화를 적용하여 지연 시간을 크게 줄입니다.

더 정확한 경로 세부정보를 원하지만 지연 시간이 약간 증가해도 응답이 반환되는 경우 이 경로 기본 설정을 사용하세요.

트래픽 인식 최적

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

이 라우팅 환경설정은 가장 높은 응답 지연 시간을 제공합니다 (즉, 응답이 가장 긴 지연 시간으로 반환됨). 응답에 걸리는 시간과 관계없이 최고 품질의 결과를 원할 때 이 라우팅 환경설정을 사용합니다.

예

다음 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"
}