Fleet Engine Entities

Giao diện Task

giao diện google.maps.journeySharing.Task

Thông tin chi tiết về một nhiệm vụ do Fleet Engine trả về.
attributes
Loại: Object<string, *>
Các thuộc tính được chỉ định cho nhiệm vụ.
name
Loại: string
Tên nhiệm vụ theo định dạng "providers/{provider_id}/tasks/{task_id}". task_id phải là giá trị nhận dạng riêng biệt chứ không phải mã theo dõi. Để lưu trữ mã theo dõi của lô hàng, hãy sử dụng trường tracking_id. Nhiều nhiệm vụ có thể có cùng một tracking_id.
remainingVehicleJourneySegments
Thông tin về các phân đoạn còn lại cần hoàn thành cho nhiệm vụ này.
status
Loại: string
Trạng thái thực thi hiện tại của việc cần làm.
type
Loại: string
Loại nhiệm vụ; ví dụ: nghỉ giải lao hoặc vận chuyển.
estimatedCompletionTime
không bắt buộc
Loại: Date optional
Dấu thời gian của thời gian hoàn thành ước tính của việc cần làm.
latestVehicleLocationUpdate
không bắt buộc
Loại: VehicleLocationUpdate optional
Thông tin cụ thể về thông báo cập nhật vị trí gần đây nhất.
outcome
không bắt buộc
Loại: string optional
Kết quả của nhiệm vụ.
outcomeLocation
không bắt buộc
Loại: LatLngLiteral optional
Vị trí hoàn thành nhiệm vụ (do nhà cung cấp cung cấp).
outcomeLocationSource
không bắt buộc
Loại: string optional
Trình thiết lập vị trí kết quả của nhiệm vụ ("PROVIDER" hoặc "LAST_VEHICLE_LOCATION").
outcomeTime
không bắt buộc
Loại: Date optional
Dấu thời gian khi kết quả của nhiệm vụ được đặt (từ nhà cung cấp).
plannedLocation
không bắt buộc
Loại: LatLngLiteral optional
Địa điểm cần hoàn thành việc cần làm.
targetTimeWindow
không bắt buộc
Loại: TimeWindow optional
Khoảng thời gian cần hoàn thành việc cần làm.
trackingId
không bắt buộc
Loại: string optional
Mã theo dõi của lô hàng.
vehicleId
không bắt buộc
Loại: string optional
Mã của xe thực hiện nhiệm vụ này.

Giao diện TaskInfo

giao diện google.maps.journeySharing.TaskInfo

Loại TaskInfo, được DeliveryVehicleStop sử dụng.
extraDurationMillis
không bắt buộc
Loại: number optional
Thời gian bổ sung cần thiết để thực hiện nhiệm vụ, tính bằng mili giây.
id
không bắt buộc
Loại: string optional
Mã của việc cần làm.
targetTimeWindow
không bắt buộc
Loại: TimeWindow optional
Khoảng thời gian cần hoàn thành việc cần làm.

Giao diện TaskTrackingInfo

giao diện google.maps.journeySharing.TaskTrackingInfo

Thông tin chi tiết về đối tượng thông tin theo dõi nhiệm vụ do Fleet Engine trả về.
attributes
Loại: Object<string, *>
Các thuộc tính được chỉ định cho nhiệm vụ.
name
Loại: string
Tên ở định dạng "providers/{provider_id}/taskTrackingInfo/{tracking_id}", trong đó tracking_id đại diện cho mã theo dõi.
trackingId
Loại: string
Mã theo dõi của một Việc cần làm.
  • Phải là một chuỗi Unicode hợp lệ.
  • Giới hạn độ dài tối đa là 64 ký tự.
  • Chuẩn hoá theo Dạng chuẩn hoá Unicode C.
  • Không được chứa bất kỳ ký tự ASCII nào sau đây: "/", ":", "?", "," hoặc "#".
