Fleet Engine Entities

Giao diện Tác vụ

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, *>
Thuộc tính được gán cho tác vụ.
name
Loại:  string
Tên việc cần làm theo định dạng "providers/{provider_id}/tasks/{task_id}". Task_id phải là một số nhận dạng duy nhất và không phải là ID theo dõi. Để lưu trữ ID theo dõi của lô hàng, hãy sử dụng trường tracking_id. Nhiều tác vụ có thể có cùng tracking_id.
remainingVehicleJourneySegments
Thông tin về những phân khúc 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 tác vụ.
type
Loại:  string
Loại nhiệm vụ; ví dụ: nghỉ giải lao hoặc giao hàng.
estimatedCompletionTime optional
Loại:  Date optional
Dấu thời gian cho biết thời gian hoàn thành ước tính của việc cần làm.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Thông tin cụ thể cho lần cập nhật vị trí gần đây nhất.
outcome optional
Loại:  string optional
Kết quả của việc cần làm.
outcomeLocation optional
Loại:  LatLngLiteral optional
Vị trí đã hoàn thành việc cần làm (từ nhà cung cấp).
outcomeLocationSource optional
Loại:  string optional
Phương thức setter của vị trí kết quả việc cần làm ('PROVIDER' hoặc 'LAST_VEHICLE_LOCATION').
outcomeTime optional
Loại:  Date optional
Dấu thời gian về thời điểm đặt kết quả của việc cần làm (từ nhà cung cấp).
plannedLocation optional
Loại:  LatLngLiteral optional
Vị trí cần hoàn thành việc cần làm.
targetTimeWindow optional
Loại:  TimeWindow optional
Khoảng thời gian hoàn thành việc cần làm.
trackingId optional
Loại:  string optional
Mã theo dõi của lô hàng.
vehicleId optional
Loại:  string optional
Mã xe thực hiện nhiệm vụ này.

Giao diện TaskInfo

Giao diện google.maps.journeySharing.TaskInfo

Loại thông tin tác vụ, do DeliveryVehicleStop sử dụng.
extraDurationMillis optional
Loại:  number optional
Thời gian cần thêm để thực hiện tác vụ, tính bằng mili giây.
id optional
Loại:  string optional
Mã của việc cần làm.
targetTimeWindow optional
Loại:  TimeWindow optional
Khoảng thời gian hoàn thành việc cần làm.

TaskTrackingInfo

Giao diện google.maps.journeySharing.TaskTrackingInfo

Thông tin chi tiết của một đối tượng thông tin theo dõi việc cần làm mà Fleet Engine trả về.
attributes
Loại:  Object<string, *>
Thuộc tính được gán cho tác vụ.
name
Loại:  string
Tên có đị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 hóa theo Biểu mẫu chuẩn hóa Unicode C.
  • Không được chứa bất kỳ ký tự ASCII nào sau đây: '/', ':', '?', ',' hoặc '#'.
estimatedArrivalTime optional
Loại:  Date optional
Thời gian đến dự kiến đến địa điểm dừng.
estimatedTaskCompletionTime optional
Loại:  Date optional
Thời gian hoàn thành ước tính của việc cần làm.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Thông tin cụ thể cho lần cập nhật vị trí gần đây nhất.
plannedLocation optional
Loại:  LatLng optional
Vị trí bạn sẽ hoàn thành việc cần làm.
remainingDrivingDistanceMeters optional
Loại:  number optional
Tổng khoảng cách còn lại tính bằng mét với VehicleStop mức độ quan tâm.
remainingStopCount optional
Loại:  number optional
Cho biết số lần dừng xe còn lại cho đến khi hoàn thành 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ụ, giá trị sẽ là 1.
routePolylinePoints optional
Loại:  Array<LatLng> optional
Danh sách những điểm mà khi kết nối sẽ tạo thành nhiều đường của tuyến đường dự kiến của xe đến vị trí của nhiệm vụ này.
state optional
Loại:  string optional
Trạng thái thực thi hiện tại của Tác vụ.
targetTimeWindow optional
Loại:  TimeWindow optional
Khoảng thời gian hoàn thành việc cần làm.
taskOutcome optional
Loại:  string optional
Kết quả của việc cố gắng thực thi một Nhiệm vụ.
taskOutcomeTime optional
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ề chuyến đi mà Fleet Engine trả lại.
name
Loại:  string
Ở định dạng "providers/{provider_id}/trips/{trip_id}". trip_id phải là mã nhận dạng duy nhất.
passengerCount
Loại:  number
Số hành khách trong chuyến đi này; không bao gồm người lái xe.
remainingWaypoints
Một mảng điểm tham chiếu cho biết đường dẫn từ vị trí hiện tại đến điểm trả.
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. Giá trị có thể là UNKNOWN_TRIP_TYPE, SHARED hoặc EXCLUSIVE.
vehicleId
Loại:  string
Mã xe thực hiện chuyến đi này.
actualDropOffLocation optional
Loại:  LatLngLiteral optional
Vị trí mà khách hàng đã bỏ ngang.
actualPickupLocation optional
Loại:  LatLngLiteral optional
Vị trí bạn đã tiếp khách hàng.
dropOffTime optional
Loại:  Date optional
Thời gian ước tính trong tương lai khi hành khách sẽ trả khách hoặc thời gian thực tế khi họ trả khách.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Thông tin cụ thể cho lần cập nhật vị trí gần đây nhất.
pickupTime optional
Loại:  Date optional
Thời gian ước tính trong tương lai khi hành khách sẽ đón hoặc thời gian thực tế khi đón.
plannedDropOffLocation optional
Loại:  LatLngLiteral optional
Vị trí mà khách hàng cho biết họ sẽ được trả hàng.
plannedPickupLocation optional
Loại:  LatLngLiteral optional
Địa điểm mà khách hàng cho biết họ sẽ đến lấy hàng.

