Fleet Engine Entities

Giao diện Task (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 giao cho tác vụ.
name
Loại:  string
Tên việc cần làm ở định dạng "providers/{provider_id}/tasks/{task_id}". Task_id phải là giá trị nhận dạng duy nhất chứ không phải là mã theo dõi. Để lưu trữ mã theo dõi của một lô hàng, hãy sử dụng trường theo dõi_id. Nhiều tác vụ có thể có cùng một track_id.
remainingVehicleJourneySegments
Thông tin về các phân đoạn còn lại cần được 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 tác vụ; ví dụ: nghỉ giải lao hoặc vận chuyển.
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 dành riêng 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 nhiệm vụ (từ nhà cung cấp).
outcomeLocationSource optional
Loại:  string optional
Phương thức setter của vị trí kết quả tác vụ ('provider' hoặc 'LAST_VEHICLE_LOCATION').
outcomeTime optional
Loại:  Date optional
Dấu thời gian khi kết quả của nhiệm vụ được đặt (từ trình cung cấp).
plannedLocation optional
Loại:  LatLngLiteral optional
Vị trí nơi việc cần làm được hoàn thành.
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ã 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 optional
Loại:  number optional
Thời gian thực hiện thêm tác vụ (tính bằng mili giây).
id optional
Loại:  string optional
Mã 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.

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, *>
Thuộc tính được giao cho tác vụ.
name
Loại:  string
Tên ở định dạng "providers/{provider_id}/taskTrackingInfo/{tracking_id}", trong đó tracking_id biểu thị 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ự.
  • Được chuẩn hoá theo Biểu mẫu chuẩn hoá 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 tới địa điểm dừng.
estimatedTaskCompletionTime optional
Loại:  Date optional
Thời gian hoàn thành ước tính của một Nhiệm vụ.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Thông tin dành riêng cho lần cập nhật vị trí gần đây nhất.
plannedLocation optional
Loại:  LatLng optional
Vị trí mà Nhiệm vụ sẽ được hoàn thành.
remainingDrivingDistanceMeters optional
Loại:  number optional
Tổng khoảng cách còn lại tính bằng mét đến VehicleStop địa điểm quan tâm.
remainingStopCount optional
Loại:  number optional
Cho biết số điểm dừng mà xe còn lại cho đến khi đạt đến điểm dừng làm việc, bao gồm cả điểm dừng thực hiện công việc đó. Ví dụ: nếu điểm dừng tiếp theo của chiếc xe là điểm dừng thực hiện nhiệm vụ, thì giá trị sẽ là 1.
routePolylinePoints optional
Loại:  Array<LatLng> optional
Danh sách các điểm khi được nối tạo thành một hình nhiều đường thể hiện tuyến đường dự kiến của xe đến vị trí của công việc 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 Tác vụ.
taskOutcomeTime optional
Loại:  Date optional
Thời điểm trình cung cấp đặt ra kết quả của Nhiệm vụ.

Giao diện Chuyến đi

Giao diện google.maps.journeySharing.Trip

Thông tin chi tiết về chuyến đi do Fleet Engine trả về.
name
Loại:  string
Ở định dạng "providers/{provider_id}/trips/{trip_id}". Trip_id phải là giá trị nhận dạng duy nhấ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 dẫn từ vị trí hiện tại đến điểm trả xe.
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, Cách di chuyển
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 chiếc xe trong 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í đón khách.
dropOffTime optional
Loại:  Date optional
Thời gian ước tính trong tương lai khi hành khách được trả khách hoặc thời gian thực tế khi họ được trả.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Thông tin dành riêng cho lần cập nhật vị trí gần đây nhất.
pickupTime optional
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ế khi họ được đón.
plannedDropOffLocation optional
Loại:  LatLngLiteral optional
Vị trí mà khách hàng cho biết rằng họ sẽ được trả hàng.
plannedPickupLocation optional
Loại:  LatLngLiteral optional
Vị trí mà khách hàng cho biết họ sẽ đến lấy hàng.

Giao diện DeliveryVehicle

Giao diện google.maps.journeySharing.DeliveryVehicle

Thông tin chi tiết về xe giao hàng do Fleet Engine trả lại.
attributes
Loại:  Object<string, string optional>
Thuộc tính xe giao hàng tuỳ chỉnh.
name
Loại:  string
Ở định dạng "providers/{provider_id}/deliveryXes/{delivery_vehicle_id}". Delivery_vehicle_id phải là giá trị nhận dạng duy nhất.
navigationStatus
Loại:  string
Trạng thái di chuyển hiện tại của xe.
remainingDistanceMeters
Loại:  number
Quãng đường lái xe còn lại trong đoạn tuyến đường hiện tại, tính bằng mét.
remainingVehicleJourneySegments
Đoạn 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. Thông tin này chỉ được điền 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 đoạn tuyến đường hiện tại.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Vị trí được báo cáo gần đây nhất 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 xe giao hàng
tasks
Loại:  Array<TaskInfo>
Danh sách Việc cần làm cần thực hiện tại điểm dừng này.
  • id: mã 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 Maps.
ARRIVED Đã đến nơi. Giả sử khi xe đang định tuyến đến điểm dừng tiếp theo, thì tất cả các điểm dừng trước đó đã hoàn tất.
ENROUTE Đã chỉ định và chủ động đị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 phân khúc Hành trình của xe
drivingDistanceMeters optional
Loại:  number optional
Khoảng cách di chuyển từ điểm dừng trước đó đến trạ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 dừng đầu tiên trong danh sách đ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 thông tin cập nhật về vị trí xe
heading optional
Loại:  number optional
Tiêu đề của nội dung cập nhật. 0 tương ứng với phía bắc, 180 tương ứng với 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 kilômét trên giờ.
time optional
Loại:  Date optional
Thời điểm 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 điểm điều khiển phương tiện.
distanceMeters optional
Loại:  number optional
Khoảng cách 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 optional
Loại:  number optional
Thời gian di chuyển 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 tham chiếu đầ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) đến điểm tham chiếu này.
speedReadingIntervals optional
Loại:  Array<SpeedReadingInterval> optional
Danh sách tốc độ giao thông dọc theo đường dẫn 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 trong danh sách mô tả lưu lượng truy cập trên một đoạn liền kề trên đường dẫn; khoảng thời gian này xác định điểm bắt đầu và điểm kết thúc của đoạn thông qua các chỉ mục của chúng. Hãy xem định nghĩa của 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 được Fleet Engine trả lại.
attributes
Loại:  Object<string, *>
Thuộc tính tuỳ chỉnh của xe.
name
Loại:  string
Ở định dạng "providers/{provider_id}/vehicles/{vehicle_id}". Xe_id phải là một giá trị nhận dạng duy nhất.
navigationStatus
Trạng thái di chuyển hiện tại của xe.
remainingDistanceMeters
Loại:  number
Quãng đường lái xe còn lại trong đoạn tuyế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 nơi đoạn tuyến đường hiện tại kết thúc.
currentRouteSegmentVersion optional
Loại:  Date optional
Thời điểm đoạn tuyến đường hiện tại được đặt.
currentTrips optional
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 optional
Loại:  Date optional
ETA cho mục nhập đầu tiên trong trường điểm tham chiếu.
latestLocation optional
Loại:  VehicleLocationUpdate optional
Vị trí được báo cáo gần đây nhất của chiếc xe.
maximumCapacity optional
Loại:  number optional
Tổng số người mà chiếc 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
Các loại chuyến đi được xe này hỗ trợ.
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 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 Maps.
ARRIVED_AT_DESTINATION Xe trong phạm vi khoảng 50 m từ điểm đến.
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 đã chuyển sang chế độ GUIDED_NAV.
NO_GUIDANCE Thao tác điều hướng của ứng dụng Trình điều khiển đang ở chế độ FREE_NAV.
OFF_ROUTE Xe đã đi chệch khỏi tuyến đường đề xuất.
UNKNOWN_NAVIGATION_STATUS Trạng thái điều hướng chưa được chỉ đị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 Maps.
OFFLINE Xe này không nhận các chuyến đi mới.
ONLINE Xe này đ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

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 Maps.
AUTO Ô tô.
TAXI Bất kỳ loại xe nào hoạt động như taxi (thường được cấp phép hoặc quản lý).
TRUCK Xe có dung tích chứa đồ lớn.
TWO_WHEELER Xe mô tô, xe đạp gắn máy hoặc xe mô tô 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

