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
工作結果位置的 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。
  • 必須是有效的萬國碼 (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
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<{
  id:string optional,
  extraDurationMillis:number optional
}>
此停點要執行的工作清單。
  • id：工作的 ID。
  • extraDurationMillis：執行工作所需的額外時間 (以毫秒為單位)。

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
時間範圍的開始時間 (含)。