Compute Route Matrix 메서드는 여러 출발지와 도착지 조합에 대한 거리 및 소요 시간을 한 번에 계산해주지만, 반환되는 기본 필드 목록이 없기 때문에 반드시 필드 마스크를 지정해야 합니다. 지정하지 않으면 오류가 발생하며, 불필요한 데이터를 요청하면 네트워크 대역폭과 응답 시간이 증가합니다. 1. 필드 마스크란?응답 필드 마스크는 응답 메시지에서 반환받을 필드를 “쉼표로 구분된 경로(path) 목록”으로 지정하는 방식입니다. 경로는 최상위 응답 오브젝트(Compute Route Matrix의 경우, 응답 본문)에 해당하며, 도트(.)로 중첩 필드를 연결해 표현합니다. 2. 왜 필드 마스크를 사용해야 하나?필드 마스크를 지정하지 않으면 API가 오류(INVALID_ARGUMENT)를 반환합니..
하나의 경로 대신, 여러 출발지(origins)와 도착지(destinations) 조합에 대한 거리 및 소요 시간을 한 번에 계산해야 할 때가 있습니다. Google 지도 Routes API의 Compute Route Matrix 메서드를 사용하면, 최대 625개의 경로 요소(elements)를 포함하는 행렬(matrix) 형태로 결과를 받아올 수 있습니다. 이 글에서는 요청 구성부터 응답 처리, 활용 사례까지 단계별로 살펴보겠습니다. 1. Compute Route Matrix란?여러 출발지와 여러 도착지 조합(origin × destination)에 대해 각 경로의 거리(distance)와 소요 시간(duration)을 계산합니다.elements 수(출발지 수 × 도착지 수)가 625를 초과하면 오류가..
다국적 서비스를 제공할 때, 거리나 소요 시간을 사용자의 언어와 로컬 단위로 표시하면 UX가 크게 향상됩니다. Google 지도 Routes API의 Localized Values 기능을 활용하면, `distance`, `duration`, `staticDuration` 필드에 대해 번역된 텍스트를 함께 받을 수 있습니다. 1. Localized Values란?응답 메시지에 추가되는 `localizedValues` 객체로, 거리 및 시간, 단위 시스템(METRIC/IMPERIAL)에 대한 로컬라이즈된 텍스트를 제공합니다.언어(`languageCode`)와 단위(`units`)를 직접 지정하거나, API가 요청 위치를 기반으로 추론하도록 할 수 있습니다.ComputeRoutes는 출발지 waypoint를,..
내비게이션 경로를 지도 위에 표시할 때, 실시간 교통 상황을 반영한 폴리라인을 함께 그릴 수 있다면 사용자에게 더 유용한 정보를 제공할 수 있습니다. Google 지도 Routes API의 TRAFFIC_ON_POLYLINE 기능을 사용하면, 각 폴리라인 구간별로 교통 속도 상태(정상, 느림, 정체)를 함께 받아올 수 있습니다. 1. 개요트래픽 인식 폴리라인(Traffic-aware Polyline)은 경로를 구성하는 폴리라인 포인트 사이의 교통 속도 상태를 포함합니다.속도 상태는 NORMAL, SLOW, TRAFFIC_JAM 세 가지 카테고리로 구분됩니다.구간은 폴리라인 포인트 인덱스로 정의되며, 시작 인덱스(포함)와 종료 인덱스(미포함)를 통해 구간별 속도를 나타냅니다.2. 요청 방법extraComp..
내비게이션 경로를 계산할 때, 톨게이트나 고속도로, 페리 또는 실내 구간을 피하고 싶다면 routeModifiers 옵션을 활용할 수 있습니다. 이 글에서는 Google 지도 Routes API의 경로 수정자(Route Modifiers)를 설정하는 방법과 주의사항을 자세히 살펴보겠습니다. 1. routeModifiers란?routeModifiers는 Compute Routes 요청에 추가할 수 있는 객체로, 사용자가 회피를 원하는 경로 특성을 지정합니다. API는 해당 특성을 우선 고려해 가능한 한 회피된 경로를 반환하려 시도합니다.2. 지원되는 회피 옵션avoidTolls: 톨게이트(Toll) 회피avoidHighways: 고속도로(Highway) 회피avoidFerries: 페리(Ferry) 회피a..
내비게이션 경로를 제공할 때, 톨게이트 요금을 함께 안내하면 사용자에게 더 풍부한 정보를 제공할 수 있습니다. Google 지도 Routes API의 Calculate Toll Fees 기능을 사용하면, 경로상의 예상 톨 요금을 자동으로 계산해 통화 단위로 반환받을 수 있습니다. 이 글에서는 기능 개요부터 요청·응답 예시를 살펴보겠습니다. 1. 톨 요금 계산 개요Routes API는 운전자나 차량이 가진 톨 패스(Toll Pass)와 연료 종류(Vehicle Emission Type), 가장 편리한 결제 수단을 고려해 예상 톨 요금을 계산합니다. 해당 경로에 톨 요금 정보가 없는 구간이 있으면, “요금 미확인” 상태로 표시됩니다. 2. 전제 조건travelMode을 DRIVE 또는 TWO_WHEELER로..
