구글 지도 API로 실시간 경로 계산하기: Compute Routes

웹·모바일 앱에서 출발지와 도착지 사이의 최적 경로를 실시간 교통 정보를 반영해 제공하고 싶으신가요? Google 지도 Routes API의 Compute Routes 기능을 이용하면, 복잡한 알고리즘을 직접 구현하지 않고도 간편하게 경로 계산 결과를 받아올 수 있습니다. 

 

1. Compute Routes란?

• Compute Routes는 Google 지도 Routes API의 핵심 기능으로, 자동차·도보·자전거 등 다양한 이동 수단에 따른 경로를 계산해줍니다.
• 실시간 교통량, 회피 옵션(톨·고속도로·페리) 등을 손쉽게 설정할 수 있어, 사용자 경험을 한층 높여줍니다.
  
  

2. REST API 요청 구성하기

엔드포인트

POST https://routes.googleapis.com/directions/v2:computeRoutes

필수 헤더

• Content-Type: application/json
• X-Goog-Api-Key: {YOUR_API_KEY}
• X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

간단한 요청 예시

{
  "origin": {
    "location": { "latLng": { "latitude": 37.419734, "longitude": -122.0827784 } }
  },
  "destination": {
    "location": { "latLng": { "latitude": 37.417670, "longitude": -122.079595 } }
  },
  "travelMode": "DRIVE",
  "routingPreference": "TRAFFIC_AWARE",
  "routeModifiers": {
    "avoidTolls": false,
    "avoidHighways": false,
    "avoidFerries": false
  },
  "units": "METRIC"
}

3. 주요 파라미터 설명

• travelMode: DRIVE, WALK, BICYCLE 등 이동 수단 선택
• routingPreference: TRAFFIC_AWARE 또는 TRAFFIC_UNAWARE로 교통 반영 여부 결정
• computeAlternativeRoutes: true로 설정하면 대체 경로도 함께 받아올 수 있습니다.
• routeModifiers: avoidTolls, avoidHighways, avoidFerries 등을 조합해 경로 제한 가능

4. 응답 예시

{
  "routes": [
    {
      "distanceMeters": 772,
      "duration": "165s",
      "polyline": {
        "encodedPolyline": "ipkcFfichVnP@j@BLoFVwM{E?"
      }
    }
  ]
}

5. 응답 활용하기

• 경로 그리기: encodedPolyline을 디코딩해 지도 위에 선으로 표시
• ETA 계산: duration 값을 초 단위로 변환해 예상 도착 시간 표시
• 거리·시간 표시: UI에 distanceMeters와 duration을 직관적으로 보여주기
  
  

6. 추가 팁: 필드 마스크로 대역폭 절약하기

$fields URL 파라미터 또는 X-Goog-FieldMask 헤더를 사용해 꼭 필요한 필드만 요청하면, 네트워크 사용량과 응답 시간을 크게 줄일 수 있습니다.

X-Goog-FieldMask: routes.polyline.encodedPolyline

 

 

Compute Routes를 이용하면 복잡한 경로 계산 로직을 직접 구현할 필요 없이, 단 몇 줄의 요청으로 실시간 교통 정보를 반영한 최적 경로를 얻어올 수 있습니다.