estimatedArrivalTime
không bắt buộc
Loại: Date optional
Thời gian đến dự kiến tại điểm dừng.
estimatedTaskCompletionTime
không bắt buộc
Loại: Date optional
Thời gian hoàn thành ước tính của một việc cần làm.
latestVehicleLocationUpdate
không bắt buộc
Loại: VehicleLocationUpdate optional
Thông tin cụ thể về thông báo cập nhật vị trí gần đây nhất.
plannedLocation
không bắt buộc
Loại: LatLng optional
Địa điểm hoàn thành việc cần làm.
remainingDrivingDistanceMeters
không bắt buộc
Loại: number optional
Tổng quãng đường còn lại (tính bằng mét) đến VehicleStop mà bạn quan tâm.
remainingStopCount
không bắt buộc
Loại: number optional
Cho biết số điểm dừng còn lại của xe cho đến khi đến điểm dừng của nhiệm vụ, bao gồm cả điểm dừng của nhiệm vụ. Ví dụ: nếu điểm dừng tiếp theo của xe là điểm dừng của nhiệm vụ, thì giá trị sẽ là 1.
routePolylinePoints
không bắt buộc
Loại: Array<LatLng> optional
Danh sách các điểm mà khi kết nối sẽ tạo thành một hình nhiều đường của tuyến đường dự kiến mà xe sẽ đi đến vị trí của nhiệm vụ này.
state
không bắt buộc
Loại: string optional
Trạng thái thực thi hiện tại của Việc cần làm.
targetTimeWindow
không bắt buộc
Loại: TimeWindow optional
Khoảng thời gian cần hoàn thành việc cần làm.
taskOutcome
không bắt buộc
Loại: string optional
Kết quả của việc cố gắng thực thi một Nhiệm vụ.
taskOutcomeTime
không bắt buộc
Loại: Date optional
Thời điểm nhà cung cấp đặt kết quả của Nhiệm vụ.

Giao diện Trip

giao diện google.maps.journeySharing.Trip

Thông tin chi tiết về một chuyến đi do Fleet Engine trả về.
name
Loại: string
Theo định dạng "providers/{provider_id}/trips/{trip_id}". trip_id phải là giá trị nhận dạng riêng biệt.
passengerCount
Loại: number
Số lượng hành khách trong chuyến đi này; không bao gồm tài xế.
remainingWaypoints
Một mảng các điểm tham chiếu cho biết đường đi từ vị trí hiện tại đến điểm trả khách.
status
Loại: string
Trạng thái hiện tại của chuyến đi. Các giá trị có thể là UNKNOWN_TRIP_STATUS, NEW, ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ARRIVED_AT_INTERMEDIATE_DESTINATION, ENROUTE_TO_INTERMEDIATE_DESTINATION, ENROUTE_TO_DROPOFF, COMPLETE hoặc CANCELED.
type
Loại: string
Loại chuyến đi. Các giá trị có thể là UNKNOWN_TRIP_TYPE, SHARED hoặc EXCLUSIVE.
vehicleId
Loại: string
Mã của xe thực hiện chuyến đi này.
actualDropOffLocation
không bắt buộc
Loại: LatLngLiteral optional
Vị trí trả khách.
actualPickupLocation
không bắt buộc
Loại: LatLngLiteral optional
Vị trí đón khách hàng.
dropOffTime
không bắt buộc
Loại: Date optional
Thời gian dự kiến trong tương lai mà hành khách sẽ được trả khách hoặc thời gian thực tế mà hành khách được trả khách.
latestVehicleLocationUpdate
không bắt buộc
Loại: VehicleLocationUpdate optional
Thông tin cụ thể về thông báo cập nhật vị trí gần đây nhất.
pickupTime
không bắt buộc
Loại: Date optional
Thời gian dự kiến trong tương lai mà hành khách sẽ được đón hoặc thời gian thực tế mà hành khách được đón.
plannedDropOffLocation
không bắt buộc
Loại: LatLngLiteral optional
Vị trí mà khách hàng cho biết họ sẽ xuống xe.
plannedPickupLocation
không bắt buộc
Loại: LatLngLiteral optional
Vị trí mà khách hàng cho biết họ sẽ được đón.

Giao diện DeliveryVehicle

giao diện google.maps.journeySharing.DeliveryVehicle

Thông tin chi tiết về một phương tiện giao hàng do Fleet Engine trả về.
attributes
Loại: Object<string, string optional>
Thuộc tính tuỳ chỉnh của xe giao hàng.
name
Loại: string
Ở định dạng "providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}". delivery_vehicle_id phải là một giá trị nhận dạng riêng biệt.
navigationStatus
Loại: string
Trạng thái điều hướng hiện tại của xe.
remainingDistanceMeters
Loại: number
Quãng đường lái xe còn lại trong đoạn đường hiện tại, tính bằng mét.
remainingVehicleJourneySegments
Các chặng của hành trình được chỉ định cho xe giao hàng này, bắt đầu từ vị trí được báo cáo gần đây nhất của xe. Trường này chỉ được điền sẵn khi đối tượng dữ liệu DeliveryVehicle được cung cấp thông qua FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint
không bắt buộc
Loại: LatLngLiteral optional
Vị trí kết thúc đoạn đường hiện tại.
latestVehicleLocationUpdate
không bắt buộc
Loại: VehicleLocationUpdate optional
Vị trí được báo cáo gần đây nhất của xe giao hàng.
remainingDurationMillis
không bắt buộc
Loại: number optional
Thời gian lái xe còn lại trong đoạn đường hiện tại, tính bằng mili giây.