Giao diện DeliveryXe

Giao diện google.maps.journeySharing.DeliveryVehicle

Chi tiết về phương tiện giao hàng do Fleet Engine trả lại.
attributes
Loại:  Object<string, string optional>
Thuộc tính xe giao hàng tùy chỉnh.
name
Loại:  string
Ở định dạng "providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}". delivery_vehicle_id phải là mã nhận dạng duy nhấ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
Những đoạn đường bạn đã chỉ định cho xe giao hàng này, bắt đầu từ vị trí đã báo cáo gần đây nhất của xe. Hệ thống chỉ điền dữ liệu này khi đối tượng dữ liệu DeliveryVehicle được cung cấp thông qua FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Loại:  LatLngLiteral optional
Vị trí kết thúc của tuyến đường hiện tại.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Vị trí cuối cùng được báo cáo của xe giao hàng.
remainingDurationMillis optional
Loại:  number optional
Thời gian lái xe còn lại trong đoạn tuyế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 phí giao xe
tasks
Loại:  Array<TaskInfo>
Danh sách Công việc sẽ thực hiện tại điểm dừng này.
  • id: mã của việc cần làm.
  • extraDurationMillis: thời gian cần thêm để thực hiện tác vụ, tính bằng mili giây.
plannedLocation optional
Loại:  LatLngLiteral optional
Vị trí của điểm dừng.
state optional
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

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

Truy cập bằng cách gọi const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). Xem Thư viện trong API JavaScript của Maps.
ARRIVED Đã đến điểm dừng. Giả sử khi xe đang định tuyến đến điểm dừng tiếp theo, tức là tất cả điểm dừng trước đó đã hoàn tất.
ENROUTE Đã chỉ định và đang định tuyến.
NEW Đã tạo nhưng chưa chủ động định tuyến.
UNSPECIFIED Không xác định.

Giao diện VehicleJourneySegment

Giao diện google.maps.journeySharing.VehicleJourneySegment

Loại đoạn đường trên xe
drivingDistanceMeters optional
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 optional
Loại:  number optional
Thời gian di chuyển từ điểm dừng trước đó (tính bằng mili giây)
path optional
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 đầu tiên trong danh sách các điểm dừng) đến điểm dừng này.
stop optional
Loại:  DeliveryVehicleStop optional
Thông tin về điểm dừng.

Giao diện VehicleLocationUpdate

Giao diện google.maps.journeySharing.VehicleLocationUpdate

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

Giao diện VehicleWaypoint

Giao diện google.maps.journeySharing.VehicleWaypoint

Loại điểm tham số phương tiện.
distanceMeters optional
Loại:  number optional
Khoảng cách đường 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 theo mét.
durationMillis optional
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 phương tiện, nếu điểm tham chiếu này là điểm đầu tiên trong danh sách điểm tham chiếu) tới điểm tham chiếu này tính bằng mili giây.
location optional
Loại:  LatLngLiteral optional
Vị trí của điểm tham chiếu.
path optional
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) tới điểm tham chiếu này.

Giao diện Xe

Giao diện google.maps.journeySharing.Vehicle

