Package maps.fleetengine.delivery.v1

Chỉ mục

DeliveryService

Dịch vụ Giao hàng chặng cuối.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

Tạo và trả về một loạt đối tượng Task mới.
CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

Tạo và trả về một DeliveryVehicle mới.
CreateTask

rpc CreateTask(CreateTaskRequest) returns (Task)

Tạo và trả về một đối tượng Task mới.
DeleteDeliveryVehicle

rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest) returns (Empty)

Xoá DeliveryVehicle khỏi Công cụ quản lý đội xe.

Trả về FAILED_PRECONDITION nếu DeliveryVehicle có các Tác vụ MỞ được chỉ định.
DeleteTask

rpc DeleteTask(DeleteTaskRequest) returns (Empty)

Xoá một Việc cần làm.

Trả về FAILED_PRECONDITION nếu Task (Tác vụ) ở trạng thái OPEN (MỞ) và được chỉ định cho một DeliveryVehicle.
GetDeliveryVehicle

rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle)

Trả về thực thể DeliveryVehicle đã chỉ định.
GetTask

rpc GetTask(GetTaskRequest) returns (Task)

Lấy thông tin về Task.
GetTaskTrackingInfo

rpc GetTaskTrackingInfo(GetTaskTrackingInfoRequest) returns (TaskTrackingInfo)

Trả về thực thể TaskTrackingInfo đã chỉ định.
ListDeliveryVehicles

rpc ListDeliveryVehicles(ListDeliveryVehiclesRequest) returns (ListDeliveryVehiclesResponse)

Lấy tất cả DeliveryVehicle đáp ứng tiêu chí lọc đã chỉ định.
ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

Lấy tất cả Task đáp ứng tiêu chí lọc đã chỉ định.
UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Ghi dữ liệu DeliveryVehicle đã cập nhật vào Công cụ của đội xe và chỉ định Tasks cho DeliveryVehicle. Bạn không thể cập nhật tên của DeliveryVehicle. Bạn có thể cập nhật remaining_vehicle_journey_segments, nhưng tệp này phải chứa tất cả VehicleJourneySegment để được duy trì trên DeliveryVehicle. Các task_id được truy xuất từ remaining_vehicle_journey_segments và Tasks tương ứng được gán cho DeliveryVehicle nếu chưa được gán.
UpdateTask

rpc UpdateTask(UpdateTaskRequest) returns (Task)

Cập nhật dữ liệu Task.

BatchCreateTasksRequest

Thông báo yêu cầu BatchCreateTask.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn. Lưu ý: Nếu bạn đặt trường này, thì trường tiêu đề trong thông báo CreateTaskRequest phải để trống hoặc phải khớp với trường này.
parent

string

Bắt buộc. Tài nguyên mẹ được tất cả tác vụ chia sẻ. Giá trị này phải ở định dạng providers/{provider}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project. Trường mẹ trong thông báo CreateTaskRequest phải trống hoặc phải khớp với trường này.
requests[]

CreateTaskRequest

Bắt buộc. Thông báo yêu cầu chỉ định các tài nguyên cần tạo. Lưu ý: Bạn có thể tạo tối đa 500 việc cần làm trong một lô.

BatchCreateTasksResponse

Thông báo phản hồi BatchCreateTask.

Trường
tasks[]

Task

Các Việc cần làm đã tạo.

CreateDeliveryVehicleRequest

Thông báo yêu cầu CreateDeliveryVehicle.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. Nhà cung cấp phải là Mã dự án Google Cloud. Ví dụ: sample-cloud-project.
delivery_vehicle_id

string

