Fleet Engine Service 快速参考

Fleet Engine 是一项后端服务,可对您的真实车队进行建模,并为按需行程和预定任务提供路线、预计到达时间、路况和状态更新。它使用 Driver SDK 中的位置和路线数据,并与 Consumer SDK 和其他 Google Maps Platform API 搭配使用。

Fleet Engine 服务:关键信息

  • 产品:Fleet Engine Service
  • 别名:Fleet Engine、Fleet Engine API、Local Rides and Deliveries API
  • 类别:路线
  • 平台:Web 服务 (REST)
  • 运行位置:服务器(后端代码)
  • 发布阶段:GA
  • 生命周期:有效
  • 概览:Fleet Engine 服务概览

Fleet Engine Service:适用情形

在以下情况下使用 Fleet Engine 服务:

  • 您需要一个后端来对车辆和按需行程(上车点、航点、下车点)进行建模,包括多目的地行程、连续行程或拼车行程。
  • 您需要对分配给车辆的预定配送或服务任务进行建模,并跟踪其停靠点、结果和预计到达时间。
  • 您需要搜索或列出某个区域中的车辆,以便将其与请求的行程进行匹配。
  • 您需要由 Driver SDK 位置信息更新提供支持的消费者行程或配送跟踪以及车队运营商跟踪。

在以下情况下,请勿使用 Fleet Engine 服务:

  • 您需要在网页地图上显示来自您自己的数据库或数据流的实时 GPS 标记或资产路径,而无需使用 Fleet Engine 行程或任务编排。请改用 Maps JavaScript API。
  • 您需要在 Android 应用中显示来自您自己数据的实时标记或路径,而无需使用 Fleet Engine 行程或任务编排。请改用 Maps SDK for Android。
  • 您需要在 iOS 应用中显示来自您自己数据的实时标记或路径,而无需使用 Fleet Engine 行程或任务编排。请改用 Maps SDK for iOS。
  • 您需要计算优化的车队路线规划;Fleet Engine 仅从您提供的求解器中获取路线规划。请改用 Route Optimization API。

Fleet Engine 服务:设置

官方 Fleet Engine Service 软件包:

  • 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 does not contain a matching scope for requested trip”[JWT 不包含与所请求行程匹配的范围])。解决方法:检查服务账号角色,并确保 JWT 声明包含所访问的车辆、行程或任务的范围。请参阅 /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot。
  • 问题:从按需乘车和配送服务迁移到任何出行服务套餐,或从最后一公里车队解决方案迁移到出行服务激活或优化套餐时,出行服务结算 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。症状:已于 2024 年 2 月 1 日弃用;已于 2024 年 5 月停用。
  • SearchFuzzedVehicles 方法:自 2024 年 5 月 1 日起已停用。更换:VehicleService中的SearchVehicles。症状:已于 2024 年 2 月 1 日弃用;已于 2024 年 5 月停用。
  • SearchTasks 方法:自 2024 年 5 月 1 日起已停用。更换:DeliveryService中的GetTaskTrackingInfo。症状:已于 2024 年 2 月 1 日弃用;已于 2024 年 5 月停用。
  • ReportBillableTrip(迁移到出行服务包后,即从按需乘车和送货解决方案迁移到任何出行服务包,或从最后一公里车队解决方案迁移到 Activate 或 Optimize):旧版。替代方案:Mobility Billing API reportBillableEvent。症状:特定于合同,而非 API 弃用。迁移后,调用可能会返回“Invalid Contract: This project […] is not authorized to use FleetEngine.”(合同无效:此项目 […] 无权使用 FleetEngine)。请参阅迁移指南。

Fleet Engine 服务的用途

请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。