구글 지도 Routes API로 짧은 거리 경로 계산하기: Shorter Distance Routes

기본적으로 Routes API는 ETA(예상 시간)를 최적화한 한 가지 경로만 반환합니다. 그러나 Shorter Distance Routes 기능을 사용하면 전체 이동 거리를 최소화하도록 최적화된 추가 경로를 함께 받아올 수 있습니다. 이를 통해 연료 비용을 절감하거나 짧은 구간을 빠르게 이동할 수 있는 경로 선택이 가능합니다.

 

1. Shorter Distance Routes란?

• 짧은 거리 경로는 이동 시간보다 이동 거리를 우선으로 최소화합니다.
• 고속도로 대신 국도나 비포장도로, 주차장 내 지름길 등을 활용할 수 있으며, 불법 경로는 반환하지 않습니다.
• 기본 경로(DEFAULT_ROUTE)와 짧은 거리 경로(SHORTER_DISTANCE)를 함께 제공해 비교할 수 있습니다. 
  
  

2. 요청 조건

짧은 거리 경로를 요청하려면 다음 기준을 충족해야 합니다.

• travelMode를 DRIVE, BICYCLE 또는 TWO_WHEELER로 설정
• requestedReferenceRoutes를 ["SHORTER_DISTANCE"]로 설정
• 응답 필드 마스크에 routes.routeLabels 및 routes.routeToken 포함
• Via intermediate waypoint 미포함
• optimizeWaypointOrder 파라미터 미사용
• 선택 사항: 기본 경로와 단축 경로의 거리·시간을 확인하려면 routes.distanceMeters 및 routes.duration도 필드 마스크에 추가
  
  

3. curl 요청 예시

curl -X POST \
  'https://routes.googleapis.com/directions/v2:computeRoutes' \
  -H 'Content-Type: application/json' \
  -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
  --data-raw '{
    "origin": {
      "location": { "latLng": { "latitude": 41.76904801292959, "longitude": -72.67374935684933 } }
    },
    "destination": {
      "location": { "latLng": { "latitude": 41.823042361105024, "longitude": -71.40933143059424 } }
    },
    "travelMode": "DRIVE",
    "routingPreference": "TRAFFIC_AWARE",
    "requestedReferenceRoutes": ["SHORTER_DISTANCE"]
  }'

4. 응답 예시

{
  "routes": [
    {
      "distanceMeters": 138943,
      "duration": "5373s",
      "routeToken": "CrsCCs4BMssB…PCk0KGAoN…",
      "routeLabels": ["DEFAULT_ROUTE"]
    },
    {
      "distanceMeters": 112610,
      "duration": "7165s",
      "routeToken": "CqgCCrsBMrgB…8EJS5nmwiEF8K…",
      "routeLabels": ["SHORTER_DISTANCE"]
    }
  ]
}

5. 연료 효율 경로와 함께 사용하기

짧은 거리 경로와 연료 효율 경로(FUEL_EFFICIENT)를 동시에 요청하려면 requestedReferenceRoutes에 두 값을 모두 포함하세요. 이때 두 옵션이 동일한 경로를 반환하면 routeLabels에 모두 표시됩니다.

6. 지원 지역 및 요금

• 모든 지역에서 짧은 거리 경로 기능이 지원됩니다.
• 실험적(Pre-GA) 기능으로, 추가 요금 없이 표준 API 사용량에 따라 비용이 청구됩니다.
  
  

Shorter Distance Routes 기능을 활용하면, 기본 ETA 최적화 경로 외에 전체 이동 거리를 최소화한 경로를 함께 제공받아 다양한 경로 선택지를 사용자에게 제안할 수 있습니다. 

해시태그

#Google지도API #RoutesAPI #짧은거리경로 #ShorterDistance #API가이드