Fleet Engine Entities

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Task 介面

google.maps.journeySharing.Task 介面

Fleet Engine 傳回的工作詳細資料。

name
類型:string
工作名稱的格式為「providers/{provider_id}/task/{task_id}」。工作 ID 必須是專屬識別碼,不能是追蹤 ID。如要儲存運送追蹤 ID,請使用 tracking_id 欄位。可以同時將多項工作使用相同的 track_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
完成工作的位置。
trackingId optional
類型:string optional
貨品的追蹤 ID。
vehicleId optional
類型:string optional
執行這項工作的車輛 ID。

TaskTrackingInfo 介面

google.maps.journeySharing.TaskTrackingInfo 介面

Fleet Engine 傳回的工作追蹤資訊物件的詳細資料。

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
工作目前的執行狀態。
taskOutcome optional
類型:string optional
嘗試執行工作的工作結果。
taskOutcomeTime optional
類型:Date optional
供應程式設定工作的時間。

行程介面

google.maps.journeySharing.Trip 介面

Fleet Engine 傳回的行程詳細資料。

name
類型:string
格式為「providers/{provider_id}/trips/{trip_id}」。trip_id 必須是專屬識別碼。
passengerCount
類型:number
這趟行程的乘客人數,不含司機。
remainingWaypoints
用來表示從目前位置到下車點的路徑的路徑點陣列。
status
類型:string
行程目前的狀態。可能的值包括 UNKNOWN_TRIP_STATUS、新的、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
指派給這個運送車輛的旅程區隔 (以車輛最近回報的地點為起點)。
currentRouteSegmentEndPoint optional
類型:LatLngLiteral optional
目前路徑區隔的終點。
latestVehicleLocationUpdate optional
類型:VehicleLocationUpdate optional
上次回報車輛交付地點。
remainingDurationMillis optional
類型:number optional
目前路徑片段的剩餘行車時間 (以毫秒為單位)。

DeliveryVehicleStop 介面

google.maps.journeySharing.DeliveryVehicleStop 介面

交付車輛停靠站類型

tasks
類型:Array<{
  id:string optional,
  extraDurationMillis:number optional
}>
這個停靠站要執行的工作清單。
  • id:工作 ID。
  • extraDurationMillis:執行工作所需的額外時間 (以毫秒為單位)。

DeliveryVehicleStopState 常數

google.maps.journeySharing.DeliveryVehicleStopState 常數

DeliveryVehicleStop 的目前狀態。

使用 &libraries=journeySharing 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

使用 v=beta 時,可透過呼叫 const {DeliveryVehicleStopState} = await google.map.importLibrary("journeySharing") 來存取請參閱 Maps JavaScript API 中的程式庫

ARRIVED 已抵達停靠站。假設車輛轉送到下一個停靠站時,所有先前的停靠站都已完成。
ENROUTE 已指派且主動轉送。
NEW 已建立,但目前並非主動轉送。
UNSPECIFIED 不明。

VehicleJourneySegment 介面

google.maps.journeySharing.VehicleJourneySegment 介面

交通工具旅程類型

drivingDistanceMeters optional
類型:number optional
從前一個停靠站到這個停靠站之間的移動距離,單位為公尺。
drivingDurationMillis optional
類型:number optional
從這個停靠站到這個停靠站的移動時間 (以毫秒為單位)。
path optional
類型:Array<LatLngLiteral> optional
從上一個路線控點 (或車輛目前位置,如果這個路徑點是路線控點清單中的第一個點) 至這個路線控點的路徑。
stop optional
類型:Array<DeliveryVehicleStop> optional
這輛車提供的停靠站。

VehicleLocationUpdate 介面

google.maps.journeySharing.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
從上一個路線控點 (或車輛目前位置,如果這個路徑點是路線控點清單中的第一個點) 至這個路線控點的路徑。