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。

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
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
指派給這輛配送車輛的行程區隔，從車輛最近回報的位置開始。只有在透過 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
前一個路線控點的路徑 (或路線控點清單中第一個路線點，也就是這個路線控點的第一點)。

Vehicle 介面

google.maps.journeySharing.Vehicle 介面

Fleet Engine 傳回的車輛詳細資料。
attributes
類型：  Object<string, *>
自訂車輛屬性。
name
類型：  string
格式為「providers/{provider_id}/vehicles/{vehicle_id}」。car_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
類型：  LatLngLiteral optional
路線控點的位置。
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
時間範圍的開始時間 (含)。