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 서비스: 설정
- 사용 설정할 서비스:
fleetengine.googleapis.com - 인증: 서비스 계정, JSON 웹 토큰(JWT), OAuth 2.0
- 사용 기여 분석: 선택적 베타 기능: Mobility 패키지 서비스 호출 시
X-Goog-Maps-Experience-IDHTTP 헤더를 Mobility 거래 ID(또는 세션 ID와 같은 관련 ID)로 설정합니다. 여러 ID는 쉼표로 구분합니다. 거래를 보고할 때related_ids에 관련 ID를 전달합니다. - 시작하기: Fleet Engine 서비스 설정
- 참조: Fleet Engine 서비스 참조
- 정책: Fleet Engine 서비스 정책
- 출시 노트: 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 서비스: 관련 상품
- 함께 자주 사용되는 제품: Android용 Driver SDK, iOS용 Driver SDK, Android용 Consumer SDK, iOS용 Consumer SDK, JavaScript Consumer SDK, Route Optimization API
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 APIreportBillableEvent. 증상: API 지원 중단이 아닌 계약별 문제 마이그레이션 후 호출에서 '잘못된 계약: 이 프로젝트 […] 는 FleetEngine을 사용할 권한이 없습니다.'를 반환할 수 있습니다. 이전 가이드를 참고하세요.
Fleet Engine 서비스로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
- 청구 가능한 Fleet Engine 이동 사용량을 보고합니다.
- 새 Fleet Engine 이동을 만들고 반환합니다.
- Fleet Engine 이동에 관한 정보를 반환합니다.
- 지정된 차량의 모든 Fleet Engine 이동 목록을 반환합니다.
- Fleet Engine 이동의 이동 데이터를 업데이트합니다.
- 주문형 차량 공유 또는 배송 제공업체와 연결된 Fleet Engine에서 새 차량을 인스턴스화합니다.
- Fleet Engine 서비스에서 차량을 반환합니다.
- 지정된 기준과 일치하는 제공업체와 연결된 Fleet Engine의 차량 페이지로 나눈 목록을 반환합니다.
- 지정된 기준과 일치하는 Fleet Engine의 차량 목록을 반환합니다.
- Fleet Engine에서 차량의 차량 데이터를 업데이트합니다.
- Fleet Engine에서 차량의 차량 속성을 업데이트합니다.
- Fleet Engine 서비스에서 차량의 이동 정보를 반환합니다.