Bắt buộc. Mã xe giao hàng phải là duy nhất và tuân theo các quy định hạn chế sau:

  • 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 (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 '#'.
delivery_vehicle

DeliveryVehicle

Bắt buộc. Thực thể DeliveryVehicle cần tạo. Khi tạo một phương tiện phân phối mới, bạn có thể đặt các trường không bắt buộc sau:

  • loại
  • last_location
  • attributes

Lưu ý: Trường name của DeliveryVehicle sẽ bị bỏ qua. Bạn không được đặt tất cả các trường DeliveryVehicle khác; nếu không, hệ thống sẽ trả về lỗi.

CreateTaskRequest

Thông báo yêu cầu CreateTask.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project.
task_id

string

Bắt buộc. Mã công việc phải là mã duy nhất, nhưng không được là mã vận đơn. Để lưu trữ mã vận đơn, hãy sử dụng trường tracking_id. Xin lưu ý rằng nhiều tác vụ có thể có cùng một tracking_id. Mã công việc phải tuân theo các quy định hạn chế sau:

  • 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 (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 '#'.
task

Task

Bắt buộc. Thực thể Task (Việc cần làm) cần tạo. Khi tạo một Việc cần làm, bạn phải điền vào các trường sau:

  • type
  • state (phải được đặt thành OPEN)
  • tracking_id (không được đặt cho các tác vụ UNAVAILABLE hoặc SCHEDULED_STOP, nhưng bắt buộc đối với tất cả các loại tác vụ khác)
  • planned_location (không bắt buộc đối với các tác vụ UNAVAILABLE)
  • task_duration

Bạn có thể tuỳ ý đặt các trường sau:

  • target_time_window
  • task_tracking_view_config
  • attributes

Lưu ý: Trường name của Task (Tác vụ) sẽ bị bỏ qua. Bạn không được đặt tất cả các trường Việc cần làm khác; nếu không, hệ thống sẽ trả về lỗi.

DeleteDeliveryVehicleRequest

Tin nhắn yêu cầu DeleteDeliveryVehicle.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/deliveryVehicles/{delivery_vehicle}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project.

DeleteTaskRequest

Thông báo yêu cầu DeleteTask.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/tasks/{task}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project.

DeliveryRequestHeader

RequestHeader chứa các trường phổ biến cho tất cả yêu cầu RPC phân phối.

Trường
language_code

string

Mã ngôn ngữ BCP-47, chẳng hạn như en-US hoặc sr-Latn. Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Nếu không có tên nào được chỉ định, câu trả lời có thể bằng bất kỳ ngôn ngữ nào, ưu tiên tiếng Anh nếu có tên như vậy. Ví dụ về giá trị trường: en-US.
region_code

string

Bắt buộc. Mã vùng CLDR của khu vực phát sinh yêu cầu. Ví dụ về giá trị trường: US.
sdk_version

string

Phiên bản của SDK gọi, nếu có. Định dạng phiên bản là "major.minor.patch", ví dụ: 1.1.2.
os_version

string

Phiên bản hệ điều hành mà SDK gọi đang chạy. Ví dụ về giá trị trường: 4.4.1, 12.1.
device_model

string

Mẫu thiết bị mà SDK gọi đang chạy. Ví dụ về giá trị trường: iPhone12,1, SM-G920F.
sdk_type

SdkType

Loại SDK gửi yêu cầu.
maps_sdk_version

string

Phiên bản MapSDK mà SDK gọi phụ thuộc vào, nếu có. Định dạng phiên bản là "major.minor.patch", ví dụ: 5.2.1.
nav_sdk_version

string

Phiên bản NavSDK mà SDK gọi phụ thuộc vào (nếu có). Định dạng phiên bản là "major.minor.patch", ví dụ: 2.1.0.
platform

Platform

Nền tảng của SDK gọi.
manufacturer

string

Nhà sản xuất thiết bị Android từ SDK gọi, chỉ áp dụng cho SDK Android. Ví dụ về giá trị trường: Samsung.
android_api_level

int32

Cấp độ API Android của SDK gọi, chỉ áp dụng cho các SDK Android. Ví dụ về giá trị trường: 23.
trace_id

string

Mã nhận dạng không bắt buộc có thể được cung cấp cho mục đích ghi nhật ký để xác định yêu cầu.

Nền tảng

Nền tảng của SDK gọi.

Enum
PLATFORM_UNSPECIFIED Giá trị mặc định. Giá trị này được sử dụng nếu bạn bỏ qua nền tảng.
ANDROID Yêu cầu đến từ Android.
IOS Yêu cầu đến từ iOS.
WEB Yêu cầu đến từ web.

SdkType

Các loại SDK có thể có.

Enum
SDK_TYPE_UNSPECIFIED Giá trị mặc định. Giá trị này được sử dụng nếu bạn bỏ qua sdk_type.
CONSUMER SDK gọi là Consumer.
DRIVER SDK gọi là Trình điều khiển.
JAVASCRIPT SDK gọi là JavaScript.

DeliveryVehicle

Thông báo DeliveryVehicle. Xe tải giao hàng vận chuyển các lô hàng từ kho đến địa điểm giao hàng và từ địa điểm lấy hàng đến kho. Trong một số trường hợp, xe giao hàng cũng vận chuyển hàng hoá trực tiếp từ địa điểm lấy hàng đến địa điểm giao hàng.

Lưu ý: API gRPC và REST sử dụng các quy ước đặt tên trường khác nhau. Ví dụ: trường DeliveryVehicle.current_route_segment trong API gRPC và trường DeliveryVehicle.currentRouteSegment trong API REST tham chiếu đến cùng một trường.

Trường
name

string

Tên duy nhất của Xe phân phối này. Định dạng là providers/{provider}/deliveryVehicles/{vehicle}.
last_location

DeliveryVehicleLocation

Vị trí gần đây nhất được báo cáo của Xe giao hàng.
past_locations[]

DeliveryVehicleLocation

Chỉ nhập. Những địa điểm mà Xe giao hàng này đã từng đến nhưng chưa được báo cáo cho Công cụ quản lý đội xe. Phương thức này được dùng trong UpdateDeliveryVehicleRequest để ghi lại những vị trí trước đây không thể gửi đến máy chủ. Điều này thường xảy ra khi Xe phân phối không có kết nối Internet.
navigation_status

DeliveryVehicleNavigationStatus

Trạng thái chỉ đường của Xe giao hàng.
current_route_segment

bytes

Hình đa tuyến được mã hoá chỉ định tuyến đường mà tính năng chỉ đường đề xuất đi đến điểm trung gian tiếp theo. Ứng dụng trình điều khiển sẽ cập nhật thông tin này khi bạn đến hoặc đi qua một điểm dừng và khi chỉ đường định tuyến lại. Các LatLng này được trả về trong Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) hoặc Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) cho tất cả các Tác vụ đang hoạt động được chỉ định cho Xe.

Có một số trường hợp trường này có thể không được dùng để điền sẵn Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) hoặc Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

  • Điểm cuối của current_route_segment không khớp với DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) hoặc DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

  • Ứng dụng trình điều khiển chưa cập nhật vị trí gần đây, vì vậy, giá trị cập nhật gần đây nhất cho trường này có thể đã lỗi thời.

  • Ứng dụng trình điều khiển gần đây đã cập nhật vị trí của ứng dụng, nhưng current_route_segment đã lỗi thời và trỏ đến một điểm dừng xe trước đó.

Trong những trường hợp này, Công cụ quản lý đội xe sẽ điền sẵn vào trường này một tuyến đường từ VehicleStop đã đi qua gần đây nhất đến VehicleStop sắp tới để đảm bảo rằng người dùng của trường này có thông tin tốt nhất hiện có về đường dẫn hiện tại của Xe giao hàng.
current_route_segment_end_point

LatLng

Vị trí kết thúc current_route_segment. Ứng dụng trình điều khiển hiện không điền giá trị này, nhưng bạn có thể cung cấp giá trị này trên các lệnh gọi UpdateDeliveryVehicle. Đây là LatLng từ điểm dừng xe sắp tới hoặc LatLng cuối cùng của current_route_segment. Sau đó, Công cụ của Fleet sẽ cố gắng hết sức để nội suy thành VehicleStop thực tế.

