Fleet Engine Entities

Task 接口

google.maps.journeySharing.Task接口

Fleet Engine 返回的任务的详细信息。

name
类型string
任务名称,格式为“providers/{provider_id}/tasks/{task_id}”。task_id 必须是唯一标识符,而不是跟踪 ID。要存储运单的跟踪 ID,请使用 tracking_id 字段。多个任务可以具有相同的跟踪 ID。
remainingVehicleJourneySegments
需要完成此任务的细分受众群剩余信息。
status
类型string
任务的当前执行状态。
type
类型string
任务类型;例如,中断或运单。
estimatedCompletionTime optional
类型Date optional
任务预计完成时间的时间戳。
latestVehicleLocationUpdate optional
类型VehicleLocationUpdate optional
上次位置信息更新的相关信息。
outcome optional
类型string optional
任务的结果。
outcomeLocation optional
类型LatLngLiteral optional
任务完成地点(来自提供商)。
outcomeLocationSource optional
类型string optional
任务结果位置设置者(“PROVIDER”或“LAST_VEHICLE_LOCATION”)。
outcomeTime optional
类型Date optional
设置任务结果的时间戳(来自提供方)。
plannedLocation optional
类型LatLngLiteral optional
要在其中完成任务的位置。
trackingId optional
类型string optional
运单的跟踪 ID。
vehicleId optional
类型string optional
执行此任务的车辆的 ID。

TaskTrackingInfo 接口

google.maps.journeySharing.TaskTrackingInfo接口

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

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
任务的当前执行状态。
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
路标数组,表示从当前位置到下车点的路径。
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
分配给此送货车辆的行程段,从最近一次报告的车辆位置开始。
currentRouteSegmentEndPoint optional
类型LatLngLiteral optional
当前路由段结束的位置。
latestVehicleLocationUpdate optional
类型VehicleLocationUpdate optional
上次报告送货车辆的位置。
remainingDurationMillis optional
类型number optional
当前路线路段的剩余行驶时长(以毫秒为单位)。

DeliveryVehicleStop 接口

google.maps.journeySharing.DeliveryVehicleStop接口

DeliveryVehicleStop 类型

tasks
类型Array<{
  id:string optional,
  extraDurationMillis:number optional
}>
要在此停止执行的任务列表。
  • id:任务的 ID。
  • extraDurationMillis:执行任务所需的额外时间(以毫秒为单位)。

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
类型Array<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
从上一个航点(或车辆的当前位置,如果此航点列表中的第一个航点)到此航点的路径。