Google 지도 Routes API의 Compute Routes 메서드는 기본 경로 정보 외에도 routeToken을 반환할 수 있습니다. 이 토큰은 네비게이션 SDK에서 동일 경로를 재사용하거나 세션을 관리할 때 유용합니다. 이 글에서는 routeToken을 요청하는 방법과 예시, 주의사항을 정리합니다. 1. Route Token 개요routeToken은 Compute Routes 호출 결과에 포함되는 고유 식별자입니다.이 토큰을 사용하면, Navigation SDK(Android/iOS)에서 같은 경로를 그대로 따라갈 수 있습니다.토큰은 동적 도로 상황에 따라 경로가 달라질 수 있으므로, 생성 후 몇 분 내에 사용하는 것을 권장합니다. 2. 설정 방법travelMode를 DRIVE로 설정하세요.ro..
실시간 교통 정보와 과거 교통 데이터를 어떻게 반영할지에 따라 예측된 소요 시간(Duration)이 달라집니다. Google 지도 Routes API의 Traffic Model 기능을 통해, 평균적인 것부터 낙관적인/비관적인 교통 상황까지 다양한 예측 모델을 선택해 사용할 수 있습니다. 이 가이드에서는 각 모델의 차이점과 설정 방법, 예시 코드를 함께 살펴보겠습니다. 1. Traffic Model 개요교통 모델은 역사적·실시간 교통 상황을 고려해 경로 소요 시간을 예측하는 방식입니다.Routes API의 Compute Routes 및 Compute Route Matrix 메서드에서 지원합니다.기본값은 BEST_GUESS이며, 교통 상황 예측이 필요하지 않은 경우엔 지정하지 않아도 됩니다.2. 지원되는 모..
Routes API로 경로를 계산할 때, 실시간 교통 정보를 반영해 가장 정확한 결과를 얻을지, 아니면 응답 속도를 우선해 신속히 결과를 받아올지 선택할 수 있습니다. 이때 사용하는 것이 바로 Routing Preference입니다. 이 가이드에서는 응답 품질(accuracy)과 레이턴시(latency)의 균형을 조절하는 세 가지 옵션을 단계별로 살펴보겠습니다. 1. Routing Preference 개요Routing Preference는 API가 교통 데이터를 얼마나 반영해 경로를 계산할지 결정합니다. 기본값은 TRAFFIC_UNAWARE로, 교통 정보를 고려하지 않고 가장 빠른 응답을 제공합니다. 반대로 TRAFFIC_AWARE와 TRAFFIC_AWARE_OPTIMAL은 실시간 교통 정보를 반영해 각..
단순히 출발지(origin)와 도착지(destination)만 지정해도 경로 계산은 가능하지만, 픽업·드롭오프 상황에서는 차량이 웨이포인트에 접근하는 방향과 도로 측면까지 제어할 필요가 있습니다. Google 지도 Routes API의 Location Modifiers 기능을 사용하면, 각 웨이포인트별로 heading과 side_of_road 파라미터를 지정해 차량이 원하는 방향으로 도착하도록 설정할 수 있습니다. 1. Location Modifiers란?웨이포인트(출발지·중간 경유지·도착지)에 도달할 때 차량의 진행 방향(heading) 또는 도로 측면(side_of_road)을 지정하는 옵션입니다.정확한 위치 접근을 보장해, 택시 호출·배송 픽업·드롭오프 같은 상황에서 유용합니다.2. 지원되는 파라미..
웹·모바일 앱에서 출발지와 도착지 사이의 최적 경로를 실시간 교통 정보를 반영해 제공하고 싶으신가요? Google 지도 Routes API의 Compute Routes 기능을 이용하면, 복잡한 알고리즘을 직접 구현하지 않고도 간편하게 경로 계산 결과를 받아올 수 있습니다. 1. Compute Routes란?Compute Routes는 Google 지도 Routes API의 핵심 기능으로, 자동차·도보·자전거 등 다양한 이동 수단에 따른 경로를 계산해줍니다.실시간 교통량, 회피 옵션(톨·고속도로·페리) 등을 손쉽게 설정할 수 있어, 사용자 경험을 한층 높여줍니다.2. REST API 요청 구성하기엔드포인트POST https://routes.googleapis.com/directions/v2:compute..
내비게이션 경로에 단순한 출발지·도착지 외에 여러 중간 경유지(intermediate waypoints)를 추가하면, 픽업·드롭오프나 경유지를 반드시 통과해야 하는 시나리오에 유용합니다. Google 지도 Routes API의 intermediates 배열을 사용하면, 최대 25개의 중간 경유지를 설정하고 각 구간별 정보를 받을 수 있습니다. 1. Intermediate Waypoints란?출발지(origin)와 도착지(destination) 사이에 반드시 경유해야 할 지점을 지정하는 기능입니다.각 경유지마다 새로운 RouteLeg이 생성되어, legs 배열에 순서대로 저장됩니다.최대 25개까지 설정할 수 있으며, 11개 이상(11~25개) 요청 시 더 높은 요율이 적용됩니다. Compute Route..
