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 工作結果位置的 setter (「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。 |
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 Task 目前的執行狀態。 |
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 必須為專屬 ID。 |
navigationStatus |
類型:
string 車輛目前的導航狀態。 |
remainingDistanceMeters |
類型:
number 目前路線區隔中的剩餘行車距離 (以公尺為單位)。 |
remainingVehicleJourneySegments |
指派給這輛配送車輛的行程區隔,從車輛最近回報的位置開始。 |
currentRouteSegmentEndPoint optional |
類型:
LatLngLiteral optional 目前路徑區隔的結束位置。 |
latestVehicleLocationUpdate optional |
類型:
VehicleLocationUpdate optional 回報車輛的最近一次回報位置。 |
remainingDurationMillis optional |
類型:
number optional 目前路線區隔中的剩餘行車時間 (以毫秒為單位)。 |
DeliveryVehicleStop 介面
google.maps.journeySharing.DeliveryVehicleStop
介面
DeliveryVehicleStop 類型
屬性 | |
---|---|
tasks |
類型:
Array<{ 此停點要執行的工作清單。
|
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 前一個路線控點的路徑 (或路線控點清單中第一個路線點,也就是這個路線控點的第一點)。 |
TimeWindow 介面
google.maps.journeySharing.TimeWindow
介面
時間範圍。
屬性 | |
---|---|
endTime |
類型:
Date 時間範圍的結束時間 (含)。 |
startTime |
類型:
Date 時間範圍的開始時間 (含)。 |