Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

대형 차량 경로 개요

도로 위의 대형 트럭 사진

Routes API 대형 차량 경로 설정 기능은 대형 차량의 경로와 도착 예정 시간 (ETA)을 계산합니다. 차량 높이, 무게, 길이, 위험물질 분류를 기준으로 제한사항을 피하는 최적화된 경로를 반환합니다. 또한 이 서비스는 Navigation SDK에 전달하여 세부 경로 안내를 제공할 수 있는 경로 토큰 을 생성합니다.

대형 차량 경로 설정을 사용하는 이유

대형 차량 경로 설정을 사용하여 대형 차량의 물류 문제를 해결하는 애플리케이션을 빌드합니다.

이점	설명
가격 책정 및 계획 정확도 개선	트럭 및 버스와 같은 대형 차량의 더 정확한 견적 및 배송 기간을 허용하는 트래픽 정보를 기반으로 하는 구체적인 도착 예정 시간을 생성합니다.
운전기사 안전 및 효율성 향상	낮은 다리, 무게 제한 도로, 기타 위험을 피하는 경로를 따라 운전기사를 안내합니다.
차량 전체 운영 간소화	대형 차량 경로 설정과 함께 Route Optimization을 사용하여 전체 차량의 적재 할당 및 정류장 순서를 최적화합니다. Fleet Engine을 사용하여 할당 및 차량 위치를 실시간으로 확인할 수 있습니다.
교육 최소화 및 도입률 향상	자체 애플리케이션 내에서 대형 차량 또는 트럭 운전기사에게 익숙한 Google 지도 내비게이션 환경을 제공합니다.

대형 차량 경로 설정으로 할 수 있는 작업

대형 차량 경로 설정을 사용하면 다음과 같은 주요 작업을 실행할 수 있습니다.

높이, 무게, 길이, 너비, 차축 수, 위험물질 분류를 포함한 세부 차량 속성 지정
차량 속성을 위해 특별히 계산된 경로, 이동 시간, 이동 거리 가져오기
기동성을 위해 최적화된 경로 생성 이를 통해 대형 차량은 운전기사의 요구사항과 기대를 충족하는 경로를 유지합니다.
트럭 전용 도착 예정 시간 모델을 사용하여 더 정확한 도착 예정 시간 계산 이 모델은 관찰된 트럭 이동 속도와 실시간 및 예측 교통정보 데이터를 결합하여 대형 차량의 더 정확한 추정치를 제공합니다.
경로 토큰을 사용하여 Routes API에서 트럭 안전 경로를 전송하여 Navigation SDK에서 세부 경로 안내 내비게이션 사용 설정
경로 매트릭스 계산 을 통해 차량 전체 계획을 위한 여러 출발지와 목적지 간의 이동 시간과 거리를 결정합니다.
실현 가능성과 안전을 고려하는 전반적인 운영 효율성을 위해 트럭 차량의 경로 계획 최적화

대형 차량 경로 설정의 작동 방식

대형 차량 경로 설정 기능은 다음 서비스를 통해 작동합니다.

엔드포인트	작업	출력
Routes API	출발지와 목적지를 포함하는 요청 본문이 있는 Routes API 엔드포인트 (`computeRoutes` 또는 `computeRouteMatrix`)에 대한 HTTPS 요청입니다. `travelMode`는 `TRUCK`로 설정해야 하며 `routeModifiers` 객체에 `vehicleInfo`가 포함되어야 합니다.	경로 다중선, 경로 구간 및 단계 목록, 예상 이동 시간, 경로 토큰입니다.
Route Optimization API	Route Optimization API 엔드포인트에 대한 HTTPS 요청입니다. `travelMode`는 `TRUCK`로 설정해야 하며 `routeModifiers` 객체에 `vehicleInfo`가 포함되어야 합니다.	특정 차량을 위해 설계된 Fleet의 최적화된 경로 계획과 각 이동의 경로 토큰입니다.
Navigation SDK (Android, iOS)	탐색기에서 목적지를 설정할 때 경로 토큰 (대형 차량 경로 설정으로 Routes API 또는 Route Optimization API에서 생성됨)을 포함합니다.	트럭에 맞게 맞춤설정되고 원래 Routes API 또는 Route Optimization API 요청에 지정된 차량 정보를 준수하는 경로를 따르는 세부 경로 안내 내비게이션 환경입니다.

예

다음 예에서는 Routes API를 사용하여 대형 차량 경로 설정을 사용하는 데 중점을 둡니다.

예를 들어 기본 computeRoutes 요청 본문은 다음과 같습니다.