Các 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 Maps.
EXCLUSIVE Chuyến đi chỉ dành riêng cho một phương tiện di chuyển.
SHARED Chuyến đi có thể 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 optional
Loại:  number optional
Khoảng cách 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 optional
Loại:  number optional
Thời gian di chuyển 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 tham chiếu đầ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:  LatLng optional
Vị trí của điểm tham chiếu.
path optional
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 optional
Loại:  Array<SpeedReadingInterval> optional
Danh sách tốc độ giao thông dọc theo đường dẫn 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 trong danh sách mô tả lưu lượng truy cập trên một đoạn liền kề trên đường dẫn; khoảng thời gian này xác định điểm bắt đầu và điểm kết thúc của đoạn thông qua các chỉ mục của chúng. Hãy xem định nghĩa của SpeedReadingInterval để biết thêm chi tiết.
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 khách hoặc trả xe.

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 Maps.
DROP_OFF_WAYPOINT_TYPE Điểm tham chiếu cho người bỏ xe.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Điểm tham chiếu cho các điểm đến trung gian trong một chuyến đi nhiều điểm đến.
PICKUP_WAYPOINT_TYPE Điểm tham chiếu để đón 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 khung 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ố tốc độ

Hằng số google.maps.journeySharing.Speed

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

Truy cập bằng cách gọi const {Speed} = await google.maps.importLibrary("journeySharing"). Xem Thư viện trong API JavaScript Maps.
NORMAL Tốc độ bình thường, không phát hiện thấy va chạm.
SLOW Đã phát hiện thấy ùn tắc, nhưng không có kẹt xe nào hình thành.
TRAFFIC_JAM Đã phát hiện thấy kẹt xe.

Giao diện SpeedReadingInterval

Giao diện google.maps.journeySharing.SpeedReadingInterval

Chỉ báo mật độ lưu lượng truy cập trên một phân đoạn đường dẫn liền kề. Khoảng thời gian này xác định điểm bắt đầu và điểm kết thúc của đoạn thông qua các chỉ mục của chúng.
endPolylinePointIndex
Loại:  number
Chỉ mục bắt đầu từ 0 của điểm kết thúc của khoảng 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 bắt đầu từ 0 của điểm bắt đầu của khoảng thời gian trong đường dẫn.