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
任务的当前执行状态。
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
分配给此配送车辆的行程片段，从车辆最近报告的位置开始。仅当通过 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 的定义。

Vehicle 接口

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 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
路径中间隔起点的索引（从零开始）。