Routes Preferred API는 현재 일부 고객만 이용할 수 있습니다. 자세한 내용은
영업팀에 문의하세요.
Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.
품질과 지연 시간 절충점 구성
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
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-10-25(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-10-25(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"]]