Routes Preferred API는 현재 일부 고객만 이용할 수 있습니다. 자세한 내용은
영업팀에 문의하세요.
품질과 지연 시간 절충점 구성
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
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"
}
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-04-08(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2026-04-08(UTC)"],[],["The Routes Preferred API offers three routing preferences: `TRAFFIC_UNAWARE`, `TRAFFIC_AWARE`, and `TRAFFIC_AWARE_OPTIMAL`. `TRAFFIC_UNAWARE` ignores traffic, providing the fastest response. `TRAFFIC_AWARE` considers traffic, balancing accuracy with moderate latency. `TRAFFIC_AWARE_OPTIMAL` exhaustively searches for the best route accounting for traffic, resulting in the highest quality but with the longest latency. The API allows setting these preferences in requests, for example using JSON. Traffic conditions are classified as normal, light to moderate, or heavy.\n"]]