Giao diện DeliveryVehicleStop

giao diện google.maps.journeySharing.DeliveryVehicleStop

Loại DeliveryVehicleStop
tasks
Loại: Array<TaskInfo>
Danh sách việc cần làm tại điểm dừng này.
  • id: mã của việc cần làm.
  • extraDurationMillis: thời gian bổ sung cần thiết để thực hiện nhiệm vụ, tính bằng mili giây.
plannedLocation
không bắt buộc
Loại: LatLngLiteral optional
Vị trí của điểm dừng.
state
không bắt buộc
Loại: DeliveryVehicleStopState optional
Trạng thái của điểm dừng.

Hằng số DeliveryVehicleStopState

hằng số google.maps.journeySharing.DeliveryVehicleStopState
thư viện "journeySharing"

Trạng thái hiện tại của DeliveryVehicleStop.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại DeliveryVehicleStopStateString.

const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing");
ARRIVED Đã đến điểm dừng. Giả định rằng khi xe đang định tuyến đến điểm dừng tiếp theo, tất cả các điểm dừng trước đó đã hoàn tất.
ENROUTE Đã chỉ định và đang định tuyến.
NEW Đã tạo nhưng không chủ động định tuyến.
UNSPECIFIED Không xác định.

Giao diện VehicleJourneySegment

giao diện google.maps.journeySharing.VehicleJourneySegment

Loại VehicleJourneySegment
drivingDistanceMeters
không bắt buộc
Loại: number optional
Khoảng cách di chuyển từ điểm dừng trước đến điểm dừng này, tính bằng mét.
drivingDurationMillis
không bắt buộc
Loại: number optional
Thời gian di chuyển từ điểm dừng trước đến điểm dừng này, tính bằng mili giây.
path
không bắt buộc
Loại: Array<LatLngLiteral> optional
Đường đi từ điểm dừng trước đó (hoặc vị trí hiện tại của xe, nếu điểm dừng này là điểm dừng đầu tiên trong danh sách điểm dừng) đến điểm dừng này.
stop
không bắt buộc
Loại: DeliveryVehicleStop optional
Thông tin về điểm dừng.

Giao diện VehicleLocationUpdate

giao diện google.maps.journeySharing.VehicleLocationUpdate

Kiểu VehicleLocationUpdate
heading
không bắt buộc
Loại: number optional
Tiêu đề của bản cập nhật. 0 tương ứng với hướng bắc, 180 tương ứng với hướng nam.
location
không bắt buộc
Loại: LatLngLiteral|LatLng optional
Vị trí của bản cập nhật.
speedKilometersPerHour
không bắt buộc
Loại: number optional
Tốc độ tính bằng km/giờ.
time
không bắt buộc
Loại: Date optional
Thời gian nhận được thông tin cập nhật này từ xe.

Giao diện VehicleWaypoint

giao diện google.maps.journeySharing.VehicleWaypoint

Loại VehicleWaypoint.
distanceMeters
không bắt buộc
Loại: number optional
Khoảng cách đường đi giữa điểm tham chiếu trước đó (hoặc vị trí hiện tại của xe, nếu điểm tham chiếu này là điểm đầu tiên trong danh sách điểm tham chiếu) đến điểm tham chiếu này, tính bằng mét.
durationMillis
không bắt buộc
Loại: number optional
Thời gian di chuyển giữa điểm tham chiếu trước đó (hoặc vị trí hiện tại của xe, nếu điểm tham chiếu này là điểm đầu tiên trong danh sách điểm tham chiếu) đến điểm tham chiếu này, tính bằng mili giây.
location
không bắt buộc
Loại: LatLngLiteral optional
Vị trí của điểm tham chiếu.
path
không bắt buộc
Loại: Array<LatLngLiteral> optional
Đường đi từ điểm tham chiếu trước đó (hoặc vị trí hiện tại của xe, nếu điểm tham chiếu này là điểm đầu tiên trong danh sách điểm tham chiếu) đến điểm tham chiếu này.
speedReadingIntervals
không bắt buộc
Loại: Array<SpeedReadingInterval> optional
Danh sách tốc độ giao thông dọc theo tuyến đường từ điểm tham chiếu trước đó (hoặc vị trí của xe) đến điểm tham chiếu hiện tại. Mỗi khoảng thời gian trong danh sách mô tả lưu lượng truy cập trên một phân đoạn liền kề trên đường dẫn; khoảng thời gian xác định điểm bắt đầu và điểm kết thúc của phân đoạn thông qua các chỉ mục của chúng. Hãy xem định nghĩa về SpeedReadingInterval để biết thêm chi tiết.

