Fleet Engine Entities

Giao diện Task (Việc cần làm)

Giao diện google.maps.journeySharing.Task

Thông tin chi tiết về một tác vụ do Công cụ của đội xe trả về.
attributes
Loại:  Object<string, *>
Thuộc tính được gán cho tác vụ.
name
Loại:  string
Tên tác vụ theo đị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 mã theo dõi. Để lưu trữ mã vận đơn của một lô hàng, hãy sử dụng trường tracking_id. Nhiều tác vụ có thể có cùng một mã theo dõi.
remainingVehicleJourneySegments
Thông tin về các phân đoạn còn lại cần hoàn thành cho việc cần làm 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 công việc; ví dụ: thời gian nghỉ hoặc lô hàng.
estimatedCompletionTime optional
Loại:  Date optional
Dấu thời gian của thời gian hoàn thành ước tính của tác vụ.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Thông tin cụ thể về lần cập nhật vị trí gần đây nhất.
outcome optional
Loại:  string optional
Kết quả của tác vụ.
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ả công việc ("PROVIDER" hoặc "LAST_VEHICLE_LOCATION").
outcomeTime optional
Loại:  Date optional
Dấu thời gian của thời điểm đặt kết quả của tác vụ (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 cần hoàn thành tác vụ.
trackingId optional
Loại:  string optional
Mã vận đơn của lô hàng.
vehicleId optional
Loại:  string optional
Mã nhận dạng 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, do DeliveryVehicleStop sử dụng.
extraDurationMillis optional
Loại:  number optional
Thời gian bổ sung cần thiết để thực hiện tác vụ, tính bằng mili giây.
id optional
Loại:  string optional
Mã của tác vụ.
targetTimeWindow optional
Loại:  TimeWindow optional
Khoảng thời gian cần hoàn thành tác vụ.

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 công việc do Công cụ của đội xe trả về.
attributes
Loại:  Object<string, *>
Thuộc tính được gán cho tác vụ.
name
Loại:  string
Tên theo đị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ự.
  • Được 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 optional
Loại:  Date optional
Thời gian đến dự kiến tại vị trí dừng.
estimatedTaskCompletionTime optional
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 optional
Loại:  VehicleLocationUpdate optional
Thông tin cụ thể về lần cập nhật vị trí gần đây nhất.
plannedLocation optional
Loại:  LatLng optional
Vị trí mà Việc cần làm sẽ được hoàn thành.
remainingDrivingDistanceMeters optional
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 optional
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ông việc, thì giá trị sẽ là 1.
routePolylinePoints optional
Loại:  Array<LatLng> optional
Danh sách các điểm khi được kết nối sẽ tạo thành một đa tuyến 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 cần hoàn thành tác vụ.
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 nhà cung cấp đặt kết quả của Tác vụ.

Giao diện Chuyến đi

Giao diện google.maps.journeySharing.Trip

Thông tin chi tiết về một chuyến đi do Công cụ quản lý đội xe 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 duy nhất.
passengerCount
Loại:  number
Số lượng hành khách trên chuyến đi này; không bao gồm người lái xe.
remainingWaypoints
Một mảng các điểm trung gian cho biết đường dẫn 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ã nhận dạng của xe thực hiện chuyến đi này.
actualDropOffLocation optional
Loại:  LatLngLiteral optional
Vị trí mà khách hàng được thả xuống.
actualPickupLocation optional
Loại:  LatLngLiteral optional
Vị trí khách hàng được đón.
dropOffTime optional
Loại:  Date optional
Thời gian ước tính trong tương lai khi hành khách được thả xuống hoặc thời gian thực tế khi họ được thả xuống.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Thông tin cụ thể về 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 đượ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 là nơi họ sẽ được thả xuống.
plannedPickupLocation optional
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ề xe giao hàng do Công cụ quản lý đội xe trả về.
attributes
Loại:  Object<string, string optional>
Thuộc tính xe giao hàng tuỳ chỉnh.
name
Loại:  string
Theo định dạng "providers/{provider_id}/deliveryVehicles/{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 điều hướng hiện tại của xe.
remainingDistanceMeters
Loại:  number
Quãng đường còn lại để lái xe trong đoạn đường hiện tại, tính bằng mét.
remainingVehicleJourneySegments
Các đoạn hành trình được chỉ định cho xe tải giao hàng này, bắt đầu từ vị trí được báo cáo gần đây nhất của xe. Thuộc tính 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 đoạn tuyến đường hiện tại.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Vị trí gần đây nhất được báo cáo của xe giao hàng.
remainingDurationMillis optional
Loại:  number optional
Thời lượng 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 sẽ được thực hiện tại điểm dừng này.
  • id: mã nhận dạng của tác vụ.
  • extraDurationMillis: thời gian bổ sung cần thiết để 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 phần Thư viện trong API Maps JavaScript.
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 đó đều đã 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 optional
Loại:  number optional
Khoảng cách di chuyển từ trạm trước đến trạm 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 đến điểm dừng này, 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 VehicleLocationUpdate
heading optional
Loại:  number optional
Tiêu đề của nội dung cập nhật. 0 tương ứng với hướng bắc, 180 tương ứng với hướng 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 gian nhận được bản cập nhật này từ xe.

Giao diện VehicleWaypoint

Giao diện google.maps.journeySharing.VehicleWaypoint

Loại VehicleWaypoint.
distanceMeters optional
Loại:  number optional
Khoảng cách đường đi giữa điểm trung gian trước (hoặc vị trí hiện tại của xe, nếu điểm trung gian này là điểm đầu tiên trong danh sách điểm trung gian) đến điểm trung gian này tính bằng mét.
durationMillis optional
Loại:  number optional
Thời gian di chuyển giữa điểm trung gian trước (hoặc vị trí hiện tại của xe, nếu điểm trung gian này là điểm đầu tiên trong danh sách điểm trung gian) đến điểm trung gian này tính bằng mili giây.
location optional
Loại:  LatLngLiteral optional
Vị trí của điểm trung gian.
path optional
Loại:  Array<LatLngLiteral> optional
Đường dẫn từ điểm trung gian trước (hoặc vị trí hiện tại của xe, nếu điểm trung gian này là điểm đầu tiên trong danh sách điểm trung gian) đến điểm trung gian này.
speedReadingIntervals optional
Loại:  Array<SpeedReadingInterval> optional
Danh sách tốc độ giao thông dọc theo đường đi từ điểm trung gian trước (hoặc vị trí xe) đến điểm trung gian 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 đoạn liên tục 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 đoạn thông qua chỉ mục của các đoạn đó. Hãy xem định nghĩa của SpeedReadingInterval để biết thêm thông tin 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 Công cụ quản lý đội xe trả về.
attributes
Loại:  Object<string, *>
Thuộc tính xe tuỳ chỉnh.
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 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 còn lại để lái xe 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 này.
currentRouteSegmentEndPoint optional
Loại:  TripWaypoint optional
Điểm trung gian nơi đoạn tuyến hiện tại kết thúc.
currentRouteSegmentVersion optional
Loại:  Date optional
Thời gian đặt đoạn tuyến hiện tại.
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
Thời gian đến dự kiến cho mục đầu tiên trong trường điểm trung gian.
latestLocation optional
Loại:  VehicleLocationUpdate optional
Vị trí gần đây nhất được báo cáo của xe.
maximumCapacity optional
Loại:  number optional
Tổng số người đi xe mà phương tiện này có thể chở. Giá trị này không tính đến trình điều khiển.
supportedTripTypes optional
Loại:  Array<TripType> optional
Các loại chuyến đi mà xe này hỗ trợ.
waypoints optional
Loại:  Array<TripWaypoint> optional
Các điểm trung gian 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 trung gian đượ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 phần Thư viện trong API Maps JavaScript.
ARRIVED_AT_DESTINATION Xe cách điểm đến khoảng 50 m.
ENROUTE_TO_DESTINATION Có thông tin chỉ đường từng chặng và tính năng điều hướng trong ứng dụng Trình điều khiển đã chuyển sang chế độ GUIDED_NAV.
NO_GUIDANCE Tính năng điều hướng của ứng dụng Trình điều khiển ở chế độ FREE_NAV.
OFF_ROUTE Xe đã đi ra 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

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 phần Thư viện trong API Maps JavaScript.
OFFLINE Xe không nhận chuyến đi mới.
ONLINE Xe đang 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 phần Thư viện trong API Maps JavaScript.
AUTO Một chiếc ô tô.
TAXI Mọi loại xe hoạt động như xe 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 máy hoặc phương tiện 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 phần Thư viện trong API Maps JavaScript.
EXCLUSIVE Chuyến đi chỉ dành cho một xe.
SHARED Chuyến đi này 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 optional
Loại:  number optional
Khoảng cách đường đi giữa điểm trung gian trước (hoặc vị trí hiện tại của xe, nếu điểm trung gian này là điểm đầu tiên trong danh sách điểm trung gian) đến điểm trung gian này tính bằng mét.
durationMillis optional
Loại:  number optional
Thời gian di chuyển giữa điểm trung gian trước (hoặc vị trí hiện tại của xe, nếu điểm trung gian này là điểm đầu tiên trong danh sách điểm trung gian) đến điểm trung gian này tính bằng mili giây.
location optional
Loại:  LatLng optional
Vị trí của điểm trung gian.
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 đi từ điểm trung gian trước (hoặc vị trí xe) đến điểm trung gian 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 đoạn liên tục 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 đoạn thông qua chỉ mục của các đoạn đó. Hãy xem định nghĩa của SpeedReadingInterval để biết thêm thông tin chi tiết.
tripId optional
Loại:  string optional
Chuyến đi được liên kết với điểm trung gian này.
waypointType optional
Loại:  WaypointType optional
Vai trò của điểm trung gian này trong chuyến đi này, chẳng hạn như điểm đón hoặc điểm 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 phần Thư viện trong API Maps JavaScript.
DROP_OFF_WAYPOINT_TYPE Điểm trung gian để trả khách.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Điểm trung gian 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 trung gian để đón khách.
UNKNOWN_WAYPOINT_TYPE Loại điểm trung gian không xác định.

Giao diện TimeWindow

Giao diện google.maps.journeySharing.TimeWindow

Một 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ố Tốc độ

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

Phân loại tốc độ của đường đa tuyến dựa trên dữ liệu lưu lượng truy cập.

Truy cập bằng cách gọi const {Speed} = await google.maps.importLibrary("journeySharing"). Xem phần Thư viện trong API Maps JavaScript.
NORMAL Tốc độ bình thường, không phát hiện thấy hiện tượng chậm.
SLOW Phát hiện tình trạng chậm lại nhưng không có nút thắt cổ chai nào hình thành.
TRAFFIC_JAM Đã phát hiện ách tắc 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 tục. Khoảng thời gian xác định điểm bắt đầu và điểm kết thúc của đ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 0 của điểm cuối của khoảng thời gian trong đường dẫn.
speed
Loại:  Speed
Tốc độ giao thông trong khoảng thời gian này.
startPolylinePointIndex
Loại:  number
Chỉ mục dựa trên 0 của điểm bắt đầu của khoảng thời gian trong đường dẫn.