Trường này sẽ bị bỏ qua trong các lệnh gọi UpdateDeliveryVehicle nếu trường current_route_segment trống.
remaining_distance_meters

Int32Value

Khoảng cách lái xe còn lại cho current_route_segment. Ứng dụng Trình điều khiển thường cung cấp trường này, nhưng có một số trường hợp mà Công cụ của đội xe sẽ ghi đè giá trị do ứng dụng gửi. Để biết thêm thông tin, hãy xem DeliveryVehicle.current_route_segment. Trường này được trả về trong Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) hoặc Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) cho tất cả Task đang hoạt động được chỉ định cho Xe phân phối.

Công cụ của Fleet sẽ bỏ qua trường này trong UpdateDeliveryVehicleRequest nếu trường current_route_segment trống.
remaining_duration

Duration

Thời gian lái xe còn lại cho current_route_segment. Ứng dụng Trình điều khiển thường cung cấp trường này, nhưng có một số trường hợp mà Công cụ của đội xe sẽ ghi đè giá trị do ứng dụng gửi. Để biết thêm thông tin, hãy xem DeliveryVehicle.current_route_segment. Trường này được trả về trong Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) hoặc Task.remainingVehicleJourneySegments[0].drivingDuration (REST) cho tất cả các tác vụ đang hoạt động được chỉ định cho Xe phân phối.

Công cụ của Fleet sẽ bỏ qua trường này trong UpdateDeliveryVehicleRequest nếu trường current_route_segment trống.
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Các đ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. Trường này sẽ không được điền trong phản hồi của ListDeliveryVehicles.
attributes[]

DeliveryVehicleAttribute

Danh sách các thuộc tính tuỳ chỉnh của Xe giao hàng. Một Xe phân phối có thể có tối đa 100 thuộc tính và mỗi thuộc tính phải có một khoá riêng biệt.
type

DeliveryVehicleType

Loại xe giao hàng này. Nếu bạn không đặt, giá trị mặc định sẽ là AUTO.

DeliveryVehicleType

Loại xe giao hàng.

Enum
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Giá trị này không được sử dụng.
AUTO Một chiếc ô tô.
TWO_WHEELER Xe mô tô, xe máy hoặc phương tiện hai bánh khác
BICYCLE Phương tiện vận tải do con người vận hành.
PEDESTRIAN Phương tiện vận chuyển con người, thường là đi bộ hoặc chạy dọc theo đường đi bộ.

DeliveryVehicleAttribute

Mô tả một thuộc tính của xe dưới dạng một cặp khoá-giá trị. Chiều dài chuỗi "khoá:giá trị" không được vượt quá 256 ký tự.

Trường
key

string

Khoá của thuộc tính.
value

string

Giá trị của thuộc tính.
Trường hợp hợp nhất delivery_vehicle_attribute_value. Giá trị của thuộc tính có thể ở dạng chuỗi, bool hoặc double. delivery_vehicle_attribute_value chỉ có thể là một trong những loại sau:
string_value

string

Giá trị thuộc tính được nhập dưới dạng chuỗi.

Lưu ý: Trường này giống với trường value mà cuối cùng sẽ không được dùng nữa. Đối với các phương thức tạo hoặc cập nhật, bạn có thể sử dụng một trong hai trường này, nhưng bạn nên sử dụng string_value. Nếu bạn đặt cả string_value và value, thì các giá trị này phải giống nhau, nếu không sẽ xảy ra lỗi. Cả hai trường đều được điền sẵn trong phản hồi.
bool_value

bool

Giá trị thuộc tính được nhập bằng boolean.
number_value

double

Giá trị thuộc tính được nhập hai lần.

DeliveryVehicleLocation

Vị trí, tốc độ và hướng của một xe tại một thời điểm.

Trường
location

LatLng

Vị trí của xe. Khi được gửi đến Công cụ quản lý đội xe, vị trí của xe là vị trí GPS. Khi bạn nhận được thông tin này trong một phản hồi, vị trí của xe có thể là vị trí GPS, vị trí bổ sung hoặc một số vị trí ước tính khác. Nguồn được chỉ định trong location_sensor.
horizontal_accuracy
(deprecated)

DoubleValue

Không dùng nữa: Hãy sử dụng latlng_accuracy.
latlng_accuracy

DoubleValue

Độ chính xác của location tính bằng mét dưới dạng bán kính.
heading

Int32Value

Hướng xe đang di chuyển tính bằng độ. 0 thể hiện hướng Bắc. Phạm vi hợp lệ là [0,360).
bearing_accuracy
(deprecated)

DoubleValue

Không dùng nữa: Hãy sử dụng heading_accuracy.
heading_accuracy

DoubleValue

Độ chính xác của heading theo độ.
altitude

DoubleValue

Độ cao tính bằng mét so với WGS84.
vertical_accuracy
(deprecated)

DoubleValue

Không dùng nữa: Hãy sử dụng altitude_accuracy.
altitude_accuracy

DoubleValue

Độ chính xác của altitude tính bằng mét.
speed_kmph
(deprecated)

Int32Value

Tốc độ của xe tính bằng km/giờ. Không dùng nữa: Hãy sử dụng speed.
speed

DoubleValue

Tốc độ của xe tính bằng mét/giây
speed_accuracy

DoubleValue

Độ chính xác của speed tính theo mét/giây.
update_time

Timestamp

Thời gian mà cảm biến báo cáo location theo đồng hồ của cảm biến.
server_time

Timestamp

Chỉ có đầu ra. Thời điểm máy chủ nhận được thông tin vị trí.
location_sensor

DeliveryVehicleLocationSensor

Nhà cung cấp dữ liệu vị trí (ví dụ: GPS).
is_road_snapped

BoolValue

Liệu location có được chụp nhanh vào một con đường hay không.
is_gps_sensor_enabled

BoolValue

Chỉ nhập. Cho biết liệu cảm biến GPS có được bật trên thiết bị di động hay không.
time_since_update

Int32Value