{
  "origin": { "location": { "latLng": { "latitude": 41.31, "longitude": -74.75 }}},
  "destination": { "location": { "latLng": { "latitude": 41.30, "longitude": -74.78 }}},
  "travelMode": "TRUCK",
  "routeModifiers": {
    "vehicleInfo": {
      "totalHeightMm": 4114,
      "totalLengthMm": 21945,
      "totalWeightKg": 32658,
      ... // other vehicle attributes
    }
  }
}

필수: 요청은 travelMode를 TRUCK로 설정하고 차량의 특정 크기와 속성으로 vehicleInfo 객체를 채워야 합니다.

Routes API는 지정된 차량 정보를 고려하는 경로를 반환합니다. 응답에는 지정된 필드 마스크에 따라 Navigation SDK에서 사용할 경로 다중선, 트럭 전용 도착 예정 시간, 이동 거리, 경로 토큰이 포함될 수 있습니다. 또한 응답은 완전히 규정을 준수하는 경로를 찾을 수 없는지 여부를 나타냅니다.

요청 및 응답 콘텐츠

다음 표에는 Routes API computeRoutes 메서드를 사용하여 대형 차량 경로 설정 요청을 할 때 전송하고 수신하는 데이터가 나와 있습니다.

요청 콘텐츠	응답 콘텐츠	반환 형식
출발지 및 목적지 좌표 차량의 크기, 무게, 위험물질 유형을 포함하는 `vehicleInfo` 객체	경로 다중선 트럭 전용 이동 시간 및 `distanceMeters` Navigation SDK에서 사용할 `routeToken` `routeRestrictionsPartiallyIgnored`인지 나타내는 `travelAdvisory` 객체	JSON

제한사항

시작하기 전에 다음 제한사항과 요구사항을 숙지해야 합니다.

지리적 가용성: 대형 차량 경로 설정은 미국 본토 48개 주 (정식 버전)와 일본 (실험용)에서 사용할 수 있습니다. 알래스카, 하와이, 미국령에서는 사용할 수 없습니다.
운전기사 권고 및 안전. 운전기사는 이 API에서 반환된 경로에만 의존하여 안전하거나 합법적이라고 생각해서는 안 됩니다. 경로가 차량에 적합하다고 보장되지 않으며, 경로를 따르면 운전기사가 낮은 다리 또는 대형 차량이 금지된 도로와 같은 위험에 노출될 수 있습니다.
최선의 경로. 경우에 따라 API는 이동 제한을 완전히 준수하는 경로를 찾을 수 없습니다. 대신 제한된 지역을 여전히 통과할 수 있는 '최선의' 경로를 반환합니다. Routes API 응답은 routeRestrictionsPartiallyIgnored 필드에서 이러한 경로를 명확하게 표시합니다. 이러한 경우 다른 소스 데이터를 사용하여 경로를 신중하게 계획하세요. 표시된 경로를 계획 또는 내비게이션의 단일 정보 소스로 사용하지 마세요.
지원되지 않는 기능: 대형 차량 경로 설정은 다음을 지원하지 않습니다. 다음:
- 트럭 통행료
- 제한 속도
- 방사성 위험물질 경로 설정
사용량 한도: 모든 요청에는 표준 초당 쿼리 수 (QPS) 한도가 적용됩니다.

대형 차량 경로 설정 사용 방법

Routes API에서 대형 차량 경로 설정을 사용하려면 다음 단계를 따르세요.

프로젝트 설정: Google Cloud 프로젝트가 생성되고 Routes API에 사용 설정되어 있는지 확인합니다.
대형 차량 경로 설정 프로비저닝: 대형 차량 경로 설정은 일부 고객에게만 제공됩니다. 액세스 권한을 요청하고 이 기능을 위해 프로젝트를 프로비저닝하려면 Google에 문의하세요.
요청 빌드: travelMode를 TRUCK로 설정하고 routingPreference를 TRAFFIC_AWARE_OPTIMAL로 설정하고 vehicleInfo 객체를 사용하여 차량 속성을 지정하여 computeRoutes 또는 computeRouteMatrix 엔드포인트를 호출합니다.
세부 경로 안내 내비게이션 제공 (선택사항): computeRoutes를 호출한 경우 응답에서 Navigation SDK로 routeToken을 전달하여 내비게이션 세션을 시작합니다.

다음 단계

시작하기: Routes API로 트럭 경로 및 도착 예정 시간 생성
내비게이션 추가: Android 또는 iOS용 Navigation SDK에서 트럭 전용 경로로 세부 경로 안내 내비게이션 제공