다수의 출발지(origins)와 도착지(destinations) 조합에 대한 거리 및 소요 시간 행렬을 계산할 때, 결과를 사용자의 언어와 친숙한 단위(미터/피트, 분/시간)로 바로 표시할 수 있다면 UX가 한층 향상됩니다. Compute Route Matrix의 Localized Values 기능을 활용하면, distanceMeters와 duration 필드에 대해 번역된 text 값을 함께 받을 수 있습니다. 1. Localized Values란?응답 객체에 localizedValues 맵이 추가되어, 각 distanceMeters와 duration 요소마다 로컬 언어 텍스트와 단위를 함께 포함합니다.Compute Route Matrix는 기본적으로 en-US 언어와 METRIC 단위를 사용하지만, ..
Compute Route Matrix 메서드는 여러 출발지와 도착지 조합에 대해 한 번에 거리와 소요 시간을 계산해주는 기능입니다. 이때 각 지점을 정확히 지정하는 방법을 알면, 주소 미지원 지역이나 동적 Place ID 환경에서도 안정적인 매트릭스 계산이 가능합니다. 이 글에서는 Route Matrix에서 지원하는 네 가지 위치 지정 방식을 예제와 함께 살펴보겠습니다. 1. 지원되는 위치 지정 방식방식설명Place IDGoogle Places에 등록된 고유 식별자. 안정적이며 권장 방식입니다.위도·경도 좌표실수형 숫자로 지정. 즉시 사용할 수 있어 주소 미지원 지역에서도 활용 가능합니다.주소 문자열"서울특별시 중구 세종대로 110" 같은 텍스트. 간단하지만 오타나 비표준 표기 오류 가능성이 있습니다.P..
Compute Route Matrix 메서드는 여러 출발지와 도착지 조합에 대한 거리 및 소요 시간을 한 번에 계산해주지만, 반환되는 기본 필드 목록이 없기 때문에 반드시 필드 마스크를 지정해야 합니다. 지정하지 않으면 오류가 발생하며, 불필요한 데이터를 요청하면 네트워크 대역폭과 응답 시간이 증가합니다. 1. 필드 마스크란?응답 필드 마스크는 응답 메시지에서 반환받을 필드를 “쉼표로 구분된 경로(path) 목록”으로 지정하는 방식입니다. 경로는 최상위 응답 오브젝트(Compute Route Matrix의 경우, 응답 본문)에 해당하며, 도트(.)로 중첩 필드를 연결해 표현합니다. 2. 왜 필드 마스크를 사용해야 하나?필드 마스크를 지정하지 않으면 API가 오류(INVALID_ARGUMENT)를 반환합니..
