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은 실시간 교통 정보를 반영해 각..
여러 개의 픽업·배송 지점을 방문해야 할 때, 사람이 일일이 최적 경로를 계획하기란 번거롭고 실수도 잦습니다. Google 지도 Routes API의 optimizeWaypointOrder 기능을 활용하면, 최대 23개의 중간 경유지(intermediateWaypoints)에 대해 방문 순서를 자동으로 최적화해 주어 효율적인 라우팅을 구현할 수 있습니다. 1. Optimize Waypoints란?optimizeWaypointOrder: true를 설정하면, API가 내부적으로 TSP(Travelling Salesman Problem) 알고리즘을 적용해 최적의 방문 순서를 계산합니다.원래 입력한 순서와 상관없이, 전체 이동 거리 또는 소요 시간을 최소화하는 경로를 반환합니다.최대 23개의 중간 경유지에 대..
단순히 출발지(origin)와 도착지(destination)만 지정해도 경로 계산은 가능하지만, 픽업·드롭오프 상황에서는 차량이 웨이포인트에 접근하는 방향과 도로 측면까지 제어할 필요가 있습니다. Google 지도 Routes API의 Location Modifiers 기능을 사용하면, 각 웨이포인트별로 heading과 side_of_road 파라미터를 지정해 차량이 원하는 방향으로 도착하도록 설정할 수 있습니다. 1. Location Modifiers란?웨이포인트(출발지·중간 경유지·도착지)에 도달할 때 차량의 진행 방향(heading) 또는 도로 측면(side_of_road)을 지정하는 옵션입니다.정확한 위치 접근을 보장해, 택시 호출·배송 픽업·드롭오프 같은 상황에서 유용합니다.2. 지원되는 파라미..
내비게이션 경로에 단순한 출발지·도착지 외에 여러 중간 경유지(intermediate waypoints)를 추가하면, 픽업·드롭오프나 경유지를 반드시 통과해야 하는 시나리오에 유용합니다. Google 지도 Routes API의 intermediates 배열을 사용하면, 최대 25개의 중간 경유지를 설정하고 각 구간별 정보를 받을 수 있습니다. 1. Intermediate Waypoints란?출발지(origin)와 도착지(destination) 사이에 반드시 경유해야 할 지점을 지정하는 기능입니다.각 경유지마다 새로운 RouteLeg이 생성되어, legs 배열에 순서대로 저장됩니다.최대 25개까지 설정할 수 있으며, 11개 이상(11~25개) 요청 시 더 높은 요율이 적용됩니다. Compute Route..
