任务接口
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”）的设置器。 |
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
接口
供 DeliveryVehicleStop 使用的 TaskInfo 类型。
属性 | |
|---|---|
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。
|
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 |
一个点列表，这些点连接起来可形成车辆前往相应任务地点的预期路线的多段线。 |
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 |
在此停靠站要执行的任务列表。
|
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}”。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 |
相应车辆支持的行程类型。 |
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 |
精细导航可用，并且 Driver 应用导航已进入 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 |
从上一个经停点（如果此经停点是经停点列表中的第一个，则为车辆的当前位置）到此经停点的路径。 |
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路径中区间的起点的索引（从零开始）。 |