구글 지도 Routes API 매트릭스에서 위치 지정하기: Route Matrix

Compute Route Matrix 메서드는 여러 출발지와 도착지 조합에 대해 한 번에 거리와 소요 시간을 계산해주는 기능입니다. 이때 각 지점을 정확히 지정하는 방법을 알면, 주소 미지원 지역이나 동적 Place ID 환경에서도 안정적인 매트릭스 계산이 가능합니다. 이 글에서는 Route Matrix에서 지원하는 네 가지 위치 지정 방식을 예제와 함께 살펴보겠습니다.

 

1. 지원되는 위치 지정 방식

방식	설명
Place ID	Google Places에 등록된 고유 식별자. 안정적이며 권장 방식입니다.
위도·경도 좌표	실수형 숫자로 지정. 즉시 사용할 수 있어 주소 미지원 지역에서도 활용 가능합니다.
주소 문자열	"서울특별시 중구 세종대로 110" 같은 텍스트. 간단하지만 오타나 비표준 표기 오류 가능성이 있습니다.
Plus Code	전 세계 어디서나 사용할 수 있는 좌표 기반 인코딩 주소. 주소가 없는 오지에서도 유용합니다.

 

2. JSON 요청 예시

{
  "origins": [
    { "waypoint": { "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4" } },
    { "waypoint": { "location": { "latLng": { "latitude": 37.5665, "longitude": 126.9780 } } } },
    { "waypoint": { "location": { "address": "서울특별시 중구 세종대로 110" } } },
    { "waypoint": { "location": { "address": "849VCWC8+R9" } } }
  ],
  "destinations": [
    { "waypoint": { "placeId": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ" } },
    { "waypoint": { "location": { "latLng": { "latitude": 37.5512, "longitude": 126.9882 } } } },
    { "waypoint": { "location": { "address": "서울특별시 용산구 이태원로 247" } } },
    { "waypoint": { "location": { "address": "CRHJ+C3 Stanford, CA 94305, USA" } } }
  ],
  "travelMode": "DRIVE",
  "routingPreference": "TRAFFIC_AWARE"
}

3. curl 요청 예시

curl -X POST 'https://routes.googleapis.com/v2:computeRouteMatrix' \
  -H 'Content-Type: application/json' \
  -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  --data-raw '{
    "origins": [
      { "waypoint": { "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4" } },
      { "waypoint": { "location": { "latLng": { "latitude": 37.5665, "longitude": 126.9780 } } } }
    ],
    "destinations": [
      { "waypoint": { "placeId": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ" } },
      { "waypoint": { "location": { "address": "서울특별시 용산구 이태원로 247" } } }
    ],
    "travelMode": "DRIVE",
    "routingPreference": "TRAFFIC_AWARE"
  }'

4. 응답 예시

{
  "originIndex": [0, 0, 1, 1],
  "destinationIndex": [0, 1, 0, 1],
  "distanceMeters": [ 8000, 9200, 7800, 8900 ],
  "duration": [ "600s", "700s", "580s", "650s" ],
  "status": [ "OK", "OK", "OK", "OK" ]
}

5. 활용 팁 및 주의사항

• Place ID를 우선 사용하면 주소 변경에도 안정적인 결과를 얻을 수 있습니다.
• 주소 문자열은 오타 방지를 위해 사용자 입력 전처리를 거치는 것이 좋습니다.
• Plus Code는 오지나 개발도상국 등 주소 체계가 미비한 지역에서 특히 유용합니다.
• elements 수(출발지×도착지 조합)가 625를 초과하지 않도록 주의하세요.
  
  

Compute Route Matrix에서 제공하는 네 가지 위치 지정 방식을 적절히 활용하면, 다양한 환경에서 정확하고 안정적인 거리 행렬 계산이 가능합니다. 프로젝트 요구사항에 맞춰 Place ID, 좌표, 주소, Plus Code 방식을 선택해 최적의 매트릭스를 구성해 보세요!