Fleet Engine 서비스 빠른 참조

Fleet Engine은 실제 차량을 모델링하고 주문형 이동 및 예약된 작업에 대한 경로, ETA, 교통정보, 상태 업데이트를 제공하는 백엔드 서비스입니다. Driver SDK의 위치 및 경로 데이터를 사용하며 Consumer SDK 및 기타 Google Maps Platform API와 함께 작동합니다.

Fleet Engine 서비스: 주요 사실

  • 제품: Fleet Engine 서비스
  • 다른 이름: Fleet Engine, Fleet Engine API, Local Rides and Deliveries API
  • 카테고리: 경로
  • 플랫폼: 웹 서비스(REST)
  • 실행 위치: 서버(백엔드 코드)
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: Fleet Engine 서비스 개요

Fleet Engine 서비스: 사용 시기

다음과 같은 경우 Fleet Engine 서비스 사용:

  • 차량과 주문형 이동(픽업, 경유지, 하차)을 모델링하는 백엔드가 필요합니다. 여기에는 여러 목적지, 연속 이동, 공유 이동이 포함됩니다.
  • 차량에 할당된 예약 배송 또는 서비스 작업을 모델링하고 정류장, 결과, ETA를 추적해야 합니다.
  • 요청된 차량과 일치시키려면 지역에서 차량을 검색하거나 나열해야 합니다.
  • Driver SDK 위치 업데이트를 통해 제공되는 소비자 이동 또는 배송 추적 및 차량 운영자 추적이 필요합니다.

다음과 같은 경우 Fleet Engine 서비스를 사용하지 마세요.

  • Fleet Engine 이동 또는 작업 조정 없이 자체 데이터베이스 또는 스트림의 웹 지도에 실시간 GPS 마커 또는 애셋 경로를 표시해야 합니다. 대신 Maps JavaScript API를 사용하세요.
  • Fleet Engine 이동 또는 작업 조정 없이 Android 앱에서 자체 데이터의 실시간 마커 또는 경로를 표시해야 합니다. 대신 Android용 Maps SDK를 사용하세요.
  • Fleet Engine 이동 또는 작업 조정 없이 iOS 앱에서 자체 데이터의 실시간 마커 또는 경로를 표시해야 합니다. 대신 iOS용 Maps SDK를 사용하세요.
  • 최적화된 차량 전체 경로 계획을 계산해야 합니다. Fleet Engine은 제공된 솔버의 경로 계획만 사용합니다. 대신 Route Optimization API를 사용하세요.

Fleet Engine 서비스: 설정

공식 Fleet Engine 서비스 패키지:

  • maven: com.google.maps:google-maps-fleetengine
  • maven: com.google.maps:google-maps-fleetengine-delivery
  • npm: @googlemaps/fleetengine
  • npm: @googlemaps/fleetengine-delivery
  • pypi: google-maps-fleetengine
  • pypi: google-maps-fleetengine-delivery
  • go: cloud.google.com/go/maps

Fleet Engine 서비스: 일반적인 실수

  • 문제: Fleet Engine에 대한 요청이 가끔 실패할 수 있으며, 실패 후에는 차량과 같은 항목이 더 이상 존재하지 않을 수 있습니다(업데이트 시 NOT_FOUND). 해결 방법: 백오프를 사용하여 재시도를 구현하고(클라이언트 라이브러리는 기본적으로 재시도함) 누락된 차량 또는 할 일을 현재 상태로 다시 만듭니다. /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot을 참고하세요.
  • 문제: 요청이 클라이언트 라이브러리의 기본 제한 시간보다 오래 걸리면 DEADLINE_EXCEEDED 오류가 발생합니다. 해결 방법: RPC 재시도 설정을 조정합니다(예: Java 클라이언트의 VehicleServiceSettings에 있는 setTotalTimeout). /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot을 참고하세요.
  • 문제: JWT에 올바른 클레임이 없거나 서명 서비스 계정에 필요한 Fleet Engine IAM 역할이 없는 경우 PERMISSION_DENIED(HTTP 403)(예: 'JWT에 요청된 이동에 일치하는 범위가 포함되어 있지 않음') 해결 방법: 서비스 계정 역할을 확인하고 JWT 클레임에 액세스 중인 차량, 이동 또는 할 일의 범위가 포함되어 있는지 확인합니다. /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot을 참고하세요.
  • 문제: 주문형 차량 및 배송에서 Mobility 패키지로 이전하거나 Last Mile Fleet Solution에서 Mobility Activate 또는 Optimize로 이전할 때 이전이 완료될 때까지 Mobility Billing API 요청에서 HTTP 202를 반환하고 결제가 발생하지 않습니다. 해결 방법: 이전 며칠 전부터 이전 며칠 후까지 Fleet Engine ReportBillableTrip과 Mobility Billing API를 모두 호출하고 Cloud Logging에서 요청 수를 비교한 다음 ReportBillableTrip 호출을 삭제합니다. /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration을 참고하세요.

Fleet Engine 서비스: 기존 및 지원 중단된 기능

  • UpdateVehicleLocation 메서드: 2024년 5월 1일부터 사용 중단되었습니다. 교체: VehicleService에서 UpdateVehicle. Symptom: 2024년 2월 1일에 지원 중단되었으며 2024년 5월에 사용 중단되었습니다.
  • SearchFuzzedVehicles 메서드: 2024년 5월 1일부터 사용 중단되었습니다. 교체: VehicleService에서 SearchVehicles. Symptom: 2024년 2월 1일에 지원 중단되었으며 2024년 5월에 사용 중단되었습니다.
  • SearchTasks 메서드: 2024년 5월 1일부터 사용 중단되었습니다. 교체: DeliveryService에서 GetTaskTrackingInfo. Symptom: 2024년 2월 1일에 지원 중단되었으며 2024년 5월에 사용 중단되었습니다.
  • ReportBillableTrip 이동성 패키지로 이전한 후(주문형 차량 공유 및 배송에서 모든 패키지로, 또는 라스트 마일 Fleet 솔루션에서 활성화 또는 최적화로): 기존. 대체: Mobility Billing API reportBillableEvent. 증상: API 지원 중단이 아닌 계약별 문제 마이그레이션 후 호출에서 '잘못된 계약: 이 프로젝트 […] 는 FleetEngine을 사용할 권한이 없습니다.'를 반환할 수 있습니다. 이전 가이드를 참고하세요.

Fleet Engine 서비스로 할 수 있는 작업

각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.