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	类型：Array<VehicleJourneySegment> 此任务中剩余待完成片段的相关信息。
status	类型：string 任务的当前执行状态。
type	类型：string 任务类型，例如休息或发货。
estimatedCompletionTime 可选	类型：Date optional 任务预计完成时间的时间戳。
latestVehicleLocationUpdate 可选	类型：VehicleLocationUpdate optional 与上次位置信息更新相关的信息。
outcome 可选	类型：string optional 任务的结果。
outcomeLocation 可选	类型：LatLngLiteral optional 任务完成地点（由提供商提供）。
outcomeLocationSource 可选	类型：string optional 任务结果位置的设置者（“PROVIDER”或“LAST_VEHICLE_LOCATION”）。
outcomeTime 可选	类型：Date optional 设置任务结果的时间戳（来自提供商）。
plannedLocation 可选	类型：LatLngLiteral optional 任务的完成地点。
targetTimeWindow 可选	类型：TimeWindow optional 任务应完成的时间窗口。
trackingId 可选	类型：string optional 运单的跟踪 ID。
vehicleId 可选	类型：string optional 执行此任务的车辆的 ID。

TaskInfo 接口

接口 google.maps.journeySharing.TaskInfo

TaskInfo 类型，由 DeliveryVehicleStop 使用。

属性
extraDurationMillis 可选	类型：number optional 执行任务所需的额外时间（以毫秒为单位）。
id 可选	类型：string optional 任务的 ID。
targetTimeWindow 可选	类型：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 可选	类型：Date optional 预计到达停靠地点的时间。
estimatedTaskCompletionTime 可选	类型：Date optional 任务的预计完成时间。
latestVehicleLocationUpdate 可选	类型：VehicleLocationUpdate optional 与上次位置信息更新相关的信息。
plannedLocation 可选	类型：LatLng optional 任务完成地点。
remainingDrivingDistanceMeters 可选	类型：number optional 到感兴趣的 VehicleStop 的总剩余距离（以米为单位）。
remainingStopCount 可选	类型：number optional 指示车辆在到达任务停靠点之前剩余的停靠点数量，包括任务停靠点。例如，如果车辆的下一站是任务停靠点，则该值为 1。
routePolylinePoints 可选	类型：Array<LatLng> optional 一系列点，这些点连接起来后会形成一条多段线，表示车辆前往此任务地点的预期路线。
state 可选	类型：string optional 任务的当前执行状态。
targetTimeWindow 可选	类型：TimeWindow optional 任务应完成的时间窗口。
taskOutcome 可选	类型：string optional 尝试执行任务的结果。
taskOutcomeTime 可选	类型：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 可选	类型：LatLngLiteral optional 客户下车的位置。
actualPickupLocation 可选	类型：LatLngLiteral optional 客户上车地点。
dropOffTime 可选	类型：Date optional 预计乘客下车的时间或实际下车的时间。
latestVehicleLocationUpdate 可选	类型：VehicleLocationUpdate optional 与上次位置信息更新相关的信息。
pickupTime 可选	类型：Date optional 预计未来接载乘客的时间，或实际接载乘客的时间。
plannedDropOffLocation 可选	类型：LatLngLiteral optional 客户指明的下车地点。
plannedPickupLocation 可选	类型：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 可选	类型：LatLngLiteral optional 当前路线段的终点位置。
latestVehicleLocationUpdate 可选	类型：VehicleLocationUpdate optional 上次报告的配送车辆位置。
remainingDurationMillis 可选	类型：number optional 当前路段的剩余行驶时长（以毫秒为单位）。

DeliveryVehicleStop 接口

接口 google.maps.journeySharing.DeliveryVehicleStop

DeliveryVehicleStop 类型

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

DeliveryVehicleStopState 常量

常量 google.maps.journeySharing.DeliveryVehicleStopState
库 "journeySharing"

DeliveryVehicleStop 的当前状态。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 DeliveryVehicleStopStateString 类型定义。

const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing");

常量
ARRIVED	已抵达经停点。假设车辆在规划前往下一站的路线时，之前的所有停靠点都已完成。
ENROUTE	已分配且正在路由。
NEW	已创建，但未主动路由。
UNSPECIFIED	未知。

VehicleJourneySegment 接口

接口 google.maps.journeySharing.VehicleJourneySegment

VehicleJourneySegment 类型

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

VehicleLocationUpdate 接口

接口 google.maps.journeySharing.VehicleLocationUpdate

VehicleLocationUpdate 类型

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

VehicleWaypoint 接口

接口 google.maps.journeySharing.VehicleWaypoint

VehicleWaypoint 类型。