Chỉ nhập. Thời gian (tính bằng giây) kể từ lần đầu tiên vị trí này được gửi đến máy chủ. Giá trị này sẽ là 0 cho lần cập nhật đầu tiên. Nếu không xác định được thời gian (ví dụ: khi ứng dụng khởi động lại), giá trị này sẽ đặt lại về 0.
num_stale_updates
(deprecated)

Int32Value

Chỉ nhập. Ngừng sử dụng: Các tín hiệu khác hiện được dùng để xác định xem một vị trí có lỗi thời hay không.
raw_location

LatLng

Vị trí thô của xe (chưa được xử lý bằng công cụ chụp đường).
raw_location_time

Timestamp

Dấu thời gian liên kết với vị trí thô.
raw_location_sensor

DeliveryVehicleLocationSensor

Nguồn của vị trí thô. Giá trị mặc định là GPS.
raw_location_accuracy

DoubleValue

Độ chính xác của raw_location dưới dạng bán kính, tính bằng mét.
supplemental_location

LatLng

Vị trí bổ sung do ứng dụng tích hợp cung cấp.
supplemental_location_time

Timestamp

Dấu thời gian liên kết với vị trí bổ sung.
supplemental_location_sensor

DeliveryVehicleLocationSensor

Nguồn của vị trí bổ sung. Giá trị mặc định là CUSTOMER_SUPPLIED_LOCATION.
supplemental_location_accuracy

DoubleValue

Độ chính xác của supplemental_location dưới dạng bán kính, tính bằng mét.
road_snapped
(deprecated)

bool

Không dùng nữa: Hãy sử dụng is_road_snapped.

DeliveryVehicleLocationSensor

Cảm biến hoặc phương pháp dùng để xác định vị trí.

Enum
UNKNOWN_SENSOR Cảm biến không được chỉ định hoặc không xác định.
GPS GPS hoặc GPS được hỗ trợ.
NETWORK GPS hỗ trợ, mã trạm phát sóng hoặc điểm truy cập Wi-Fi.
PASSIVE Mã tháp phát sóng di động hoặc điểm truy cập Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Vị trí do thiết bị di động xác định là vị trí đường có nhiều khả năng nhất.
CUSTOMER_SUPPLIED_LOCATION Vị trí do khách hàng cung cấp từ một nguồn độc lập. Thông thường, giá trị này được dùng cho vị trí được cung cấp từ các nguồn khác ngoài thiết bị di động chạy SDK Trình điều khiển. Nếu nguồn ban đầu được mô tả bằng một trong các giá trị enum khác, hãy sử dụng giá trị đó. Các vị trí được đánh dấu là CUSTOMER_SUPPLIED_LOCATION thường được cung cấp thông qua last_location.supplemental_location_sensor của DeliveryVehicle.
FLEET_ENGINE_LOCATION Vị trí do Công cụ quản lý đội xe tính toán dựa trên các tín hiệu có sẵn. Chỉ có đầu ra. Giá trị này sẽ bị từ chối nếu được nhận trong một yêu cầu.
FUSED_LOCATION_PROVIDER Trình cung cấp vị trí kết hợp của Android.
CORE_LOCATION Trình cung cấp vị trí trên các hệ điều hành của Apple.

DeliveryVehicleNavigationStatus

Trạng thái điều hướng của xe.

Enum
UNKNOWN_NAVIGATION_STATUS Trạng thái điều hướng không xác định.
NO_GUIDANCE Thành phần điều hướng của ứng dụng Driver (Trình điều khiển) ở chế độ FREE_NAV.
ENROUTE_TO_DESTINATION Bạn có thể sử dụng tính năng chỉ đường từng chặng và tính năng chỉ đường trong ứng dụng Trình điều khiển đã chuyển sang chế độ GUIDED_NAV.
OFF_ROUTE Xe đã đi ra khỏi tuyến đường được đề xuất.
ARRIVED_AT_DESTINATION Xe cách điểm đến khoảng 50 m.

GetDeliveryVehicleRequest

Thông báo yêu cầu GetDeliveryVehicle.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/deliveryVehicles/{delivery_vehicle}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project.

GetTaskRequest

Thông báo yêu cầu GetTask.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/tasks/{task}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project.

GetTaskTrackingInfoRequest

Thông báo yêu cầu GetTaskTrackingInfoRequest.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
name

string

Bắt buộc. Phải ở định dạng providers/{provider}/taskTrackingInfo/{tracking_id}. provider phải là mã dự án trên Google Cloud và tracking_id phải là mã theo dõi được liên kết với tác vụ. Ví dụ: tên có thể là providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id.

ListDeliveryVehiclesRequest

Thông báo yêu cầu ListDeliveryVehicles.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project.
page_size

int32

Không bắt buộc. Số lượng xe tối đa cần trả về. Dịch vụ có thể trả về ít hơn số lượng này. Nếu bạn không chỉ định số lượng này, thì máy chủ sẽ xác định số lượng kết quả cần trả về.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListDeliveryVehicles trước đó. Bạn phải cung cấp giá trị này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListDeliveryVehicles phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
filter

string

Không bắt buộc. Truy vấn bộ lọc để áp dụng khi đăng xe giao hàng. Hãy xem http://aip.dev/160 để biết ví dụ về cú pháp bộ lọc. Nếu bạn không chỉ định giá trị hoặc nếu bạn chỉ định một chuỗi trống cho bộ lọc, thì tất cả các phương tiện phân phối sẽ được trả về.