Giao diện xe

giao diện google.maps.journeySharing.Vehicle

Thông tin chi tiết về một chiếc xe do Fleet Engine trả về.
attributes
Loại: Object<string, *>
Thuộc tính tuỳ chỉnh của xe.
name
Loại: string
Theo định dạng "providers/{provider_id}/vehicles/{vehicle_id}". vehicle_id phải là giá trị nhận dạng riêng biệt.
navigationStatus
Trạng thái điều hướng hiện tại của xe.
remainingDistanceMeters
Loại: number
Quãng đường lái xe còn lại trong đoạn đường hiện tại, tính bằng mét.
vehicleState
Loại: VehicleState
Trạng thái của xe.
vehicleType
Loại: VehicleType
Loại xe.
currentRouteSegmentEndPoint
không bắt buộc
Loại: TripWaypoint optional
Điểm tham chiếu nơi đoạn tuyến đường hiện tại kết thúc.
currentRouteSegmentVersion
không bắt buộc
Loại: Date optional
Thời điểm đặt đoạn đường hiện tại.
currentTrips
không bắt buộc
Loại: Array<string> optional
Danh sách mã chuyến đi cho các chuyến đi hiện được chỉ định cho xe này.
etaToFirstWaypoint
không bắt buộc
Loại: Date optional
Thời gian đến dự kiến của điểm đầu tiên trong trường điểm tham chiếu.
latestLocation
không bắt buộc
Loại: VehicleLocationUpdate optional
Vị trí được báo cáo gần đây nhất của xe.
maximumCapacity
không bắt buộc
Loại: number optional
Tổng số hành khách mà xe này có thể chở. Giá trị này không tính đến tài xế.
supportedTripTypes
không bắt buộc
Loại: Array<TripType> optional
Các loại chuyến đi mà xe này hỗ trợ.
waypoints
không bắt buộc
Loại: Array<TripWaypoint> optional
Các điểm tham chiếu còn lại được chỉ định cho Xe này.
waypointsVersion
không bắt buộc
Loại: Date optional
Lần gần đây nhất trường điểm tham chiếu được cập nhật.

Hằng số VehicleNavigationStatus

hằng số google.maps.journeySharing.VehicleNavigationStatus
thư viện "journeySharing"

Trạng thái chỉ đường hiện tại của Vehicle.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại VehicleNavigationStatusString.

const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing");
ARRIVED_AT_DESTINATION Xe cách điểm đến khoảng 50 m.
ENROUTE_TO_DESTINATION Tính năng đường đi từng chặng được cung cấp và tính năng đi theo chỉ dẫn của ứng dụng Tài xế đã chuyển sang chế độ GUIDED_NAV.
NO_GUIDANCE Tính năng chỉ đường của ứng dụng Tài xế đang ở chế độ FREE_NAV.
OFF_ROUTE Xe đã đi chệch khỏi tuyến đường được đề xuất.
UNKNOWN_NAVIGATION_STATUS Trạng thái điều hướng không xác định.

Hằng số VehicleState

hằng số google.maps.journeySharing.VehicleState
thư viện "journeySharing"

Trạng thái hiện tại của Vehicle.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại VehicleStateString.

const {VehicleState} = await google.maps.importLibrary("journeySharing");
OFFLINE Xe không chấp nhận chuyến đi mới.
ONLINE Xe đang chấp nhận các chuyến đi mới.
UNKNOWN_VEHICLE_STATE Trạng thái xe không xác định.

Hằng số VehicleType

hằng số google.maps.journeySharing.VehicleType
thư viện "journeySharing"

Loại Vehicle.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại VehicleTypeString.

const {VehicleType} = await google.maps.importLibrary("journeySharing");
AUTO Ô tô.
TAXI Mọi loại xe hoạt động như taxi (thường được cấp phép hoặc quản lý).
TRUCK Xe có khoang chứa đồ lớn.
TWO_WHEELER Xe mô tô, xe gắn máy hoặc xe hai bánh khác.
UNKNOWN Loại xe không xác định.

Hằng số TripType

hằng số google.maps.journeySharing.TripType
thư viện "journeySharing"

Các loại chuyến đi được Vehicle hỗ trợ.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại TripTypeString.

