웹·모바일 앱에서 버스, 지하철, 기차 등 대중교통 수단을 이용한 경로 안내를 제공하려면 travelMode: "TRANSIT"을 사용해야 합니다. 일반 드라이브나 도보 경로와는 요청·응답 방식이 조금 다르므로, 이 가이드에서 단계별 방법과 주의사항을 살펴보겠습니다. 1. 대중교통 경로 vs 다른 경로 차이구분기타 이동수단대중교통 이동수단중간 웨이포인트 지원가능불가능교통 회피 옵션(톨·고속도로·페리)지원미지원트래픽 반영지원미지원routingPreferenceTRAFFIC_AWARE 등다양하게 지정 가능TransitPreferences만 지정 가능응답 필드steps, polyline 등transitDetails, stepsOverview 등대중교통 메타데이터 포함 2. 요청 전제 조건travelMode를 ..
기본적으로 Routes API는 ETA(예상 시간)를 최적화한 한 가지 경로만 반환합니다. 그러나 Shorter Distance Routes 기능을 사용하면 전체 이동 거리를 최소화하도록 최적화된 추가 경로를 함께 받아올 수 있습니다. 이를 통해 연료 비용을 절감하거나 짧은 구간을 빠르게 이동할 수 있는 경로 선택이 가능합니다. 1. Shorter Distance Routes란?짧은 거리 경로는 이동 시간보다 이동 거리를 우선으로 최소화합니다.고속도로 대신 국도나 비포장도로, 주차장 내 지름길 등을 활용할 수 있으며, 불법 경로는 반환하지 않습니다.기본 경로(DEFAULT_ROUTE)와 짧은 거리 경로(SHORTER_DISTANCE)를 함께 제공해 비교할 수 있습니다. 2. 요청 조건짧은 거리 경로를 요..
사용자에게 가장 빠른 경로뿐 아니라 상황에 맞는 대체 경로를 제공하면 내비게이션 경험을 한층 개선할 수 있습니다. Google 지도 Routes API의 Alternative Routes 기능을 사용하면, 기본 경로 외 최대 3개의 다른 경로를 함께 받아와 선택지를 제공할 수 있습니다. 1. 대체 경로 개요기본적으로 Routes API는 출발지(origin)에서 도착지(destination)까지 가장 빠른 경로 하나를 반환합니다.computeAlternativeRoutes를 true로 설정하면 최대 3개의 대체 경로(alternative routes)를 함께 반환합니다.대체 경로는 중간 경유지(intermediate waypoints)가 없을 때만 제공되며, 경유지가 설정된 요청에서는 반환되지 않습니다...
기본 경로 외에 연료 효율이나 CO₂ 배출량을 고려한 친환경 경로를 제공하면, 운전자에게 더 지속 가능한 이동 경험을 제공할 수 있습니다. Google 지도 Routes API의 Eco Routes 기능을 활용하면, 사용자의 차량 엔진 타입과 실시간 교통·도로 조건을 반영해 가장 연료 효율이 높은 경로를 함께 받아올 수 있습니다. 1. Eco Routes란?Eco Routes는 연료 소비 또는 에너지 소비를 최소화하도록 최적화된 경로를 함께 반환합니다.기본 경로(`DEFAULT_ROUTE`)와 함께, `FUEL_EFFICIENT` 레이블이 붙은 친환경 경로를 받아볼 수 있습니다.차량 엔진 타입(가솔린·디젤·하이브리드·전기)을 기반으로 경로를 선택하며, CO₂ 배출량도 줄일 수 있습니다.2. 사용 전제 조..
Google 지도 Routes API를 사용할 때 요청이 잘못되면, API는 명확한 JSON 오류 메시지를 통해 문제 원인을 알려줍니다. 적절한 오류 처리를 구현하면 사용자에게 유용한 피드백을 제공하고 애플리케이션의 안정성을 높일 수 있습니다. 1. 오류 응답 개요Routes API는 요청 오류가 발생할 경우 응답 본문에 error 객체를 포함시켜 반환합니다. 이 객체에는 code, message, status 필드가 있어, 오류 상황을 세부적으로 확인할 수 있습니다.2. 403 PERMISSION_DENIED: API 키 누락API 키를 헤더 또는 쿼리 파라미터에 포함하지 않은 경우, 다음과 같은 오류가 반환됩니다.{ "error": { "code": 403, "message": "The..
Google 지도 Routes API로 경로를 계산하면, 단순히 distance와 duration만 돌려받는 것이 아닙니다. 반환된 응답(JSON)을 올바르게 파싱해야만, 경로 선(polyline), 각 구간(leg)·단계(step) 정보, 위치 보정 결과, 그리고 예외 처리 정보까지 활용할 수 있죠. 이 글에서는 Understand Route Response 문서를 바탕으로, 응답 구조를 단계별로 해석하는 방법을 알아봅니다.1. 응답 전체 구조Compute Routes 호출 응답은 다음과 같은 최상위 객체 형태로 구성됩니다:{ "routes": [ /* Route 객체 배열 */ ], "geocodingResults": [ /* GeocodedWaypoint 객체 배열 */ ], "fallback..
