Fleet Engine Entities

Giao diện Việc cần làm

google.maps.journeySharing.Taskgiao diện

Thông tin chi tiết về một việc cần làm do Fleet Engine trả về.
attributes
Loại:  Object<string, *>
Các thuộc tính được chỉ định cho việc cần làm.
name
Loại:  string
Tên nhiệm vụ ở định dạng "providers/{provider_id}/tasks/{task_id}". task_id phải là giá trị nhận dạng duy nhất và không phải là giá trị nhận dạng 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 tác vụ có thể có cùng 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 tác vụ.
type
Loại:  string
Loại nhiệm vụ; 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 việc cần làm.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Thông tin cụ thể về thông tin 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
Trình thiết lập vị trí kết quả của tác vụ ("PROVIDER" hoặc "LAST_VEHICLE_LOCATION").
outcomeTime optional
Loại:  Date optional
Dấu thời gian cho biết thời điểm kết quả của nhiệm vụ được đặt (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
Khung thời gian mà bạn cần 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ã nhận dạng của xe thực hiện nhiệm vụ này.

Giao diện TaskInfo

google.maps.journeySharing.TaskInfogiao diện

Loại TaskInfo, được dùng bởi DeliveryVehicleStop.
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ã nhận dạng của việc cần làm.
targetTimeWindow optional
Loại:  TimeWindow optional
Khung thời gian mà bạn cần hoàn thành việc cần làm.

Giao diện TaskTrackingInfo

google.maps.journeySharing.TaskTrackingInfogiao diện

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 việc cần làm.
name
Loại:  string
Tên theo định dạng "providers/{provider_id}/taskTrackingInfo/{tracking_id}", trong đó tracking_id là 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 Unicode Normalization Form 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í củ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 việc cần làm.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Thông tin cụ thể về thông tin cập nhật vị trí gần đây nhất.
plannedLocation optional
Loại:  LatLng optional
Vị trí hoàn thành việc cần làm.
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 đạt đế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 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 đường nhiều đoạ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
Khung thời gian mà bạn cần 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 gian mà nhà cung cấp đặt kết quả của Nhiệm vụ.

Giao diện Chuyến đi

google.maps.journeySharing.Tripgiao diện

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 người lái xe.
remainingWaypoints
Một mảng gồm 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ã nhận dạng của xe thực hiện chuyến đi này.
actualDropOffLocation optional
Loại:  LatLngLiteral optional
Vị trí nơi khách hàng được thả xuống.
actualPickupLocation optional
Loại:  LatLngLiteral optional
Vị trí đón 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ẽ được trả khách hoặc thời gian thực tế khi họ được trả khách.
latestVehicleLocationUpdate optional
Loại:  VehicleLocationUpdate optional
Thông tin cụ thể về thông tin 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 họ sẽ được thả xuố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

google.maps.journeySharing.DeliveryVehiclegiao diện

Thông tin chi tiết về xe 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
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 lái xe còn lại trong đoạn đường hiện tại, tính bằng mét.
remainingVehicleJourneySegments
Các đoạn đường đượ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. Tham số 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 optional
Loại:  LatLngLiteral optional
Vị trí kết thúc của đoạ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 đường hiện tại, tính bằng mili giây.

Giao diện DeliveryVehicleStop

google.maps.journeySharing.DeliveryVehicleStopgiao diện

Loại DeliveryVehicleStop
tasks
Loại:  Array<TaskInfo>
Danh sách các việc cần làm tại điểm dừng này.
  • id: mã nhận dạng của việc cần làm.
  • 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 Thư viện trong Maps JavaScript API.
ARRIVED Đã đến điểm dừng. Giả định rằng khi xe đang đi đến trạm dừng tiếp theo, tất cả các trạm dừng trước đó đã hoàn tất.
ENROUTE Đã được chỉ định và đang được đị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

google.maps.journeySharing.VehicleJourneySegmentgiao diện

Loại VehicleJourneySegment
drivingDistanceMeters optional
Loại:  number optional
Khoảng cách di chuyển từ trạ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 đế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 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

google.maps.journeySharing.VehicleLocationUpdategiao diện

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 km/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

google.maps.journeySharing.VehicleWaypointgiao diện

Loại VehicleWaypoint.
distanceMeters optional
Loại:  number optional
Khoảng cách theo đườ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 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 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 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 tham chiếu đầ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 đi 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 đoạn đường liên tục; 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 đường thông qua chỉ mục của chúng. Hãy xem định nghĩa về SpeedReadingInterval để biết thêm thông tin.

Giao diện Vehicle

google.maps.journeySharing.Vehiclegiao diện

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 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 của xe.
vehicleType
Loại:  VehicleType
Loại xe này.
currentRouteSegmentEndPoint optional
Loại:  TripWaypoint optional
Điểm đánh dấu nơi kết thúc đoạn đường hiện tại.
currentRouteSegmentVersion optional
Loại:  Date optional
Thời gian đặt đoạn đường hiện tại.
currentTrips optional
Loại:  Array<string> optional
Danh sách mã chuyến đi cho những 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 tham chiếu.
latestLocation optional
Loại:  VehicleLocationUpdate optional
Vị trí được báo cáo gần đây nhất của xe.
maximumCapacity optional
Loại:  number optional
Tổng số hành khách mà phương tiện này có thể chở. Giá trị này không bao gồm người lái xe.
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 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 đánh dấ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 Maps JavaScript API.
ARRIVED_AT_DESTINATION Xe đang ở trong phạm vi khoảng 50 m tính từ điểm đến.
ENROUTE_TO_DESTINATION Tính năng chỉ đường từng chặng hiện đã hoạt động và chế độ chỉ đường của ứng dụng Driver đã chuyển sang chế độ GUIDED_NAV.
NO_GUIDANCE Chế độ điều hướng của ứng dụng Driver là FREE_NAV.
OFF_ROUTE Xe đã đi sai 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 Thư viện trong Maps JavaScript API.
OFFLINE Xe không chấp 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 Thư viện trong Maps JavaScript API.
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ó 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 Không xác định được loại xe.

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 Maps JavaScript API.
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

google.maps.journeySharing.TripWaypointgiao diện

Loại TripWaypoint.
distanceMeters optional
Loại:  number optional
Khoảng cách theo đườ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 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 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 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 các đ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 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 đoạn đường liên tục; 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 đường thông qua chỉ mục của chúng. Hãy xem định nghĩa về SpeedReadingInterval để biết thêm thông tin.
tripId optional
Loại:  string optional
Chuyến đi được liên kết với điểm đánh dấu này.
waypointType optional
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

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 Maps JavaScript API.
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 dừng chân để đón hành khách.
UNKNOWN_WAYPOINT_TYPE Loại điểm đánh dấu không xác định.

Giao diện TimeWindow

google.maps.journeySharing.TimeWindowgiao diện

Một 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ả giá trị đầu và giá trị cuối).
startTime
Loại:  Date
Thời gian bắt đầu của khung thời gian (bao gồm cả giá trị đầu và giá trị cuối).

Hằng số tốc độ

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

Phân loại tốc độ của đường 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 Maps JavaScript API.
NORMAL Tốc độ bình thường, không phát hiện thấy tình trạng chậm tốc độ.
SLOW Phát hiện tình trạng giảm tốc độ, 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

google.maps.journeySharing.SpeedReadingIntervalgiao diện

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 chúng.
endPolylinePointIndex
Loại:  number
Chỉ mục dựa trên 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 độ 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.