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
可选
类型: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
一个航点数组,用于指示从当前位置到下车点的路径。
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
分配给此配送车辆的行程路段,从车辆最近报告的位置开始。仅当通过 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
车辆的当前导航状态。
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
路径中区间起点的索引(从零开始)。