Xin lưu ý rằng các truy vấn duy nhất được hỗ trợ cho ListDeliveryVehicles là trên các thuộc tính xe (ví dụ: attributes.<key> = <value> hoặc attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Ngoài ra, tất cả các thuộc tính đều được lưu trữ dưới dạng chuỗi, vì vậy, các phép so sánh duy nhất được hỗ trợ với các thuộc tính là so sánh chuỗi. Để so sánh với giá trị số hoặc boolean, các giá trị đó phải được đặt trong dấu ngoặc kép rõ ràng để được coi là chuỗi (ví dụ: attributes.<key> = "10" hoặc attributes.<key> = "true").

Số lượng quy tắc hạn chế tối đa được phép trong một truy vấn bộ lọc là 50. Hạn chế là một phần của truy vấn có dạng attribute.<KEY> <COMPARATOR> <VALUE>, ví dụ: attributes.foo = bar là 1 hạn chế.
viewport

Viewport

Không bắt buộc. Bộ lọc giới hạn các xe được trả về ở những vị trí đã biết gần đây nhất nằm trong khu vực hình chữ nhật do khung nhìn xác định.

ListDeliveryVehiclesResponse

Thông báo phản hồi ListDeliveryVehicles.

Trường
delivery_vehicles[]

DeliveryVehicle

Tập hợp các phương tiện phân phối đáp ứng tiêu chí lọc đã yêu cầu. Khi không chỉ định bộ lọc nào, yêu cầu sẽ trả về tất cả các phương tiện phân phối. Một phản hồi thành công cũng có thể trống. Nội dung phản hồi trống cho biết không tìm thấy xe giao hàng nào đáp ứng tiêu chí lọc đã yêu cầu.
next_page_token

string

Bạn có thể truyền mã thông báo này trong ListDeliveryVehiclesRequest để tiếp tục liệt kê kết quả. Khi tất cả kết quả được trả về, trường này sẽ không có trong phản hồi hoặc sẽ là một chuỗi trống.
total_size

int64

Tổng số phương tiện phân phối khớp với tiêu chí yêu cầu trên tất cả các trang.

ListTasksRequest

Thông báo yêu cầu ListTasks.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. provider phải là mã dự án trên Google Cloud. Ví dụ: sample-cloud-project.
page_size

int32

Không bắt buộc. Số lượng Tác vụ tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định giá trị này, thì máy chủ sẽ xác định số lượng kết quả cần trả về.
page_token

string

Không bắt buộc. Mã thông báo trang nhận được từ lệnh gọi ListTasks trước đó. Bạn có thể cung cấp giá trị này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListTasks phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
filter

string

Không bắt buộc. Truy vấn bộ lọc để áp dụng khi liệt kê Việc cần làm. Hãy xem http://aip.dev/160 để biết ví dụ về cú pháp bộ lọc. Nếu bạn không chỉ định giá trị hoặc nếu bạn lọc theo một chuỗi trống, thì tất cả các Việc cần làm sẽ được trả về. Để biết thông tin về các thuộc tính Việc cần làm mà bạn có thể lọc, hãy xem phần Liệt kê việc cần làm.

ListTasksResponse

Phản hồi ListTasks chứa tập hợp các Tác vụ đáp ứng tiêu chí lọc trong ListTasksRequest.

Trường
tasks[]

Task

Tập hợp các Tác vụ đáp ứng tiêu chí lọc đã yêu cầu. Khi không chỉ định bộ lọc nào, yêu cầu sẽ trả về tất cả các tác vụ. Một phản hồi thành công cũng có thể trống. Phản hồi trống cho biết không tìm thấy Công việc nào đáp ứng tiêu chí lọc được yêu cầu.
next_page_token

string

Truyền mã thông báo này trong ListTasksRequest để tiếp tục liệt kê kết quả. Nếu tất cả kết quả đã được trả về, thì trường này sẽ là một chuỗi trống hoặc không xuất hiện trong phản hồi.
total_size

int64

Tổng số Tác vụ khớp với tiêu chí yêu cầu trên tất cả các trang.

LocationInfo

Vị trí có bất kỳ giá trị nhận dạng bổ sung nào.

Trường
point

LatLng

Toạ độ của vị trí.

Việc cần làm

Một Tác vụ trong API Phân phối đại diện cho một hành động cần theo dõi. Nhìn chung, có sự khác biệt giữa Tác vụ liên quan đến lô hàng và Tác vụ nghỉ giải lao. Một lô hàng có thể liên kết với nhiều Việc cần làm. Ví dụ: có thể có một Tác vụ cho việc nhận hàng và một Tác vụ cho việc giao hàng hoặc chuyển hàng. Ngoài ra, các Nhiệm vụ khác nhau cho một lô hàng nhất định có thể được xử lý bằng các phương tiện khác nhau. Ví dụ: một xe có thể xử lý việc lấy hàng, vận chuyển lô hàng đến trung tâm, trong khi một xe khác vận chuyển cùng một lô hàng từ trung tâm đến địa điểm giao hàng.

Lưu ý: API gRPC và REST sử dụng các quy ước đặt tên trường khác nhau. Ví dụ: trường Task.journey_sharing_info trong API gRPC và trường Task.journeySharingInfo trong API REST tham chiếu đến cùng một trường.

Trường
name

string

Phải ở định dạng providers/{provider}/tasks/{task}.
type

Type

Bắt buộc. Không thể thay đổi. Xác định loại Tác vụ. Ví dụ: một lần nghỉ hoặc một lô hàng.
state

State

Bắt buộc. Trạng thái thực thi hiện tại của Tác vụ.
task_outcome

TaskOutcome

Kết quả của việc cần làm.
task_outcome_time

Timestamp

Dấu thời gian cho biết thời điểm nhà cung cấp đặt kết quả của Task.
task_outcome_location

LocationInfo

Vị trí đặt kết quả của Task. Giá trị này được cập nhật trong UpdateTask. Nếu nhà cung cấp không cập nhật rõ ràng giá trị này, thì theo mặc định, Công cụ quản lý đội xe sẽ điền giá trị này bằng vị trí xe xác định được gần đây nhất (vị trí thô).
task_outcome_location_source

TaskOutcomeLocationSource

Cho biết giá trị của task_outcome_location đến từ đâu.
tracking_id

string

Không thể thay đổi. Trường này hỗ trợ việc lưu trữ mã nhận dạng để bạn có thể tránh sử dụng mối liên kết phức tạp. Bạn không thể đặt tracking_id cho các Việc cần làm thuộc loại UNAVAILABLE và SCHEDULED_STOP. Những mã nhận dạng này phải tuân thủ các quy định hạn chế sau:

  • 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 (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 '#'.
delivery_vehicle_id

string

Chỉ có đầu ra. Mã của xe đang thực thi Tác vụ này. Mã xe giao hàng phải tuân thủ các quy định hạn chế sau:

  • 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 (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 '#'.
planned_location

LocationInfo

Không thể thay đổi. Vị trí mà Việc cần làm sẽ được hoàn thành. Không bắt buộc đối với Tác vụ UNAVAILABLE, nhưng bắt buộc đối với tất cả các Tác vụ khác.
task_duration

Duration

Bắt buộc. Không thể thay đổi. Thời gian cần thiết để thực thi một Tác vụ tại vị trí này.
target_time_window

TimeWindow

Khoảng thời gian cần hoàn thành tác vụ.
journey_sharing_info

JourneySharingInfo

Chỉ có đầu ra. Các trường dành riêng cho tính năng chia sẻ hành trình. Không được điền khi trạng thái là CLOSED.
task_tracking_view_config

TaskTrackingViewConfig

Cấu hình theo dõi tác vụ chỉ định những phần tử dữ liệu mà người dùng cuối có thể nhìn thấy trong những trường hợp nào.
attributes[]

TaskAttribute

Danh sách các thuộc tính Tuỳ chỉnh của Tác vụ. Mỗi thuộc tính phải có một khoá riêng biệt.

JourneySharingInfo

Các trường cụ thể khi chia sẻ hành trình.

Trường
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Thông tin theo dõi về các điểm dừng mà xe được chỉ định sẽ thực hiện trước khi hoàn tất Tác vụ này. Xin lưu ý rằng danh sách này có thể chứa các điểm dừng của các công việc khác.

Phân đoạn đầu tiên, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) hoặc Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), chứa thông tin tuyến đường từ vị trí đã biết gần đây nhất của người lái xe đến VehicleStop sắp tới. Thông tin tuyến đường hiện tại thường đến từ ứng dụng trình điều khiển, ngoại trừ một số trường hợp được ghi chú trong tài liệu về DeliveryVehicle.current_route_segment. Các phân khúc khác trong Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) hoặc Task.journeySharingInfo.remainingVehicleJourneySegments (REST) được điền sẵn bằng Công cụ của đội xe. Các tệp này cung cấp thông tin tuyến đường giữa các VehicleStops còn lại.
last_location

