Routes API 대형 차량 경로 탐색 기능은 대형 차량의 경로와 도착 예정 시간 (ETA)을 계산하는 서비스 모음입니다. 높이, 무게, 길이, 유해 물질 분류와 같은 차량 속성을 지정하는 요청을 수락하여 관련 제한사항을 피하도록 최적화된 경로를 반환합니다. 또한 이 서비스는 트럭 전용 경로를 따라 운전자에게 세부 경로 안내를 제공하기 위해 Navigation SDK에 전달할 수 있는 경로 토큰 을 생성합니다.
대형 차량 경로 탐색을 사용하는 이유
대형 차량 경로 탐색을 사용하여 대형 차량의 물류 문제를 해결하는 애플리케이션을 빌드하세요.
| 이점 | 애플리케이션 동작 |
|---|---|
| 가격 책정 및 계획 정확도 개선 | 트럭 및 버스와 같은 대형 차량의 더 정확한 견적 및 배송 기간을 허용하는 트래픽 정보를 기반으로 하는 구체적인 ETA를 생성합니다. |
| 운전자 안전 및 효율성 향상 | 낮은 다리, 무게 제한 도로, 기타 위험을 피하는 경로를 따라 운전자를 안내합니다. |
| 차량 전체 운영 간소화 | 대형 차량 경로 탐색과 함께 Route Optimization을 사용하여 전체 차량의 적재 할당 및 정지 순서를 최적화합니다. Fleet Engine을 사용하여 할당 및 차량 위치를 실시간으로 확인할 수 있습니다. |
| 교육 최소화 및 도입률 증가 | 자체 애플리케이션 내에서 대형 차량 또는 트럭 운전자에게 익숙한 Google 지도 내비게이션 환경을 제공합니다. |
대형 차량 경로 탐색으로 할 수 있는 작업
대형 차량 경로 탐색을 사용하면 다음과 같은 주요 작업을 실행할 수 있습니다.
- 높이, 무게, 길이, 너비, 차축 수, 유해 물질 분류를 포함한 세부 차량 프로필을 지정 합니다.
- Google의 포괄적인 도로 데이터 및 트래픽 모델을 사용하여 차량 속성에 맞게 특별히 계산된 경로, 이동 시간, 이동 거리 를 가져옵니다.
- 새로운 트럭 전용 ETA 모델을 사용하여 더 정확한 ETA를 계산 합니다. 이 모델은 관찰된 트럭 이동 속도와 실시간 및 예측 트래픽 데이터를 결합하여 대형 차량의 더 정확한 추정치를 제공합니다.
- 경로 토큰을 사용하여 Routes API에서 트럭 안전 경로를 전송하여 Navigation SDK에서 세부 경로 안내를 사용 설정 합니다.
- 경로 매트릭스를 계산 하여 차량 전체 계획을 위해 여러 출발지와 목적지 간의 이동 시간과 거리를 결정합니다.
- 실현 가능성과 안전성을 고려하는 전반적인 운영 효율성을 위해 트럭 차량의 경로 계획을 최적화 합니다.
대형 차량 경로 탐색 작동 방식
대형 차량 경로 탐색 기능은 다음 서비스를 통해 작동합니다.
| 엔드포인트 | 작업 | 출력 |
|---|---|---|
| Routes API | 출발지와 목적지가 포함된 요청 본문이 있는 Routes API 엔드포인트 (computeRoutes 또는 computeRouteMatrix)에 대한 HTTPS 요청입니다. travelMode는 TRUCK로 설정해야 하며 routeModifiers 객체에 차량 프로필이 포함되어야 합니다.
|
경로 폴리라인, 경로 구간 및 단계 목록, 예상 이동 시간, 경로 토큰입니다. |
| Route Optimization API | Route Optimization API 엔드포인트에 대한 HTTPS 요청입니다. travelMode는 TRUCK로 설정해야 하며 routeModifiers 객체에 차량 프로필이 포함되어야 합니다.
routeModifiers 객체의 이동 모드 및 차량 프로필입니다.
|
특정 차량 프로필에 맞게 설계된 차량의 최적화된 경로 계획 및 각 이동의 경로 토큰입니다. |
| Navigation SDK | `setDestination`을 호출할 때 경로 토큰 (대형 차량 경로 탐색을 사용하여 Routes API 또는 Route Optimization API에서 생성됨)을 포함합니다.setDestination
|
트럭에 맞게 맞춤설정되고 원래 Routes API 또는 Route Optimization API 요청에 지정된 차량 프로필을 준수하는 경로를 따르는 세부 경로 안내 환경입니다. |
예
필수: 요청은 travelMode를 TRUCK로 설정하고 차량의 특정 크기와 속성으로
vehicleInfo 객체를 채워야 합니다.
예를 들어 기본 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
}
}
}
이 서비스는 이 요청을 처리하고 지정된 차량 프로필을 고려하는 경로를 반환합니다. 응답에는 지정된 fieldmask에 따라 Navigation SDK에서 사용할 경로 폴리라인, 트럭 전용 ETA, 이동 거리, 경로 토큰이 포함될 수 있습니다. 또한 응답은 완전히 규정을 준수하는 경로를 찾을 수 없는지 여부를 나타냅니다.
요청 및 응답 콘텐츠
다음 표에는 대형 차량 경로 탐색 요청을 하는 데 사용하는 리소스와 반환되는 데이터가 요약되어 있습니다.
| 요청 콘텐츠 | 응답 콘텐츠 | 반환 형식 |
|---|---|---|
|
|
JSON |
제한사항
시작하기 전에 다음 제한사항과 요구사항을 숙지해야 합니다.
- 지리적 사용 가능 여부: 대형 차량 경로 탐색은 미국 본토 48개 주에서만 사용할 수 있습니다.
- 대형 차량 경로 탐색은 미리보기 단계의 제품 입니다. 운전자는 이 API에서 반환된 경로가 안전하거나 합법적이라고 전적으로 의존해서는 안 됩니다. 경로가 차량에 적합하다고 보장되지 않으며, 경로를 따르면 운전자가 낮은 다리 또는 대형 차량이 금지된 도로와 같은 위험에 노출될 수 있습니다.
- 최선의 경로. 경우에 따라 API에서 이동 제한사항을 완전히 준수하는 경로를 찾을 수 없습니다. 대신 제한된 지역을 여전히 통과할 수 있는 '최선의' 경로를 반환합니다. Routes API 응답은
routeRestrictionsPartiallyIgnored필드에서 이러한 경로를 명확하게 표시합니다. 이러한 경우 다른 소스 데이터를 사용하여 경로를 신중하게 계획하세요. 계획 또는 내비게이션을 위한 단일 정보 소스로 표시된 경로를 사용하지 마세요. - 지원되지 않는 기능: 이 제품에 더 많은 기능을 제공하기 위해 노력하고 있지만 대형 차량 경로 탐색은 다음을 지원하지 않습니다.
- 트럭 통행료
- 제한 속도
- 방사성 유해 물질 경로 탐색
- 사용량 한도: 모든 요청에는 표준 초당 쿼리 수 (QPS) 한도가 적용됩니다.
대형 차량 경로 탐색을 사용하는 방법
- 프로젝트 설정: Google Cloud 프로젝트가 생성되고 Routes API에 사용 설정되어 있는지 확인합니다.
- 대형 차량 경로 탐색 프로비저닝: Google 담당자에게 문의하여 이 제한된 미리보기 기능에 맞게 프로젝트를 프로비저닝합니다.
- 경로 요청 빌드:
travelMode가TRUCK로 설정되고VehicleInfo객체를 사용하여 가상 차량이 지정된computeRoutes엔드포인트를 호출합니다. - 세부 경로 안내 제공 (선택사항): 응답에서 Navigation SDK로
routeToken을 전달하여 내비게이션 세션을 시작합니다.