대형 차량 경로 개요

도로에 있는 대형 트럭 사진

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

대형 차량 경로를 사용하는 이유

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

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

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

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

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

대형 차량 경로의 작동 방식

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

엔드포인트 작업 출력
Routes API 출발지와 목적지가 포함된 요청 본문이 있는 Routes API 엔드포인트 (computeRoutes 또는 computeRouteMatrix)에 대한 HTTPS 요청 travelMode는 TRUCK로 설정해야 하며 routeModifiers 객체에는 vehicleInfo가 포함되어야 합니다. 경로 다중선, 경로 구간 및 단계 목록, 예상 이동 시간, 경로 토큰
Route Optimization API Route Optimization API 엔드포인트에 대한 HTTPS 요청입니다. travelMode는 TRUCK로 설정해야 하며 routeModifiers 객체에는 vehicleInfo가 포함되어야 합니다. 특정 차량에 맞게 설계된 차량의 최적화된 이동 계획과 각 이동의 경로 토큰입니다.
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
  • routeToken를 Navigation SDK와 함께 사용합니다.
  • routeRestrictionsPartiallyIgnored인지 여부를 나타내는 travelAdvisory 객체입니다.
 JSON

제한사항

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

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

대형 차량 경로 사용 방법

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

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

다음 단계

  • 시작하기: Routes API로 트럭 경로 및 ETA 생성하기
  • 내비게이션 추가: Android 또는 iOS용 Navigation SDK에서 트럭 전용 경로를 사용하는 세부 경로 안내 내비게이션을 제공합니다.