대형 차량 경로 개요

도로 위의 대형 트럭 사진

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

대형 차량 라우팅을 사용하는 이유

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

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

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

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

  • 높이, 무게, 길이, 너비, 차축 수, 위험물 분류 등 자세한 차량 속성을 지정합니다.
  • 차량 속성에 맞게 특별히 계산된 경로, 이동 시간, 이동 거리를 가져옵니다.
  • U턴을 자동으로 피하고 주간 고속도로와 고속도로를 적극적으로 선호하여 기동성에 최적화된 경로를 생성합니다. 이렇게 하면 대형 차량이 운전자의 요구사항과 기대치를 충족하는 경로를 유지할 수 있습니다.
  • 트럭 전용 도착예정시간 모델을 사용하여 더 정확한 도착예정시간을 계산합니다. 이 모델은 관찰된 트럭 이동 속도와 실시간 및 예측 교통 데이터를 결합하여 대형 차량에 대한 더 정확한 추정치를 제공합니다.
  • 경로 토큰을 사용하여 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를 포함해야 합니다. 특정 차량에 맞게 설계된 차량용 최적화된 경로 계획과 각 여정의 경로 토큰
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로 대형 차량 경로를 사용하려면 다음 단계를 따르세요.

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

다음 단계

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