属性
distanceMeters 可选	类型：number optional 从上一个航点（如果此航点是航点列表中的第一个航点，则为车辆的当前位置）到此航点的路径距离（以米为单位）。
durationMillis 可选	类型：number optional 从上一个航点（如果此航点是航点列表中的第一个航点，则为车辆的当前位置）到此航点的行程时间（以毫秒为单位）。
location 可选	类型：LatLngLiteral optional 航点的位置。
path 可选	类型：Array<LatLngLiteral> optional 从上一个航点（如果此航点是航点列表中的第一个航点，则为车辆的当前位置）到此航点的路径。
speedReadingIntervals 可选	类型：Array<SpeedReadingInterval> optional 从上一个航点（或车辆位置）到当前航点的路径上的车速列表。列表中的每个区间都描述了路径上连续路段的交通状况；区间通过其索引定义路段的起点和终点。如需了解详情，请参阅 SpeedReadingInterval 的定义。

车辆接口

接口 google.maps.journeySharing.Vehicle

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

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

VehicleNavigationStatus 常量

常量 google.maps.journeySharing.VehicleNavigationStatus
库 "journeySharing"

Vehicle 的当前导航状态。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 VehicleNavigationStatusString 类型定义。

const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing");

常量
ARRIVED_AT_DESTINATION	车辆距离目的地大约 50 米。
ENROUTE_TO_DESTINATION	精细导航功能可用，并且 Driver 应用导航已进入 GUIDED_NAV 模式。
NO_GUIDANCE	司机应用的导航处于 FREE_NAV 模式。
OFF_ROUTE	车辆已偏离建议路线。
UNKNOWN_NAVIGATION_STATUS	未指定导航状态。

VehicleState 常量

常量 google.maps.journeySharing.VehicleState
库 "journeySharing"

Vehicle 的当前状态。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 VehicleStateString 类型定义。

const {VehicleState} = await google.maps.importLibrary("journeySharing");

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

VehicleType 常量

常量 google.maps.journeySharing.VehicleType
库 "journeySharing"

Vehicle 的类型。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 VehicleTypeString 类型定义。

const {VehicleType} = await google.maps.importLibrary("journeySharing");

常量
AUTO	一辆汽车。
TAXI	任何用作出租车的车辆（通常已获得许可或受到监管）。
TRUCK	存储容量较大的车辆。
TWO_WHEELER	摩托车、轻便摩托车或其他两轮车辆。
UNKNOWN	未知车辆类型。

TripType 常量

常量 google.maps.journeySharing.TripType
库 "journeySharing"

Vehicle 支持的行程类型。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 TripTypeString 类型定义。

const {TripType} = await google.maps.importLibrary("journeySharing");

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

TripWaypoint 接口

接口 google.maps.journeySharing.TripWaypoint

TripWaypoint 类型。

属性
distanceMeters 可选	类型：number optional 从上一个航点（如果此航点是航点列表中的第一个航点，则为车辆的当前位置）到此航点的路径距离（以米为单位）。
durationMillis 可选	类型：number optional 从上一个航点（如果此航点是航点列表中的第一个航点，则为车辆的当前位置）到此航点的行程时间（以毫秒为单位）。
location 可选	类型：LatLng optional 航点的位置。
path 可选	类型：Array<LatLng> optional 从上一个经停点（如果此经停点是经停点列表中的第一个，则为车辆的当前位置）到此经停点的路线。
speedReadingIntervals 可选	类型：Array<SpeedReadingInterval> optional 从上一个航点（或车辆位置）到当前航点的路径上的车速列表。列表中的每个区间都描述了路径上连续路段的交通状况；区间通过其索引定义路段的起点和终点。如需了解详情，请参阅 SpeedReadingInterval 的定义。
tripId 可选	类型：string optional 与此航点关联的行程。
waypointType 可选	类型：WaypointType optional 此航点在行程中扮演的角色，例如上车点或下车点。

WaypointType 常量

常量 google.maps.journeySharing.WaypointType
库 "journeySharing"

Vehicle 支持的航点类型。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 WaypointTypeString 类型定义。

const {WaypointType} = await google.maps.importLibrary("journeySharing");

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

TimeWindow 接口

接口 google.maps.journeySharing.TimeWindow

时间范围。

属性
endTime	类型：Date 时间窗口的结束时间（含边界值）。
startTime	类型：Date 时间窗口的开始时间（含此时间）。

Speed 常量

常量 google.maps.journeySharing.Speed
库 "journeySharing"

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

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 SpeedString 类型定义。

const {Speed} = await google.maps.importLibrary("journeySharing");

常量
NORMAL	速度正常，未检测到减速。
SLOW	检测到缓行路段，但未形成交通拥堵。
TRAFFIC_JAM	检测到交通堵塞。

SpeedReadingInterval 接口

接口 google.maps.journeySharing.SpeedReadingInterval

连续路径段上的流量密度指标。该区间通过索引定义片段的起点和终点。

属性
endPolylinePointIndex	类型：number 路径中区间终点的索引（从零开始）。
speed	类型：Speed 此时间间隔内的车流速度。
startPolylinePointIndex	类型：number 路径中区间起点的索引（从零开始）。