const {TripType} = await google.maps.importLibrary("journeySharing");
EXCLUSIVE Chuyến đi chỉ dành riêng cho một xe.
SHARED Chuyến đi có thể dùng chung xe với các chuyến đi khác.
UNKNOWN_TRIP_TYPE Loại chuyến đi không xác định.

Giao diện TripWaypoint

giao diện google.maps.journeySharing.TripWaypoint

Loại TripWaypoint.
distanceMeters
không bắt buộc
Loại: number optional
Khoảng cách đường đi giữa điểm tham chiếu trước đó (hoặc vị trí hiện tại của xe, nếu điểm tham chiếu này là điểm đầu tiên trong danh sách điểm tham chiếu) đến điểm tham chiếu này, tính bằng mét.
durationMillis
không bắt buộc
Loại: number optional
Thời gian di chuyển giữa điểm tham chiếu trước đó (hoặc vị trí hiện tại của xe, nếu điểm tham chiếu này là điểm đầu tiên trong danh sách điểm tham chiếu) đến điểm tham chiếu này, tính bằng mili giây.
location
không bắt buộc
Loại: LatLng optional
Vị trí của điểm tham chiếu.
path
không bắt buộc
Loại: Array<LatLng> optional
Đường đi từ điểm dừng trước đó (hoặc vị trí hiện tại của xe, nếu điểm dừng này là điểm dừng đầu tiên trong danh sách điểm dừng) đến điểm dừng này.
speedReadingIntervals
không bắt buộc
Loại: Array<SpeedReadingInterval> optional
Danh sách tốc độ giao thông dọc theo tuyến đường từ điểm tham chiếu trước đó (hoặc vị trí của xe) đến điểm tham chiếu hiện tại. Mỗi khoảng thời gian trong danh sách mô tả lưu lượng truy cập trên một phân đoạn liền kề trên đường dẫn; khoảng thời gian xác định điểm bắt đầu và điểm kết thúc của phân đoạn thông qua các chỉ mục của chúng. Hãy xem định nghĩa về SpeedReadingInterval để biết thêm chi tiết.
tripId
không bắt buộc
Loại: string optional
Chuyến đi liên kết với điểm tham chiếu này.
waypointType
không bắt buộc
Loại: WaypointType optional
Vai trò của điểm tham chiếu này trong chuyến đi, chẳng hạn như đón hoặc trả khách.

Hằng số WaypointType

hằng số google.maps.journeySharing.WaypointType
thư viện "journeySharing"

Các loại điểm tham chiếu được Vehicle hỗ trợ.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại WaypointTypeString.

const {WaypointType} = await google.maps.importLibrary("journeySharing");
DROP_OFF_WAYPOINT_TYPE Điểm tham chiếu để trả khách.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Điểm tham chiếu cho các điểm đến trung gian trong một chuyến đi có nhiều điểm đến.
PICKUP_WAYPOINT_TYPE Điểm tham chiếu để đón hành khách.
UNKNOWN_WAYPOINT_TYPE Loại điểm tham chiếu không xác định.

Giao diện TimeWindow

giao diện google.maps.journeySharing.TimeWindow

Phạm vi thời gian.
endTime
Loại: Date
Thời gian kết thúc của khoảng thời gian (bao gồm cả thời gian này).
startTime
Loại: Date
Thời gian bắt đầu của khoảng thời gian (bao gồm cả thời gian này).

Hằng số Speed

hằng số google.maps.journeySharing.Speed
thư viện "journeySharing"

Phân loại tốc độ của hình nhiều đường dựa trên dữ liệu giao thông.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại SpeedString.

const {Speed} = await google.maps.importLibrary("journeySharing");
NORMAL Tốc độ bình thường, không phát hiện thấy tình trạng ùn tắc nhẹ.
SLOW Phát hiện tình trạng ùn tắc nhẹ nhưng không xảy ra tắc nghẽn giao thông.
TRAFFIC_JAM Đã phát hiện tình trạng tắc nghẽn giao thông.

Giao diện SpeedReadingInterval

giao diện google.maps.journeySharing.SpeedReadingInterval

Chỉ báo mật độ giao thông trên một đoạn đường liền kề. Khoảng thời gian xác định điểm bắt đầu và điểm kết thúc của phân đoạn thông qua chỉ mục của các điểm đó.
endPolylinePointIndex
Loại: number
Chỉ mục dựa trên số 0 của điểm kết thúc của khoảng thời gian trong đường dẫn.
speed
Loại: Speed
Tốc độ lưu lượng truy cập trong khoảng thời gian này.
startPolylinePointIndex
Loại: number
Chỉ mục dựa trên số 0 của điểm bắt đầu của khoảng thời gian trong đường dẫn.