Chi tiết về phương tiện được Fleet Engine trả lại.
attributes
Loại:  Object<string, *>
Thuộc tính xe tùy chỉnh.
name
Loại:  string
Ở định dạng "providers/{provider_id}/vehicles/{vehicle_id}". Xe_id phải là mã nhận dạng duy nhấ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 xe.
vehicleType
Loại:  VehicleType
Loại xe này.
currentRouteSegmentEndPoint optional
Loại:  TripWaypoint optional
Điểm tham chiếu kết thúc đoạn tuyến đường hiện tại.
currentRouteSegmentVersion optional
Loại:  Date optional
Thời gian khi đoạn tuyến đường hiện tại được đặt.
currentTrips optional
Loại:  Array<string> optional
Danh sách ID chuyến đi của các chuyến đi hiện đã gán cho phương tiện này.
etaToFirstWaypoint optional
Loại:  Date optional
ETA đến mục nhập đầu tiên trong trường điểm tham chiếu.
latestLocation optional
Loại:  VehicleLocationUpdate optional
Vị trí xe được báo cáo gần đây nhất.
maximumCapacity optional
Loại:  number optional
Tổng số người lái mà xe này có thể chở. Trình điều khiển không được xem xét trong giá trị này.
supportedTripTypes optional
Loại:  Array<TripType> optional
Loại chuyến đi được hỗ trợ trên phương tiện này.
waypoints optional
Loại:  Array<TripWaypoint> optional
Các điểm tham chiếu còn lại được chỉ định cho Xe này.
waypointsVersion optional
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

Trạng thái điều hướng hiện tại của Vehicle.

Truy cập bằng cách gọi const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing"). Xem Thư viện trong API JavaScript của Maps.
ARRIVED_AT_DESTINATION Xe cách điểm đến khoảng 50m.
ENROUTE_TO_DESTINATION Điều hướng từng chặng khả dụng và điều hướng ứng dụng Trình điều khiển đã vào chế độ GUIDED_NAV.
NO_GUIDANCE Điều hướng của ứng dụng Trình điều khiển đang ở chế độ FREE_NAV.
OFF_ROUTE Xe đã đi sai tuyến đường đề 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

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

Truy cập bằng cách gọi const {VehicleState} = await google.maps.importLibrary("journeySharing"). Xem Thư viện trong API JavaScript của Maps.
OFFLINE Xe không chấp nhận chuyến đi mới.
ONLINE Xe đang chấp nhận 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

Loại Vehicle.

Truy cập bằng cách gọi const {VehicleType} = await google.maps.importLibrary("journeySharing"). Xem Thư viện trong API JavaScript của Maps.
AUTO Ô tô.
TAXI Bất kỳ phương tiện nào đóng vai trò là taxi (thường được cấp phép hoặc quản lý).
TRUCK Xe có dung lượng lưu trữ 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

Loại chuyến đi được Vehicle hỗ trợ.

Truy cập bằng cách gọi const {TripType} = await google.maps.importLibrary("journeySharing"). Xem Thư viện trong API JavaScript của Maps.
EXCLUSIVE Chuyến đi chỉ dành cho một phương tiện giao thông.
SHARED Chuyến đi có thể đi chung một 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 điểm tham chiếu.
distanceMeters optional
Loại:  number optional
Khoảng cách đường 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 theo mét.
durationMillis optional
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 phương tiện, nếu điểm tham chiếu này là điểm đầu tiên trong danh sách điểm tham chiếu) tới điểm tham chiếu này tính bằng mili giây.
location optional
Loại:  LatLngLiteral optional
Vị trí của điểm tham chiếu.
tripId optional
Loại:  string optional
Chuyến đi liên quan đến điểm tham chiếu này.
waypointType optional
Loại:  WaypointType optional
Vai trò của điểm tham chiếu này trong chuyến đi này, chẳng hạn như đến lấy hàng hoặc trả khách.

Hằng số WaypointType

hằng số google.maps.journeySharing.WaypointType

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

Truy cập bằng cách gọi const {WaypointType} = await google.maps.importLibrary("journeySharing"). Xem Thư viện trong API JavaScript của Maps.
DROP_OFF_WAYPOINT_TYPE Điểm tham chiếu dành cho người lái xe.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Điểm tham chiếu cho các điểm đến trung gian trong chuyến đi nhiều điểm đến.
PICKUP_WAYPOINT_TYPE Điểm tham chiếu để chọn người lái.
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 khung thời gian (bao gồm cả 2 giá trị đó).
startTime
Loại:  Date
Thời gian bắt đầu của khoảng thời gian (bao gồm).