경로에 사용 가능한 차량 유형

다양한 유형의 차량에 적합한 경로를 확인할 수 있습니다. 차량 유형을 지정하지 않으면 Routes API는 기본값인 가솔린 차량(DRIVE)을 사용합니다.

computeRoutes HTTP POST 요청에서 이동 수단을 설정하려면 RouteTravelMode enum 값을 사용하여 JSON 요청 본문에 travelMode 필드를 전달합니다. 선택할 수 있는 값은 대중교통, 운전, 이륜 차량, 트럭, 도보, 자전거입니다.

차량 유형	RouteTravelMode 값	설명
자전거	BICYCLE	자전거 및 기타 인력 이동 수단의 경로를 계산합니다. 전동 이륜차의 경우 이륜차를 참고하세요.
Drive	DRIVE	운전 경로를 계산합니다. DRIVE: 차량 유형을 지정하지 않은 경우 기본값입니다.
대중교통	TRANSIT	해당 지역에서 이용 가능한 대중교통 옵션을 사용하여 내비게이션 안내를 위한 대중교통 경로를 가져옵니다. 대중교통 옵션에는 버스, 지하철, 기차 등이 포함될 수 있습니다. 대중교통 경로에는 일반적으로 대중교통 정류장까지, 정류장에서, 정류장 간 도보 이동에 관한 안내도 포함됩니다.
오토바이	TWO_WHEELER	오토바이는 전동이륜차 (예: 오토바이)를 의미합니다. 오토바이 이동 모드는 인력 이동 모드인 자전거 이동 모드와 다릅니다.
트럭	TRUCK	routeModifiers.vehicleInfo에서 물리적 속성과 제약 조건을 지정하여 대형 차량에 맞춤설정된 경로를 계산합니다. 낮은 다리, 중량 제한, 위험 요소를 피하려면 이 차량 유형을 사용하세요.
도보	WALK	도보 경로를 계산합니다.

요청에서 이동 수단 지정

computeRoutes 요청에서 이동 수단을 지정하려면 HTTP POST JSON 요청 본문에서 travelMode 필드를 설정하고 필요한 X-Goog-FieldMask 헤더를 포함하여 필요한 Route 응답 필드를 선택합니다. 기존 Directions API에서 이전하는 경우 POST JSON 요청 본문의 travelMode 필드가 기존 mode URL 쿼리 매개변수를 대체합니다. 자세한 내용은 Routes API로 이전을 참고하세요.

curl -X POST -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "travelMode": "BICYCLE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline' \
'https://routes.googleapis.com/directions/v2:computeRoutes'