Fleet Engine Entities

Task 接口

google.maps.journeySharing.Task 接口

Fleet Engine 返回的任务详情。

属性
attributes	类型：Object<string, *> 分配给任务的属性。
name	类型：string 任务名称，格式为“providers/{provider_id}/tasks/{task_id}”。task_id 必须是唯一标识符，而不是跟踪 ID。要存储运单的跟踪 ID，请使用 tracking_id 字段。多个任务可以具有相同的跟踪 ID。
remainingVehicleJourneySegments	类型：Array<VehicleJourneySegment> 有关此任务需要完成的细分受众群的信息。
status	类型：string 任务的当前执行状态。
type	类型：string 任务类型；例如中断或配送。
estimatedCompletionTime optional	类型：Date optional 任务预计完成时间的时间戳。
latestVehicleLocationUpdate optional	类型：VehicleLocationUpdate optional 上次位置信息更新的相关信息。
outcome optional	类型：string optional 任务的结果。
outcomeLocation optional	类型：LatLngLiteral optional 完成任务的位置（来自提供商）。
outcomeLocationSource optional	类型：string optional 任务结果位置的 setter（PROVIDER 或 LAST_VEHICLE_LOCATION）。
outcomeTime optional	类型：Date optional 设置任务结果时的时间戳（来自提供方）。
plannedLocation optional	类型：LatLngLiteral optional 将完成任务的位置。
targetTimeWindow optional	类型：TimeWindow optional 应完成任务的时间范围。
trackingId optional	类型：string optional 运单的跟踪 ID。
vehicleId optional	类型：string optional 执行此任务的车辆的 ID。

TaskInfo 接口

google.maps.journeySharing.TaskInfo 接口

TaskInfo 类型，由 DeliveryVehicleStop 使用。

属性
extraDurationMillis optional	类型：number optional 执行任务额外时间，以毫秒为单位。
id optional	类型：string optional 任务的 ID。
targetTimeWindow optional	类型：TimeWindow optional 应完成任务的时间范围。

TaskTrackingInfo 接口

google.maps.journeySharing.TaskTrackingInfo 接口

Fleet Engine 返回的任务跟踪信息对象的详细信息。

属性
attributes	类型：Object<string, *> 分配给任务的属性。
name	类型：string 名称采用“providers/{provider_id}/taskTrackingInfo/{tracking_id}”格式，其中 tracking_id 表示跟踪 ID。
trackingId	类型：string 任务的跟踪 ID。 必须是有效的 Unicode 字符串。 长度上限为 64 个字符。 根据 Unicode 标准化表 C 进行归一化。 不得包含以下任何 ASCII 字符：“/”“:”“?”“,”或“#”。
estimatedArrivalTime optional	类型：Date optional 预计到达经停点的时间。
estimatedTaskCompletionTime optional	类型：Date optional 任务的预计完成时间。
latestVehicleLocationUpdate optional	类型：VehicleLocationUpdate optional 上次位置信息更新的相关信息。
plannedLocation optional	类型：LatLng optional 将完成任务的位置。
remainingDrivingDistanceMeters optional	类型：number optional 到相关 VehicleStop 的剩余总距离（以米为单位）。
remainingStopCount optional	类型：number optional 指示车辆到达任务站（包括任务站）为止所经过的停靠点数量。例如，如果车辆的下一站是任务站，则值将为 1。
routePolylinePoints optional	类型：Array<LatLng> optional 一个点列表，一系列点在连接后会形成一条多段线，其中包含车辆预计导航到此任务位置的路线。
state optional	类型：string optional 任务的当前执行状态。
targetTimeWindow optional	类型：TimeWindow optional 应完成任务的时间范围。
taskOutcome optional	类型：string optional 尝试执行任务的结果。
taskOutcomeTime optional	类型：Date optional 提供商设置任务结果的时间。

Trip 接口

google.maps.journeySharing.Trip 接口

Fleet Engine 返回的行程详情。

属性
name	类型：string 格式为“providers/{provider_id}/trips/{trip_id}”。Trip_id 必须是唯一标识符。
passengerCount	类型：number 此次行程的乘客人数；不包括司机。
remainingWaypoints	类型：Array<VehicleWaypoint> 一组航点，表示从当前位置到下车点的路径。
status	类型：string 行程的当前状态。可能的值包括 UNKNOWN_TRIP_STATUS、NEW、ENROUTE_TO_PICKUP、ARRIVED_AT_PICKUP、ARRIVED_AT_INTERMEDIATE_DESTINATION、ENROUTE_TO_INTERMEDIATE_DESTINATION、ENROUTE_TO_DROPOFF、COMPLETE 或 CANCELED。
type	类型：string 行程类型。可能的值包括 UNKNOWN_TRIP_TYPE、SHARED 或 EXCLUSIVE。
vehicleId	类型：string 负责此次行程的车辆 ID。
actualDropOffLocation optional	类型：LatLngLiteral optional 客户下车的位置。
actualPickupLocation optional	类型：LatLngLiteral optional 客户自提的位置。
dropOffTime optional	类型：Date optional 预计乘客下车的未来时间，或他们实际下车的实际时间。
latestVehicleLocationUpdate optional	类型：VehicleLocationUpdate optional 上次位置信息更新的相关信息。
pickupTime optional	类型：Date optional 预计乘客上车的未来时间，或接载乘客的实际时间。
plannedDropOffLocation optional	类型：LatLngLiteral optional 客户表示将离开的地点。
plannedPickupLocation optional	类型：LatLngLiteral optional 客户表示会自提。

