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 字段。多个任务可以有相同的 tracking_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”)的 setter。
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
Task 的当前执行状态。
targetTimeWindow optional
类型TimeWindow optional
应完成任务的时间范围。
taskOutcome optional
类型string optional
尝试执行 Task 的结果。
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
分配给此送货车辆的行程路段,从车辆最近报告的位置开始。仅当通过 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
从上一个航点(或车辆的当前位置,如果该航点是航点列表中的第一个航点)到此航点的路径。
speedReadingIntervals optional
类型Array<SpeedReadingInterval> optional
从上一个航点(或车辆位置)到当前航点的路径沿线的车流速度列表。列表中的每个间隔表示路径上连续路段上的流量;间隔通过索引定义了路段的起点和终点。如需了解详情,请参阅 SpeedReadingInterval 的定义。

车载界面

google.maps.journeySharing.Vehicle 接口

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

attributes
类型Object<string, *>
自定义车辆属性。
name
类型string
格式为“providers/{provider_id}/vehicles/{vehicle_id}”。车辆 ID 必须是唯一标识符。
navigationStatus
车辆的当前导航状态。
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 常量

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 常量

Vehicle 的当前状态。

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

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

VehicleType 常量

google.maps.journeySharing.VehicleType 常量

Vehicle 的类型。

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

AUTO 一辆汽车。
TAXI 充当出租车的任何车辆(通常是获得许可或管制车辆)。
TRUCK 具有大存储空间容量的车辆。
TWO_WHEELER 摩托车、轻便摩托车或其他双轮机动车。
UNKNOWN 未知的车辆类型。

TripType 常量

google.maps.journeySharing.TripType 常量

Vehicle 支持的行程类型。

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

EXCLUSIVE 此行程为车辆专属行程。
SHARED 此行程可能会与其他行程共用一辆车。
UNKNOWN_TRIP_TYPE 未知行程类型。

TripWaypoint 接口

google.maps.journeySharing.TripWaypoint 接口

TripWaypoint 类型。

distanceMeters optional
类型number optional
上一个航点(或车辆的当前位置,如果该航点是航点列表中的第一个航点)到该航点之间的路径距离(以米为单位)。
durationMillis optional
类型number optional
上一个航点(或车辆的当前位置,如果该航点是航点列表中的第一个航点)到此航点之间的行程时间(以毫秒为单位)。
location optional
类型LatLng optional
航点的位置。
path optional
类型Array<LatLng> optional
从上一个停靠站(或车辆的当前位置,如果该停靠站是车站列表中的第一个停靠站)到该停靠站的路径。
speedReadingIntervals optional
类型Array<SpeedReadingInterval> optional
从上一个航点(或车辆位置)到当前航点的路径沿线的车流速度列表。列表中的每个间隔表示路径上连续路段上的流量;间隔通过索引定义了路段的起点和终点。如需了解详情,请参阅 SpeedReadingInterval 的定义。
tripId optional
类型string optional
与此航点相关联的行程。
waypointType optional
类型WaypointType optional
此航点在此行程中发挥的作用,例如上车点或下车点。

WaypointType 常量

google.maps.journeySharing.WaypointType 常量

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
时间范围的开始时间(含此时间)。

速度常量

google.maps.journeySharing.Speed 常量

根据路况数据对多段线速度的分类。

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

NORMAL 正常速度,未检测到行驶缓慢。
SLOW 检测到行驶缓慢,但未形成交通拥堵。
TRAFFIC_JAM 检测到交通堵塞。

SpeedReadingInterval 接口

google.maps.journeySharing.SpeedReadingInterval 接口

某个连续路径段上的交通密度指示器。间隔时间通过索引定义片段的起点和终点。

endPolylinePointIndex
类型number
路径中间隔的终点的索引(从零开始)。
speed
类型Speed
此时间间隔内的交通速度。
startPolylinePointIndex
类型number
路径中间隔起点的索引(从零开始)。