DeliveryVehicleLocation

Cho biết vị trí được báo cáo gần đây nhất của xe được chỉ định.
last_location_snappable

bool

Cho biết liệu có thể chụp nhanh lastLocation của xe vào current_route_segment hay không. Giá trị này là False nếu last_location hoặc current_route_segment không tồn tại. Giá trị này do Công cụ của đội xe tính toán. Nội dung cập nhật của ứng dụng sẽ bị bỏ qua.

Tiểu bang

Trạng thái của một Việc cần làm. Đây là chỉ báo tiến trình của Tasks.

Enum
STATE_UNSPECIFIED Mặc định. Dùng cho trạng thái Việc cần làm không xác định hoặc không được nhận dạng.
OPEN Việc cần làm chưa được chỉ định cho xe tải hoặc xe tải chưa đi qua điểm dừng xe được chỉ định của Task.
CLOSED Khi xe đi qua điểm dừng xe cho Tác vụ này.

TaskOutcome

Kết quả của việc cố gắng thực thi một Tác vụ. Khi TaskState đóng, TaskOutcome cho biết liệu quá trình này đã hoàn tất thành công hay chưa.

Enum
TASK_OUTCOME_UNSPECIFIED Kết quả của Tác vụ trước khi đặt giá trị.
SUCCEEDED Đã hoàn tất tác vụ.
FAILED Không thể hoàn tất hoặc đã huỷ Việc cần làm.

TaskOutcomeLocationSource

Giá trị nhận dạng của nguồn đã điền sẵn task_outcome_location.

Enum
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED Kết quả của việc cần làm trước khi được đặt.
PROVIDER Nhà cung cấp đã chỉ định task_outcome_location.
LAST_VEHICLE_LOCATION Nhà cung cấp không chỉ định task_outcome_location, vì vậy, Công cụ quản lý đội xe đã sử dụng vị trí xe gần đây nhất được biết.

Loại

Loại công việc.

Enum
TYPE_UNSPECIFIED Theo mặc định, Loại tác vụ là không xác định.
PICKUP Công việc lấy hàng là hành động được thực hiện để lấy hàng của khách hàng. Bạn nên sử dụng loại SCHEDULED_STOP cho các điểm lấy hàng tại kho hoặc xe trung chuyển.
DELIVERY Tác vụ giao hàng là hành động được thực hiện để giao một lô hàng cho khách hàng cuối. Điểm trả xe tại kho hoặc điểm trung chuyển phải sử dụng loại SCHEDULED_STOP.
SCHEDULED_STOP Tác vụ dừng theo lịch được dùng cho mục đích lập kế hoạch. Ví dụ: điểm này có thể thể hiện việc lấy hàng hoặc trả hàng từ các xe trung chuyển hoặc kho. Bạn không nên sử dụng phương thức này cho bất kỳ lô hàng nào được khách hàng cuối đến lấy hoặc giao đến.
UNAVAILABLE Một Tác vụ có nghĩa là Xe không thể được bảo dưỡng. Ví dụ: điều này có thể xảy ra khi người lái xe nghỉ ngơi hoặc khi xe đang được đổ xăng.

TaskAttribute

Mô tả thuộc tính công việc dưới dạng cặp khoá-giá trị. Chiều dài chuỗi "khoá:giá trị" không được vượt quá 256 ký tự.

Trường
key

string