DeliveryVehicle 接口

google.maps.journeySharing.DeliveryVehicle 接口

Fleet Engine 返回的送货车辆的详细信息。

属性
attributes	类型：Object<string, string optional> 定制送货车辆属性。
name	类型：string 格式为“providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}”。delivery_vehicle_id 必须是唯一标识符。
navigationStatus	类型：string 车辆的当前导航状态。
remainingDistanceMeters	类型：number 当前路线段的剩余行驶距离（以米为单位）。
remainingVehicleJourneySegments	类型：Array<VehicleJourneySegment> 分配给此送货车辆的行程路段（从该车辆最近报告的位置开始）。仅当通过 FleetEngineDeliveryVehicleLocationProvider 提供 DeliveryVehicle 数据对象时，此字段才会显示内容。
currentRouteSegmentEndPoint optional	类型：LatLngLiteral optional 当前路线段的结束位置。
latestVehicleLocationUpdate optional	类型：VehicleLocationUpdate optional 上次报告送货车辆的位置。
remainingDurationMillis optional	类型：number optional 当前路线路段的剩余行驶时长（以毫秒为单位）。

DeliveryVehicleStop 接口

google.maps.journeySharing.DeliveryVehicleStop 接口

DeliveryVehicleStop 类型

属性
tasks	类型：Array<TaskInfo> 要在此位置执行的任务列表。 id：任务的 ID。 extraDurationMillis：执行任务的额外时间（以毫秒为单位）。
plannedLocation optional	类型：LatLngLiteral optional 经停点的位置。
state optional	类型：DeliveryVehicleStopState optional 经停点的状态。

DeliveryVehicleStopState 常量

google.maps.journeySharing.DeliveryVehicleStopState 常量

DeliveryVehicleStop 的当前状态。

通过调用 const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库。

常量
ARRIVED	已抵达经停点。假设车辆要导航到下一站时，之前的所有经停点都已完成。
ENROUTE	已分配且处于活跃状态。
NEW	已创建，但未主动路由。
UNSPECIFIED	未知。

VehicleJourneySegment 接口

google.maps.journeySharing.VehicleJourneySegment 接口

VehicleJourneySegment 类型

属性
drivingDistanceMeters optional	类型：number optional 从上一个经停点到此经停点的行程距离（以米为单位）。
drivingDurationMillis optional	类型：number optional 上一个停止点的行程时间，以毫秒为单位。
path optional	类型：Array<LatLngLiteral> optional 从上次经停点（如果车辆在此经停点列表中是第一个经停点）到此经停点的第一个地点，则为车辆的当前位置。
stop optional	类型：DeliveryVehicleStop optional 充电站的相关信息。

VehicleLocationUpdate 接口

google.maps.journeySharing.VehicleLocationUpdate 接口

VehicleLocationUpdate 类型

属性
heading optional	类型：number optional 更新的标题。0 对应于北，180 到南。
location optional	类型：LatLngLiteral|LatLng optional 更新的位置。
speedKilometersPerHour optional	类型：number optional 速度（以公里/小时为单位）。
time optional	类型：Date optional 从车辆收到此更新的时间。

VehicleWaypoint 接口

google.maps.journeySharing.VehicleWaypoint 接口

VehicleWaypoint 类型。

属性
distanceMeters optional	类型：number optional 上一个航点（如果车辆是航点列表中的第一个航点，则为车辆的当前位置）与此航点之间的路径距离（以米为单位）。
durationMillis optional	类型：number optional 先前的航点（或车辆的当前位置，如果此航点是航点列表中的第一个）之间的行程时间，以毫秒为单位。
location optional	类型：LatLngLiteral optional 航点的位置。
path optional	类型：Array<LatLngLiteral> optional 从上一个航点（如果车辆是航点列表中的第一个航点）到此航点的路径，则指车辆的当前位置。

Vehicle 接口

google.maps.journeySharing.Vehicle 接口

注意：仅适用于 v=beta 渠道。

Fleet Engine 返回的车辆的详细信息。

