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 服务:设置
- 要启用的服务:
fleetengine.googleapis.com - 身份验证:服务账号、JSON Web 令牌 (JWT)、OAuth 2.0
- 使用情况归因:可选 Beta 版功能:在调用出行服务包服务时,将
X-Goog-Maps-Experience-IDHTTP 标头设置为出行服务交易 ID(或相关 ID,例如会话 ID);使用英文逗号分隔多个 ID。在报告交易时,在related_ids中传递任何相关 ID。 - 开始使用:设置 Fleet Engine 服务
- 参考文档:Fleet Engine Service 参考文档
- 政策:Fleet Engine 服务政策
- 版本说明:Fleet Engine Service 版本说明
官方 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 服务:相关产品
- 通常与以下产品搭配使用:Driver SDK for Android、Driver SDK for iOS、Consumer SDK for Android、Consumer SDK for iOS、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 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 APIreportBillableEvent。症状:特定于合同,而非 API 弃用。迁移后,调用可能会返回“Invalid Contract: This project […] is not authorized to use FleetEngine.”(合同无效:此项目 […] 无权使用 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 服务返回车辆的行程信息。