Khoá của thuộc tính. Khoá không được chứa ký tự dấu hai chấm (:).
Trường hợp hợp nhất task_attribute_value. Giá trị của thuộc tính có thể ở dạng chuỗi, bool hoặc double. Nếu không đặt giá trị nào, string_value của TaskAttribute sẽ được lưu trữ dưới dạng chuỗi trống "". task_attribute_value chỉ có thể là một trong những giá trị sau:
string_value

string

Giá trị thuộc tính được nhập dưới dạng chuỗi.
bool_value

bool

Giá trị thuộc tính được nhập bằng boolean.
number_value

double

Giá trị thuộc tính được nhập hai lần.

TaskTrackingInfo

Thông báo TaskTrackingInfo. Thông báo này chứa thông tin theo dõi công việc sẽ được dùng để hiển thị. Nếu một mã theo dõi được liên kết với nhiều Tác vụ, thì Công cụ của đội xe sẽ sử dụng phương pháp phỏng đoán để quyết định chọn TaskTrackingInfo của Tác vụ nào.

Trường
name

string

Phải ở định dạng providers/{provider}/taskTrackingInfo/{tracking}, trong đó tracking đại diện cho mã theo dõi.
tracking_id

string

Không thể thay đổi. 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 "#".
vehicle_location

DeliveryVehicleLocation

Vị trí cuối cùng của xe.
route_polyline_points[]

LatLng

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.
remaining_stop_count

Int32Value

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 công việc, bao gồm cả điểm dừng của công việc. 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.
remaining_driving_distance_meters

Int32Value

Tổng quãng đường còn lại tính bằng mét đến VehicleStop mà bạn quan tâm.
estimated_arrival_time

Timestamp

Dấu thời gian cho biết thời gian đến dự kiến tại vị trí điểm dừng.
estimated_task_completion_time

Timestamp

Dấu thời gian cho biết thời gian hoàn thành ước tính của một Việc cần làm.
state

State

Trạng thái thực thi hiện tại của Tác vụ.
task_outcome

TaskOutcome

Kết quả của việc cố gắng thực thi một Tác vụ.
task_outcome_time

Timestamp

Dấu thời gian cho biết thời điểm nhà cung cấp đặt kết quả của Tác vụ.
planned_location

LocationInfo

Không thể thay đổi. Vị trí mà Việc cần làm sẽ được hoàn thành.
target_time_window

TimeWindow

Khoảng thời gian cần hoàn thành tác vụ.
attributes[]

TaskAttribute

Các thuộc tính tuỳ chỉnh được đặt trên việc cần làm.

TaskTrackingViewConfig

Thông báo cấu hình xác định thời điểm người dùng cuối nhìn thấy một phần tử dữ liệu của một Tác vụ.

Trường
route_polyline_points_visibility

VisibilityOption

Trường chỉ định thời điểm các điểm của đường đa tuyến của tuyến đường có thể hiển thị. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.
estimated_arrival_time_visibility

VisibilityOption

Trường chỉ định thời điểm có thể hiển thị thời gian đến dự kiến. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.
estimated_task_completion_time_visibility

VisibilityOption

Trường chỉ định thời điểm có thể hiển thị thời gian hoàn thành công việc ước tính. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.
remaining_driving_distance_visibility

VisibilityOption

Trường chỉ định thời điểm có thể hiển thị quãng đường lái xe còn lại. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.
remaining_stop_count_visibility

VisibilityOption

Trường chỉ định thời điểm có thể hiển thị số lượng điểm dừng còn lại. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.
vehicle_location_visibility

VisibilityOption

Trường chỉ định thời điểm có thể hiển thị vị trí của xe. Nếu bạn không chỉ định trường này, thì cấu hình chế độ hiển thị mặc định cấp dự án cho dữ liệu này sẽ được sử dụng.

VisibilityOption

Thông báo tuỳ chọn xác định thời điểm người dùng cuối nhìn thấy một phần tử dữ liệu.

Trường
Trường hợp hợp nhất visibility_option. Chế độ hiển thị cụ thể đã chọn. visibility_option chỉ có thể là một trong những loại sau:
remaining_stop_count_threshold

int32

Người dùng cuối có thể nhìn thấy phần tử dữ liệu này nếu số điểm dừng còn lại <= remaining_stop_count_threshold.
duration_until_estimated_arrival_time_threshold

Duration

Người dùng cuối sẽ nhìn thấy phần tử dữ liệu này nếu ETA đến điểm dừng <= duration_until_estimated_arrival_time_threshold.
remaining_driving_distance_meters_threshold

int32

Người dùng cuối có thể nhìn thấy phần tử dữ liệu này nếu quãng đường lái xe còn lại tính bằng mét <= remaining_driving_distance_meters_threshold.
always

bool

Nếu bạn đặt thành đúng, người dùng cuối sẽ luôn thấy phần tử dữ liệu này mà không có ngưỡng nào. Không thể đặt trường này thành false.
never

bool

Nếu bạn đặt thành đúng, thì phần tử dữ liệu này sẽ luôn bị ẩn khỏi người dùng cuối mà không có ngưỡng nào. Không thể đặt trường này thành false.

TimeWindow

Một phạm vi thời gian.

Trường
start_time

Timestamp

Bắt buộc. Thời gian bắt đầu của khoảng thời gian (bao gồm cả thời gian này).
end_time

Timestamp

Bắt buộc. Thời gian kết thúc của khoảng thời gian (bao gồm cả thời gian này).

UpdateDeliveryVehicleRequest

Thông báo yêu cầu UpdateDeliveryVehicle.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
delivery_vehicle

DeliveryVehicle

Bắt buộc. Nội dung cập nhật thực thể DeliveryVehicle cần áp dụng. Lưu ý: Bạn không thể cập nhật tên của DeliveryVehicle.
update_mask

FieldMask

Bắt buộc. Mặt nạ trường cho biết trường DeliveryVehicle nào cần cập nhật. Xin lưu ý rằng update_mask phải chứa ít nhất một trường.