属性
attributes	类型：Object<string, *> 自定义车辆属性。
name	类型：string 格式为“providers/{provider_id}/vehicles/{vehicle_id}”。Vehicle_id 必须是唯一标识符。
navigationStatus	类型：VehicleNavigationStatus 车辆的当前导航状态。
remainingDistanceMeters	类型：number 当前路线段的剩余行驶距离（以米为单位）。
vehicleState	类型：VehicleState 车辆状态。
vehicleType	类型：VehicleType 此交通工具的类型。
currentRouteSegmentEndPoint optional	类型：TripWaypoint optional 当前路线段的终点。
currentRouteSegmentVersion optional	类型：Date optional 设置当前路线路段的时间。
currentTrips optional	类型：Array<string> optional 当前分配给这辆车的行程的 ID 列表。
etaToFirstWaypoint optional	类型：Date optional 航点字段中第一个条目的预计到达时间。
latestLocation optional	类型：VehicleLocationUpdate optional 上次报告的车辆位置。
maximumCapacity optional	类型：number optional 这辆车可以载入的总乘客数。此值不考虑司机。
supportedTripTypes optional	类型：Array<TripType> optional 这辆车支持的行程类型。
waypoints optional	类型：Array<TripWaypoint> optional 分配给此车辆的其余航点。
waypointsVersion optional	类型：Date optional 上次更新航点字段的时间。

VehicleNavigationStatus 常量

google.maps.journeySharing.VehicleNavigationStatus 常量

注意：仅适用于 v=beta 渠道。

Vehicle 的当前导航状态。

通过调用 const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库。

常量
ARRIVED_AT_DESTINATION	车辆距离目的地大约 50 米以内。
ENROUTE_TO_DESTINATION	精细导航处于可用状态，驱动程序应用导航已进入 GUIDED_NAV 模式。
NO_GUIDANCE	驾驶应用的导航处于 FREE_NAV 模式。
OFF_ROUTE	车辆偏离了建议的路线。
UNKNOWN_NAVIGATION_STATUS	未指定导航状态。

VehicleState 常量

google.maps.journeySharing.VehicleState 常量

注意：仅适用于 v=beta 渠道。

Vehicle 的当前状态。

通过调用 const {VehicleState} = await google.maps.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库。

常量
OFFLINE	此车辆不接受新行程。
ONLINE	车辆正在接受新行程。
UNKNOWN_VEHICLE_STATE	车辆状态未知。

VehicleType 常量

google.maps.journeySharing.VehicleType 常量

注意：仅适用于 v=beta 渠道。

Vehicle 的类型。

通过调用 const {VehicleType} = await google.maps.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库。

常量
AUTO	汽车。
TAXI	任何以出租车形式（通常是获得执照或监管的）车辆。
TRUCK	具有大存储空间的车辆。
TWO_WHEELER	摩托车、轻便摩托车或其他两轮车。
UNKNOWN	车辆类型未知。

TripType 常量

google.maps.journeySharing.TripType 常量

注意：仅适用于 v=beta 渠道。

Vehicle 支持的行程类型。

通过调用 const {TripType} = await google.maps.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库。

常量
EXCLUSIVE	此行程仅适用于车辆。
SHARED	该行程可能会与其他行程共用车辆。
UNKNOWN_TRIP_TYPE	未知的行程类型。

TripWaypoint 接口

google.maps.journeySharing.TripWaypoint 接口

注意：仅适用于 v=beta 渠道。

TripWaypoint 类型。

属性
distanceMeters optional	类型：number optional 上一个航点（如果车辆是航点列表中的第一个航点，则为车辆的当前位置）与此航点之间的路径距离（以米为单位）。
durationMillis optional	类型：number optional 先前的航点（或车辆的当前位置，如果此航点是航点列表中的第一个）之间的行程时间，以毫秒为单位。
location optional	类型：LatLngLiteral optional 航点的位置。
tripId optional	类型：string optional 与此航点关联的行程。
waypointType optional	类型：WaypointType optional 此航点在此行程中发挥的作用（例如上车或下车）。

WaypointType 常量

google.maps.journeySharing.WaypointType 常量

注意：仅适用于 v=beta 渠道。

Vehicle 支持的航点类型。

通过调用 const {WaypointType} = await google.maps.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库。

常量
DROP_OFF_WAYPOINT_TYPE	乘客下车的航点。
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE	多目的地行程中中间目的地的航点。
PICKUP_WAYPOINT_TYPE	接载乘客的航点。
UNKNOWN_WAYPOINT_TYPE	未知航点类型。

TimeWindow 接口

google.maps.journeySharing.TimeWindow 接口

时间范围。

属性
endTime	类型：Date 时间段的结束时间（含时间范围）。
startTime	类型：Date 时间范围（含）的开始时间。