Đây là danh sách tên đủ điều kiện của các trường được phân tách bằng dấu phẩy. Ví dụ: "remaining_vehicle_journey_segments"

UpdateTaskRequest

Thông báo yêu cầu UpdateTask.

Trường
header

DeliveryRequestHeader

Không bắt buộc. Tiêu đề yêu cầu API phân phối chuẩn.
task

Task

Bắt buộc. Việc cần làm liên kết với nội dung cập nhật. Các trường sau đây do Công cụ của đội xe duy trì. Không cập nhật các tệp này bằng Task.update.

  • last_location.
  • last_location_snappable.
  • name.
  • remaining_vehicle_journey_segments.
  • task_outcome_location_source.

Lưu ý: Bạn không thể thay đổi giá trị của task_outcome sau khi đặt giá trị đó.

Nếu Tác vụ đã được chỉ định cho một xe giao hàng, thì đừng đặt trạng thái Tác vụ thành ĐÃ ĐÓNG bằng Task.update. Thay vào đó, hãy xoá VehicleStop chứa Tác vụ khỏi xe phân phối. Thao tác này sẽ tự động đặt trạng thái Tác vụ thành ĐÃ KHOÁ.
update_mask

FieldMask

Bắt buộc. Mặt nạ trường cho biết những trường Task (Việc cần làm) cần cập nhật. Lưu ý: update_mask phải chứa ít nhất một trường.

Đây là danh sách tên đủ điều kiện của các trường được phân tách bằng dấu phẩy. Ví dụ: "task_outcome,task_outcome_time,task_outcome_location"

VehicleJourneySegment

Biểu thị một đoạn hành trình của Xe – từ điểm dừng trước đó đến điểm dừng hiện tại. Nếu đây là điểm dừng đang hoạt động đầu tiên, thì điểm dừng này sẽ là từ vị trí hiện tại của Xe đến điểm dừng này.

Trường
stop

VehicleStop

Chỉ định vị trí điểm dừng, cùng với các Task được liên kết với điểm dừng đó. Một số trường của VehicleStop có thể không xuất hiện nếu đoạn hành trình này là một phần của JourneySharingInfo.
driving_distance_meters

Int32Value

Chỉ có đầu ra. Khoảng cách di chuyển từ trạm trước đến trạm này. Nếu điểm dừng hiện tại là điểm dừng đầu tiên trong danh sách các đoạn hành trình, thì điểm xuất phát là vị trí của xe được ghi lại tại thời điểm điểm dừng này được thêm vào danh sách. Trường này có thể không xuất hiện nếu đoạn hành trình này là một phần của JourneySharingInfo.
driving_duration

Duration

Chỉ có đầu ra. Thời gian di chuyển từ trạm trước đến trạm này. Nếu điểm dừng hiện tại là điểm dừng đầu tiên trong danh sách các đoạn hành trình, thì điểm xuất phát là vị trí của Xe được ghi lại tại thời điểm điểm dừng này được thêm vào danh sách.

Nếu trường này được xác định trong đường dẫn Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) hoặc Task.remainingVehicleJourneySegments[0].drivingDuration (REST), thì trường này có thể được điền sẵn giá trị từ DeliveryVehicle.remaining_duration (gRPC) hoặc DeliveryVehicle.remainingDuration (REST). Thông tin này cung cấp thời gian lái xe còn lại từ vị trí đã biết mới nhất của ứng dụng hỗ trợ lái xe thay vì thời gian lái xe từ điểm dừng trước đó.
path[]

LatLng

Chỉ có đầu ra. Đường dẫn từ điểm dừng trước đến điểm dừng này. Nếu điểm dừng hiện tại là điểm dừng đầu tiên trong danh sách các đoạn hành trình, thì đây là đường đi từ vị trí hiện tại của xe đến điểm dừng này tại thời điểm điểm dừng được thêm vào danh sách. Trường này có thể không xuất hiện nếu đoạn hành trình này là một phần của JourneySharingInfo.

Nếu trường này được xác định trong đường dẫn Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) hoặc Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), thì trường này có thể được điền bằng LatLng được giải mã từ DeliveryVehicle.current_route_segment (gRPC) hoặc DeliveryVehicle.currentRouteSegment (REST). Thông tin này cung cấp lộ trình lái xe từ vị trí đã biết gần đây nhất của ứng dụng dành cho người lái xe thay vì lộ trình từ điểm dừng trước đó.

VehicleStop

Mô tả một điểm mà Xe dừng lại để thực hiện một hoặc nhiều Task.

Trường
planned_location

LocationInfo

Bắt buộc. Vị trí của điểm dừng. Xin lưu ý rằng các vị trí trong Task có thể không khớp chính xác với vị trí này, nhưng sẽ nằm trong phạm vi gần. Trường này sẽ không được điền trong phản hồi của lệnh gọi GetTask.
tasks[]

TaskInfo

Danh sách Task sẽ được thực hiện tại điểm dừng này. Trường này sẽ không được điền trong phản hồi của lệnh gọi GetTask.
state

State

Trạng thái của VehicleStop. Trường này sẽ không được điền trong phản hồi của lệnh gọi GetTask.

Tiểu bang

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

Enum
STATE_UNSPECIFIED Không xác định.
NEW Đã tạo nhưng không chủ động định tuyến.
ENROUTE Đã chỉ định và đang định tuyến.
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.

TaskInfo

Thông tin bổ sung về Nhiệm vụ được thực hiện tại điểm dừng này.

Trường
task_id

string

Mã việc cần làm. Trường này sẽ không được điền trong phản hồi của lệnh gọi GetTask. Mã công việc phải tuân theo các quy định hạn chế sau:

  • 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 (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 '#'.
task_duration

Duration

Chỉ có đầu ra. Thời gian cần thiết để thực hiện Tác vụ.
target_time_window

TimeWindow

Chỉ có đầu ra. Khoảng thời gian cần hoàn thành tác vụ. Giá trị này chỉ được đặt trong phản hồi cho GetDeliveryVehicle.