Package maps.fleetengine.delivery.v1

Indeks

DeliveryService

Layanan Pengiriman Kilometer Terakhir.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

Membuat dan menampilkan batch objek Task baru.
CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

Membuat dan menampilkan DeliveryVehicle baru.
CreateTask

rpc CreateTask(CreateTaskRequest) returns (Task)

Membuat dan menampilkan objek Task baru.
DeleteDeliveryVehicle

rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest) returns (Empty)

Menghapus DeliveryVehicle dari Fleet Engine.

Menampilkan FAILED_PRECONDITION jika DeliveryVehicle memiliki Tugas OPEN yang ditetapkan untuknya.
DeleteTask

rpc DeleteTask(DeleteTaskRequest) returns (Empty)

Menghapus satu Tugas.

Menampilkan FAILED_PRECONDITION jika Tugas berstatus OPEN dan ditetapkan ke DeliveryVehicle.
GetDeliveryVehicle

rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle)

Menampilkan instance DeliveryVehicle yang ditentukan.
GetTask

rpc GetTask(GetTaskRequest) returns (Task)

Mendapatkan informasi tentang Task.
GetTaskTrackingInfo

rpc GetTaskTrackingInfo(GetTaskTrackingInfoRequest) returns (TaskTrackingInfo)

Menampilkan instance TaskTrackingInfo yang ditentukan.
ListDeliveryVehicles

rpc ListDeliveryVehicles(ListDeliveryVehiclesRequest) returns (ListDeliveryVehiclesResponse)

Mendapatkan semua DeliveryVehicle yang memenuhi kriteria pemfilteran yang ditentukan.
ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

Mendapatkan semua Task yang memenuhi kriteria pemfilteran yang ditentukan.
UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Menulis data DeliveryVehicle yang diperbarui ke Fleet Engine, dan menetapkan Tasks ke DeliveryVehicle. Anda tidak dapat memperbarui nama DeliveryVehicle. Anda dapat memperbarui remaining_vehicle_journey_segments, tetapi harus berisi semua VehicleJourneySegment agar tetap ada di DeliveryVehicle. task_id diambil dari remaining_vehicle_journey_segments, dan Tasks yang sesuai ditetapkan ke DeliveryVehicle jika belum ditetapkan.
UpdateTask

rpc UpdateTask(UpdateTaskRequest) returns (Task)

Memperbarui data Task.

BatchCreateTasksRequest

Pesan permintaan BatchCreateTask.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar. Catatan: Jika Anda menetapkan kolom ini, kolom header dalam pesan CreateTaskRequest harus kosong, atau harus cocok dengan kolom ini.
parent

string

Wajib. Resource induk yang digunakan bersama oleh semua tugas. Nilai ini harus dalam format providers/{provider}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project. Kolom induk dalam pesan CreateTaskRequest harus kosong, atau harus cocok dengan kolom ini.
requests[]

CreateTaskRequest

Wajib. Pesan permintaan yang menentukan resource yang akan dibuat. Catatan: Anda dapat membuat maksimum 500 tugas dalam batch.

BatchCreateTasksResponse

Pesan respons BatchCreateTask.

Kolom
tasks[]

Task

Tugas yang dibuat.

CreateDeliveryVehicleRequest

Pesan permintaan CreateDeliveryVehicle.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
parent

string

Wajib. Harus dalam format providers/{provider}. Penyedia harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.
delivery_vehicle_id

string

Wajib. ID Kendaraan Pengiriman harus unik dan tunduk pada batasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalisasi sesuai dengan Unicode Normalization Form C.
  • Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
delivery_vehicle

DeliveryVehicle

Wajib. Entitas DeliveryVehicle yang akan dibuat. Saat membuat kendaraan pengiriman baru, Anda dapat menetapkan kolom opsional berikut:

  • jenis
  • last_location
  • attribut

Catatan: Kolom name DeliveryVehicle diabaikan. Semua kolom DeliveryVehicle lainnya tidak boleh ditetapkan; jika tidak, error akan ditampilkan.

CreateTaskRequest

Pesan permintaan CreateTask.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
parent

string

Wajib. Harus dalam format providers/{provider}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.
task_id

string

Wajib. ID Tugas harus unik, tetapi tidak boleh berupa ID pelacakan pengiriman. Untuk menyimpan ID pelacakan pengiriman, gunakan kolom tracking_id. Perhatikan bahwa beberapa tugas dapat memiliki tracking_id yang sama. ID tugas tunduk pada batasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalisasi sesuai dengan Unicode Normalization Form C.
  • Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
task

Task

Wajib. Entitas Tugas yang akan dibuat. Saat membuat Tugas, kolom berikut wajib diisi:

  • type
  • state (harus ditetapkan ke OPEN)
  • tracking_id (tidak boleh ditetapkan untuk tugas UNAVAILABLE atau SCHEDULED_STOP, tetapi wajib untuk semua jenis tugas lainnya)
  • planned_location (opsional untuk tugas UNAVAILABLE)
  • task_duration

Kolom berikut dapat ditetapkan secara opsional:

  • target_time_window
  • task_tracking_view_config
  • attributes

Catatan: Kolom name Tugas diabaikan. Semua kolom Tugas lainnya tidak boleh ditetapkan; jika tidak, error akan ditampilkan.

DeleteDeliveryVehicleRequest

Pesan permintaan DeleteDeliveryVehicle.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
name

string

Wajib. Harus dalam format providers/{provider}/deliveryVehicles/{delivery_vehicle}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.

DeleteTaskRequest

Pesan permintaan DeleteTask.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
name

string

Wajib. Harus dalam format providers/{provider}/tasks/{task}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.

DeliveryRequestHeader

RequestHeader berisi kolom yang umum untuk semua permintaan RPC Pengiriman.

Kolom
language_code

string

Kode bahasa BCP-47, seperti en-US atau sr-Latn. Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jika tidak ada yang ditentukan, respons dapat dalam bahasa apa pun, dengan preferensi untuk bahasa Inggris jika nama tersebut ada. Contoh nilai kolom: en-US.
region_code

string

Wajib. Kode wilayah CLDR wilayah tempat permintaan berasal. Contoh nilai kolom: US.
sdk_version

string

Versi SDK panggilan, jika ada. Format versi adalah "major.minor.patch", contoh: 1.1.2.
os_version

string

Versi sistem operasi tempat SDK panggilan berjalan. Contoh nilai kolom: 4.4.1, 12.1.
device_model

string

Model perangkat tempat SDK panggilan berjalan. Contoh nilai kolom: iPhone12,1, SM-G920F.
sdk_type

SdkType

Jenis SDK yang mengirim permintaan.
maps_sdk_version

string

Versi MapSDK yang menjadi dependensi SDK panggilan, jika ada. Format versi adalah "major.minor.patch", contoh: 5.2.1.
nav_sdk_version

string

Versi NavSDK yang menjadi dependensi SDK panggilan, jika ada. Format versi adalah "major.minor.patch", contoh: 2.1.0.
platform

Platform

Platform SDK yang memanggil.
manufacturer

string

Produsen perangkat Android dari SDK panggilan, hanya berlaku untuk Android SDK. Contoh nilai kolom: Samsung.
android_api_level

int32

Level API Android dari SDK yang memanggil, hanya berlaku untuk Android SDK. Contoh nilai kolom: 23.
trace_id

string

ID opsional yang dapat diberikan untuk tujuan logging guna mengidentifikasi permintaan.

Platform

Platform SDK yang memanggil.

Enum
PLATFORM_UNSPECIFIED Nilai default. Nilai ini digunakan jika platform tidak dicantumkan.
ANDROID Permintaan berasal dari Android.
IOS Permintaan berasal dari iOS.
WEB Permintaan berasal dari web.

SdkType

Kemungkinan jenis SDK.

Enum
SDK_TYPE_UNSPECIFIED Nilai default. Nilai ini digunakan jika sdk_type tidak ada.
CONSUMER SDK yang memanggil adalah Konsumen.
DRIVER SDK yang memanggil adalah Driver.
JAVASCRIPT SDK yang memanggil adalah JavaScript.

DeliveryVehicle

Pesan DeliveryVehicle. Kendaraan pengiriman mengangkut kiriman dari depot ke lokasi pengiriman, dan dari lokasi pengambilan ke depot. Dalam beberapa kasus, kendaraan pengiriman juga mengangkut kiriman langsung dari lokasi pengambilan ke lokasi pengiriman.

Catatan: gRPC dan REST API menggunakan konvensi penamaan kolom yang berbeda. Misalnya, kolom DeliveryVehicle.current_route_segment di gRPC API dan kolom DeliveryVehicle.currentRouteSegment di REST API merujuk ke kolom yang sama.

Kolom
name

string

Nama unik Kendaraan Pengiriman ini. Formatnya adalah providers/{provider}/deliveryVehicles/{vehicle}.
last_location

DeliveryVehicleLocation

Lokasi terakhir yang dilaporkan dari Kendaraan Pengiriman.
past_locations[]

DeliveryVehicleLocation

Hanya input. Lokasi yang pernah dikunjungi Kendaraan Pengiriman ini pada masa lalu yang belum dilaporkan ke Fleet Engine. ID ini digunakan di UpdateDeliveryVehicleRequest untuk mencatat lokasi yang sebelumnya tidak dapat dikirim ke server. Biasanya hal ini terjadi saat Kendaraan Pengiriman tidak memiliki konektivitas internet.
navigation_status

DeliveryVehicleNavigationStatus

Status navigasi Kendaraan Pengiriman.
current_route_segment

bytes

Polyline yang dienkode yang menentukan rute yang direkomendasikan navigasi untuk menuju ke titik jalan berikutnya. Aplikasi driver Anda memperbarui ini saat perhentian tercapai atau terlewati, dan saat navigasi dialihkan. LatLng ini ditampilkan di Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) atau Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) untuk semua Tugas aktif yang ditetapkan ke Kendaraan.

Ada beberapa kasus saat kolom ini mungkin tidak digunakan untuk mengisi Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) atau Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST):

  • Endpoint current_route_segment tidak cocok dengan DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) atau DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST).

  • Aplikasi pengemudi belum memperbarui lokasinya baru-baru ini, sehingga nilai yang terakhir diperbarui untuk kolom ini mungkin sudah tidak berlaku.

  • Aplikasi pengemudi baru saja memperbarui lokasinya, tetapi current_route_segment sudah tidak berlaku, dan mengarah ke perhentian kendaraan sebelumnya.

Dalam kasus ini, Fleet Engine mengisi kolom ini dengan rute dari VehicleStop yang terakhir dilewati ke VehicleStop berikutnya untuk memastikan bahwa konsumen kolom ini memiliki informasi terbaik yang tersedia tentang jalur Delivery Vehicle saat ini.
current_route_segment_end_point

LatLng

Lokasi tempat current_route_segment berakhir. Saat ini, kolom ini tidak diisi oleh aplikasi pengemudi, tetapi Anda dapat menyediakannya pada panggilan UpdateDeliveryVehicle. Nilai ini adalah LatLng dari perhentian kendaraan berikutnya, atau LatLng terakhir dari current_route_segment. Kemudian, Fleet Engine akan melakukan yang terbaik untuk menginterpolasi ke VehicleStop yang sebenarnya.

Kolom ini diabaikan dalam panggilan UpdateDeliveryVehicle jika kolom current_route_segment kosong.
remaining_distance_meters

Int32Value

Jarak mengemudi yang tersisa untuk current_route_segment. Aplikasi Driver biasanya menyediakan kolom ini, tetapi ada beberapa situasi saat Fleet Engine akan mengganti nilai yang dikirim oleh aplikasi. Untuk mengetahui informasi selengkapnya, lihat DeliveryVehicle.current_route_segment. Kolom ini ditampilkan di Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) atau Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) untuk semua Task aktif yang ditetapkan ke Kendaraan Pengiriman.

Fleet Engine mengabaikan kolom ini di UpdateDeliveryVehicleRequest jika kolom current_route_segment kosong.
remaining_duration

Duration

Sisa waktu mengemudi untuk current_route_segment. Aplikasi Driver biasanya menyediakan kolom ini, tetapi ada beberapa situasi saat Fleet Engine akan mengganti nilai yang dikirim oleh aplikasi. Untuk mengetahui informasi selengkapnya, lihat DeliveryVehicle.current_route_segment. Kolom ini ditampilkan di Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) atau Task.remainingVehicleJourneySegments[0].drivingDuration (REST) untuk semua tugas aktif yang ditetapkan ke Kendaraan Pengiriman.

Fleet Engine mengabaikan kolom ini di UpdateDeliveryVehicleRequest jika kolom current_route_segment kosong.
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Segmen perjalanan yang ditetapkan ke Kendaraan Pengiriman ini, dimulai dari lokasi terakhir yang dilaporkan Kendaraan. Kolom ini tidak akan diisi dalam respons ListDeliveryVehicles.
attributes[]

DeliveryVehicleAttribute

Daftar atribut Kendaraan Pengiriman kustom. Kendaraan Pengiriman dapat memiliki maksimal 100 atribut, dan setiap atribut harus memiliki kunci unik.
type

DeliveryVehicleType

Jenis kendaraan pengiriman ini. Jika tidak disetel, defaultnya adalah AUTO.

DeliveryVehicleType

Jenis kendaraan pengiriman.

Enum
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Nilai tidak digunakan.
AUTO Mobil.
TWO_WHEELER Sepeda motor, moped, atau kendaraan roda dua lainnya
BICYCLE Transportasi yang digerakkan manusia.
PEDESTRIAN Pengangkut manusia, biasanya berjalan atau berlari, bepergian di sepanjang jalur pejalan kaki.

DeliveryVehicleAttribute

Menjelaskan atribut kendaraan sebagai key-value pair. Panjang string "key:value" tidak boleh melebihi 256 karakter.

Kolom
key

string

Kunci atribut.
value

string

Nilai atribut.
Kolom union delivery_vehicle_attribute_value. Nilai atribut dapat berupa jenis string, bool, atau double. delivery_vehicle_attribute_value hanya dapat berupa salah satu dari berikut:
string_value

string

Nilai atribut berjenis string.

Catatan: Kolom ini sama dengan kolom value yang pada akhirnya akan tidak digunakan lagi. Untuk metode pembuatan atau pembaruan, kedua kolom dapat digunakan, tetapi sangat direkomendasikan untuk menggunakan string_value. Jika string_value dan value disetel, keduanya harus identik atau error akan ditampilkan. Kedua kolom diisi dalam respons.
bool_value

bool

Nilai atribut berjenis Boolean.
number_value

double

Nilai atribut yang diketik ganda.

DeliveryVehicleLocation

Lokasi, kecepatan, dan arah kendaraan pada suatu waktu.

Kolom
location

LatLng

Lokasi kendaraan. Saat dikirim ke Fleet Engine, lokasi kendaraan adalah lokasi GPS. Saat Anda menerimanya dalam respons, lokasi kendaraan dapat berupa lokasi GPS, lokasi tambahan, atau perkiraan lokasi lainnya. Sumber ditentukan dalam location_sensor.
horizontal_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Gunakan latlng_accuracy sebagai gantinya.
latlng_accuracy

DoubleValue

Akurasi location dalam meter sebagai radius.
heading

Int32Value

Arah pergerakan kendaraan dalam derajat. 0 mewakili Utara. Rentang yang valid adalah [0,360).
bearing_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Gunakan heading_accuracy sebagai gantinya.
heading_accuracy

DoubleValue

Akurasi heading dalam derajat.
altitude

DoubleValue

Ketinggian dalam meter di atas WGS84.
vertical_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Gunakan altitude_accuracy sebagai gantinya.
altitude_accuracy

DoubleValue

Akurasi altitude dalam meter.
speed_kmph
(deprecated)

Int32Value

Kecepatan kendaraan dalam kilometer per jam. Tidak digunakan lagi: Gunakan speed sebagai gantinya.
speed

DoubleValue

Kecepatan kendaraan dalam meter/detik
speed_accuracy

DoubleValue

Akurasi speed dalam meter/detik.
update_time

Timestamp

Waktu saat location dilaporkan oleh sensor menurut jam sensor.
server_time

Timestamp

Hanya output. Waktu saat server menerima informasi lokasi.
location_sensor

DeliveryVehicleLocationSensor

Penyedia data lokasi (misalnya, GPS).
is_road_snapped

BoolValue

Apakah location disesuaikan dengan jalan.
is_gps_sensor_enabled

BoolValue

Hanya input. Menunjukkan apakah sensor GPS diaktifkan di perangkat seluler.
time_since_update

Int32Value

Hanya input. Waktu (dalam detik) sejak lokasi ini pertama kali dikirim ke server. Nilai ini akan menjadi nol untuk update pertama. Jika waktu tidak diketahui (misalnya, saat aplikasi dimulai ulang), nilai ini akan direset ke nol.
num_stale_updates
(deprecated)

Int32Value

Hanya input. Tidak digunakan lagi: Sinyal lain kini digunakan untuk menentukan apakah lokasi sudah tidak valid.
raw_location

LatLng

Lokasi kendaraan mentah (tidak diproses oleh road-snapper).
raw_location_time

Timestamp

Stempel waktu yang terkait dengan lokasi mentah.
raw_location_sensor

DeliveryVehicleLocationSensor

Sumber lokasi mentah. Default-nya adalah GPS.
raw_location_accuracy

DoubleValue

Akurasi raw_location sebagai radius, dalam meter.
flp_location

LatLng

Lokasi dari Penyedia Lokasi Gabungan Android.
flp_update_time

Timestamp

Stempel waktu update flp_location
flp_latlng_accuracy_meters

DoubleValue

Akurasi flp_location dalam meter sebagai radius.
flp_heading_degrees

Int32Value

Arah pergerakan kendaraan dalam derajat, sebagaimana ditentukan oleh Fused Location Provider. 0 mewakili Utara. Rentang yang valid adalah [0,360).
supplemental_location

LatLng

Lokasi tambahan yang disediakan oleh aplikasi pengintegrasi.
supplemental_location_time

Timestamp

Stempel waktu yang terkait dengan lokasi tambahan.
supplemental_location_sensor

DeliveryVehicleLocationSensor

Sumber lokasi tambahan. Default-nya adalah CUSTOMER_SUPPLIED_LOCATION.
supplemental_location_accuracy

DoubleValue

Akurasi supplemental_location sebagai radius, dalam meter.
road_snapped
(deprecated)

bool

Tidak digunakan lagi: Gunakan is_road_snapped sebagai gantinya.

DeliveryVehicleLocationSensor

Sensor atau metodologi yang digunakan untuk menentukan lokasi.

Enum
UNKNOWN_SENSOR Sensor tidak ditentukan atau tidak diketahui.
GPS GPS atau GPS Berbantuan.
NETWORK GPS yang dibantu, ID menara seluler, atau titik akses Wi-Fi.
PASSIVE ID menara BTS atau titik akses Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Lokasi yang ditentukan oleh perangkat seluler sebagai posisi jalan yang paling mungkin.
CUSTOMER_SUPPLIED_LOCATION Lokasi yang disediakan pelanggan dari sumber independen. Biasanya, nilai ini digunakan untuk lokasi yang disediakan dari sumber selain perangkat seluler yang menjalankan Driver SDK. Jika sumber asli dijelaskan oleh salah satu nilai enum lainnya, gunakan nilai tersebut. Lokasi yang ditandai dengan CUSTOMER_SUPPLIED_LOCATION biasanya disediakan melalui last_location.supplemental_location_sensor DeliveryVehicle.
FLEET_ENGINE_LOCATION Lokasi yang dihitung oleh Fleet Engine berdasarkan sinyal yang tersedia untuknya. Hanya output. Nilai ini akan ditolak jika diterima dalam permintaan.
FUSED_LOCATION_PROVIDER Fused Location Provider Android.
CORE_LOCATION Penyedia lokasi di sistem operasi Apple.

DeliveryVehicleNavigationStatus

Status navigasi kendaraan.

Enum
UNKNOWN_NAVIGATION_STATUS Status navigasi tidak ditentukan.
NO_GUIDANCE Navigasi aplikasi Driver berada dalam mode FREE_NAV.
ENROUTE_TO_DESTINATION Navigasi belokan demi belokan tersedia dan navigasi aplikasi Driver telah memasuki mode GUIDED_NAV.
OFF_ROUTE Kendaraan telah keluar dari rute yang disarankan.
ARRIVED_AT_DESTINATION Kendaraan berada dalam jarak sekitar 50 m dari tujuan.

GetDeliveryVehicleRequest

Pesan permintaan GetDeliveryVehicle.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
name

string

Wajib. Harus dalam format providers/{provider}/deliveryVehicles/{delivery_vehicle}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.

GetTaskRequest

Pesan permintaan GetTask.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
name

string

Wajib. Harus dalam format providers/{provider}/tasks/{task}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.

GetTaskTrackingInfoRequest

Pesan permintaan GetTaskTrackingInfoRequest.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
name

string

Wajib. Harus dalam format providers/{provider}/taskTrackingInfo/{tracking_id}. provider harus berupa ID Project Google Cloud, dan tracking_id harus berupa ID pelacakan yang terkait dengan tugas. Contoh nama dapat berupa providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id.

ListDeliveryVehiclesRequest

Pesan permintaan ListDeliveryVehicles.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
parent

string

Wajib. Harus dalam format providers/{provider}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.
page_size

int32

Opsional. Jumlah maksimum kendaraan yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari jumlah ini. Jika Anda tidak menentukan jumlah ini, server akan menentukan jumlah hasil yang akan ditampilkan.
page_token

string

Opsional. Token halaman, diterima dari panggilan ListDeliveryVehicles sebelumnya. Anda harus memberikannya untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListDeliveryVehicles harus sesuai dengan panggilan yang menyediakan token halaman.
filter

string

Opsional. Kueri filter yang akan diterapkan saat mencantumkan kendaraan pengiriman. Lihat http://aip.dev/160 untuk contoh sintaksis filter. Jika Anda tidak menentukan nilai, atau jika Anda menentukan string kosong untuk filter, semua kendaraan pengiriman akan ditampilkan.

Perhatikan bahwa hanya kueri yang didukung untuk ListDeliveryVehicles adalah pada atribut kendaraan (misalnya, attributes.<key> = <value> atau attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Selain itu, semua atribut disimpan sebagai string, sehingga satu-satunya perbandingan yang didukung terhadap atribut adalah perbandingan string. Untuk membandingkan dengan nilai angka atau boolean, nilai harus dikutip secara eksplisit agar diperlakukan sebagai string (misalnya, attributes.<key> = "10" atau attributes.<key> = "true").

Jumlah maksimum batasan yang diizinkan dalam kueri filter adalah 50. Batasan adalah bagian dari kueri dalam bentuk attribute.<KEY> <COMPARATOR> <VALUE>, misalnya attributes.foo = bar adalah 1 batasan.
viewport

Viewport

Opsional. Filter yang membatasi kendaraan yang ditampilkan hanya pada kendaraan yang lokasi terakhirnya diketahui berada di area persegi panjang yang ditentukan oleh area tampilan.

ListDeliveryVehiclesResponse

Pesan respons ListDeliveryVehicles.

Kolom
delivery_vehicles[]

DeliveryVehicle

Kumpulan kendaraan pengiriman yang memenuhi kriteria pemfilteran yang diminta. Jika tidak ada filter yang ditentukan, permintaan akan menampilkan semua kendaraan pengiriman. Respons yang berhasil juga bisa kosong. Respons kosong menunjukkan bahwa tidak ada kendaraan pengiriman yang ditemukan memenuhi kriteria filter yang diminta.
next_page_token

string

Anda dapat meneruskan token ini di ListDeliveryVehiclesRequest untuk terus mencantumkan hasil. Jika semua hasil ditampilkan, kolom ini tidak akan ada dalam respons, atau akan berupa string kosong.
total_size

int64

Jumlah total kendaraan pengiriman yang cocok dengan kriteria permintaan, di semua halaman.

ListTasksRequest

Pesan permintaan ListTasks.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
parent

string

Wajib. Harus dalam format providers/{provider}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.
page_size

int32

Opsional. Jumlah maksimum Tugas yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika Anda tidak menentukan nilai ini, server akan menentukan jumlah hasil yang akan ditampilkan.
page_token

string

Opsional. Token halaman yang diterima dari panggilan ListTasks sebelumnya. Anda dapat memberikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListTasks harus sesuai dengan panggilan yang menyediakan token halaman.
filter

string

Opsional. Kueri filter yang akan diterapkan saat mencantumkan Tugas. Lihat http://aip.dev/160 untuk contoh sintaksis filter. Jika Anda tidak menentukan nilai, atau jika Anda memfilter string kosong, semua Tugas akan ditampilkan. Untuk mengetahui informasi tentang properti Tugas yang dapat Anda filter, lihat Mencantumkan tugas.

ListTasksResponse

Respons ListTasks yang berisi kumpulan Tugas yang memenuhi kriteria filter di ListTasksRequest.

Kolom
tasks[]

Task

Kumpulan Tugas yang memenuhi kriteria pemfilteran yang diminta. Jika tidak ada filter yang ditentukan, permintaan akan menampilkan semua tugas. Respons yang berhasil juga bisa kosong. Respons kosong menunjukkan bahwa tidak ada Tugas yang ditemukan yang memenuhi kriteria filter yang diminta.
next_page_token

string

Teruskan token ini di ListTasksRequest untuk melanjutkan pencantuman hasil. Jika semua hasil telah ditampilkan, kolom ini akan berupa string kosong, atau tidak muncul dalam respons.
total_size

int64

Jumlah total Tugas yang cocok dengan kriteria permintaan, di semua halaman.

LocationInfo

Lokasi dengan ID tambahan.

Kolom
point

LatLng

Koordinat lokasi. point atau place harus ditentukan sebagai input. Jika keduanya ditentukan, point akan digunakan untuk perutean dan place akan digunakan untuk metadata. Jika hanya place yang ditentukan sebagai input, point akan dihitung dari place dan disertakan dalam output.
place

string

Nama resource tempat yang merepresentasikan lokasi ini. Formatnya adalah places/{place_id}. point atau place harus ditentukan sebagai input. Jika keduanya ditentukan, point akan digunakan untuk perutean dan place akan digunakan untuk metadata. place hanya disertakan dalam output jika disertakan dalam input, yang berarti tidak ada penelusuran place dari LatLng yang dilakukan.

Ini adalah fitur eksperimental.
point_location_source

PointSource

Hanya output. Sumber kolom latlng point. Ini adalah bagian dari fitur eksperimental.

PointSource

Menunjukkan sumber LatLng.

Enum
POINT_SOURCE_UNSPECIFIED Sumber titik tidak ditentukan.
POINT_SOURCE_DEVELOPER_PROVIDED LatLng diberikan secara eksplisit oleh developer.
POINT_SOURCE_CALCULATED_FROM_PLACE LatLng dihitung dari tempat yang diberikan.

Tugas

Tugas di Delivery API mewakili satu tindakan yang akan dilacak. Secara umum, ada perbedaan antara Tugas terkait pengiriman dan Tugas istirahat. Pengiriman dapat memiliki beberapa Tugas yang terkait dengannya. Misalnya, mungkin ada satu Tugas untuk pengambilan, dan satu lagi untuk pengantaran atau transfer. Selain itu, Tugas yang berbeda untuk pengiriman tertentu dapat ditangani oleh kendaraan yang berbeda. Misalnya, satu kendaraan dapat menangani pengambilan, mengantarkan kiriman ke hub, sementara kendaraan lain mengantarkan kiriman yang sama dari hub ke lokasi pengantaran.

Catatan: gRPC dan REST API menggunakan konvensi penamaan kolom yang berbeda. Misalnya, kolom Task.journey_sharing_info di gRPC API dan kolom Task.journeySharingInfo di REST API merujuk ke kolom yang sama.

Kolom
name

string

Harus dalam format providers/{provider}/tasks/{task}.
type

Type

Wajib. Tidak dapat diubah. Menentukan jenis Tugas. Misalnya, istirahat atau pengiriman.
state

State

Wajib. Status eksekusi Tugas saat ini.
task_outcome

TaskOutcome

Hasil Tugas.
task_outcome_time

Timestamp

Stempel waktu yang menunjukkan kapan hasil Task ditetapkan oleh penyedia.
task_outcome_location

LocationInfo

Lokasi tempat hasil Task ditetapkan. Nilai ini diperbarui sebagai bagian dari UpdateTask. Jika nilai ini tidak diperbarui secara eksplisit oleh penyedia, Fleet Engine akan mengisinya secara default dengan lokasi kendaraan terakhir yang diketahui (lokasi mentah).
task_outcome_location_source

TaskOutcomeLocationSource

Menunjukkan asal nilai task_outcome_location.
tracking_id

string

Tidak dapat diubah. Kolom ini memfasilitasi penyimpanan ID sehingga Anda dapat menghindari penggunaan pemetaan yang rumit. Anda tidak dapat menetapkan tracking_id untuk Tugas berjenis UNAVAILABLE dan SCHEDULED_STOP. ID ini tunduk pada batasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalisasi sesuai dengan Unicode Normalization Form C.
  • Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
delivery_vehicle_id

string

Hanya output. ID kendaraan yang menjalankan Tugas ini. ID Kendaraan Pengiriman tunduk pada batasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalisasi sesuai dengan Unicode Normalization Form C.
  • Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
planned_location

LocationInfo

Tidak dapat diubah. Lokasi tempat Tugas akan diselesaikan. Opsional untuk Tugas UNAVAILABLE, tetapi wajib untuk semua Tugas lainnya.
task_duration

Duration

Wajib. Tidak dapat diubah. Waktu yang diperlukan untuk menjalankan Tugas di lokasi ini.
target_time_window

TimeWindow

Periode waktu saat tugas harus diselesaikan.
journey_sharing_info

JourneySharingInfo

Hanya output. Kolom spesifik untuk berbagi perjalanan. Tidak diisi saat statusnya CLOSED.
task_tracking_view_config

TaskTrackingViewConfig

Konfigurasi untuk pelacakan tugas yang menentukan elemen data mana yang dapat dilihat oleh pengguna akhir dalam keadaan apa.
attributes[]

TaskAttribute

Daftar atribut Tugas kustom. Setiap atribut harus memiliki kunci unik.

JourneySharingInfo

Kolom spesifik berbagi perjalanan.

Kolom
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Informasi pelacakan untuk perhentian yang akan dilakukan kendaraan yang ditetapkan sebelum menyelesaikan Tugas ini. Perhatikan bahwa daftar ini dapat berisi perhentian dari tugas lain.

Segmen pertama, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) atau Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), berisi informasi rute dari lokasi terakhir pengemudi yang diketahui ke VehicleStop berikutnya. Informasi rute saat ini biasanya berasal dari aplikasi pengemudi, kecuali untuk beberapa kasus yang tercantum dalam dokumentasi untuk DeliveryVehicle.current_route_segment. Segmen lainnya di Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) atau Task.journeySharingInfo.remainingVehicleJourneySegments (REST) diisi oleh Fleet Engine. Aset ini memberikan informasi rute di antara VehicleStops yang tersisa.
last_location

DeliveryVehicleLocation

Menunjukkan lokasi terakhir yang dilaporkan dari kendaraan yang ditetapkan.
last_location_snappable

bool

Menunjukkan apakah lastLocation kendaraan dapat disesuaikan dengan current_route_segment. Nilai ini adalah False jika last_location atau current_route_segment tidak ada. Nilai ini dihitung oleh Fleet Engine. Pembaruan dari klien diabaikan.

Negara Bagian

Status Tugas. Hal ini menunjukkan progres Tugas.

Enum
STATE_UNSPECIFIED Default. Digunakan untuk status Tugas yang tidak ditentukan atau tidak dikenali.
OPEN Tugas belum ditetapkan ke kendaraan pengiriman, atau kendaraan pengiriman belum melewati perhentian kendaraan yang ditetapkan Task.
CLOSED Saat kendaraan melewati halte kendaraan untuk Tugas ini.

TaskOutcome

Hasil upaya untuk mengeksekusi Tugas. Saat TaskState ditutup, TaskOutcome menunjukkan apakah proses berhasil diselesaikan.

Enum
TASK_OUTCOME_UNSPECIFIED Hasil Tugas sebelum nilainya ditetapkan.
SUCCEEDED Tugas berhasil diselesaikan.
FAILED Tugas tidak dapat diselesaikan, atau dibatalkan.

TaskOutcomeLocationSource

Identitas sumber yang mengisi task_outcome_location.

Enum
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED Hasil tugas sebelum ditetapkan.
PROVIDER Penyedia menentukan task_outcome_location.
LAST_VEHICLE_LOCATION Penyedia tidak menentukan task_outcome_location, sehingga Fleet Engine menggunakan lokasi terakhir kendaraan yang diketahui.

Jenis

Jenis Tugas.

Enum
TYPE_UNSPECIFIED Secara default, jenis Tugas tidak diketahui.
PICKUP Tugas pengambilan adalah tindakan yang dilakukan untuk mengambil kiriman dari pelanggan. Pengambilan kendaraan feeder atau depot harus menggunakan jenis SCHEDULED_STOP.
DELIVERY Tugas pengiriman adalah tindakan yang dilakukan untuk mengirimkan kiriman kepada pelanggan akhir. Pengantaran kendaraan depot atau pengumpan harus menggunakan jenis SCHEDULED_STOP.
SCHEDULED_STOP Tugas perhentian terjadwal digunakan untuk tujuan perencanaan. Misalnya, ini dapat mewakili pengambilan atau pengantaran kiriman dari kendaraan atau depot pengumpan. Tidak boleh digunakan untuk pengiriman apa pun yang diambil atau diantar dari pelanggan akhir.
UNAVAILABLE Tugas yang berarti Kendaraan tidak tersedia untuk servis. Misalnya, hal ini dapat terjadi saat pengemudi beristirahat, atau saat kendaraan diisi bahan bakar.

TaskAttribute

Menjelaskan atribut tugas sebagai key-value pair. Panjang string "key:value" tidak boleh melebihi 256 karakter.

Kolom
key

string

Kunci atribut. Kunci tidak boleh berisi karakter titik dua (:).
Kolom union task_attribute_value. Nilai atribut dapat berupa jenis string, bool, atau double. Jika tidak ada yang ditetapkan, string_value TaskAttribute akan disimpan sebagai string kosong "". task_attribute_value hanya dapat berupa salah satu dari berikut:
string_value

string

Nilai atribut berjenis string.
bool_value

bool

Nilai atribut berjenis Boolean.
number_value

double

Nilai atribut yang diketik ganda.

TaskTrackingInfo

Pesan TaskTrackingInfo. Pesan berisi informasi pelacakan tugas yang akan digunakan untuk ditampilkan. Jika ID pelacakan dikaitkan dengan beberapa Tugas, Fleet Engine menggunakan heuristik untuk memutuskan TaskTrackingInfo Tugas mana yang akan dipilih.

Kolom
name

string

Harus dalam format providers/{provider}/taskTrackingInfo/{tracking}, dengan tracking mewakili ID pelacakan.
tracking_id

string

Tidak dapat diubah. ID pelacakan Tugas. * Harus berupa string Unicode yang valid. * Dibatasi hingga panjang maksimum 64 karakter. * Dinormalisasi sesuai dengan Unicode Normalization Form C. * Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
vehicle_location

DeliveryVehicleLocation

Lokasi terakhir kendaraan.
route_polyline_points[]

LatLng

Daftar titik yang jika terhubung akan membentuk polyline rute yang diharapkan kendaraan ke lokasi tugas ini.
remaining_stop_count

Int32Value

Menunjukkan jumlah perhentian yang tersisa hingga kendaraan mencapai perhentian tugas, termasuk perhentian tugas. Misalnya, jika perhentian berikutnya kendaraan adalah perhentian tugas, nilainya adalah 1.
remaining_driving_distance_meters

Int32Value

Total jarak yang tersisa dalam meter ke VehicleStop yang diminati.
estimated_arrival_time

Timestamp

Stempel waktu yang menunjukkan perkiraan waktu tiba di lokasi perhentian.
estimated_task_completion_time

Timestamp

Stempel waktu yang menunjukkan perkiraan waktu penyelesaian Tugas.
state

State

Status eksekusi Tugas saat ini.
task_outcome

TaskOutcome

Hasil upaya untuk mengeksekusi Tugas.
task_outcome_time

Timestamp

Stempel waktu yang menunjukkan kapan hasil Tugas ditetapkan oleh penyedia.
planned_location

LocationInfo

Tidak dapat diubah. Lokasi tempat Tugas akan diselesaikan.
target_time_window

TimeWindow

Periode waktu saat tugas harus diselesaikan.
attributes[]

TaskAttribute

Atribut khusus yang ditetapkan pada tugas.

TaskTrackingViewConfig

Pesan konfigurasi yang menentukan kapan elemen data Tugas harus terlihat oleh pengguna akhir.

Kolom
route_polyline_points_visibility

VisibilityOption

Kolom yang menentukan kapan titik polyline rute dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan.
estimated_arrival_time_visibility

VisibilityOption

Kolom yang menentukan kapan perkiraan waktu tiba dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan.
estimated_task_completion_time_visibility

VisibilityOption

Kolom yang menentukan kapan perkiraan waktu penyelesaian tugas dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan.
remaining_driving_distance_visibility

VisibilityOption

Kolom yang menentukan kapan jarak mengemudi yang tersisa dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan.
remaining_stop_count_visibility

VisibilityOption

Kolom yang menentukan kapan jumlah perhentian yang tersisa dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan.
vehicle_location_visibility

VisibilityOption

Kolom yang menentukan kapan lokasi kendaraan dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan.

VisibilityOption

Pesan opsi yang menentukan kapan elemen data harus terlihat oleh pengguna akhir.

Kolom
Kolom union visibility_option. Opsi visibilitas tertentu yang dipilih. visibility_option hanya dapat berupa salah satu dari berikut:
remaining_stop_count_threshold

int32

Elemen data ini dapat dilihat oleh pengguna akhir jika jumlah penghentian yang tersisa <= remaining_stop_count_threshold.
duration_until_estimated_arrival_time_threshold

Duration

Elemen data ini dapat dilihat oleh pengguna akhir jika perkiraan waktu tiba di halte <= duration_until_estimated_arrival_time_threshold.
remaining_driving_distance_meters_threshold

int32

Elemen data ini dapat dilihat oleh pengguna akhir jika sisa jarak mengemudi dalam meter <= remaining_driving_distance_meters_threshold.
always

bool

Jika disetel ke benar (true), elemen data ini akan selalu terlihat oleh pengguna akhir tanpa nilai minimum. Kolom ini tidak dapat disetel ke salah (false).
never

bool

Jika disetel ke benar (true), elemen data ini selalu disembunyikan dari pengguna akhir tanpa nilai minimum. Kolom ini tidak dapat disetel ke salah (false).

TimeWindow

Rentang waktu.

Kolom
start_time

Timestamp

Wajib. Waktu mulai periode waktu (inklusif).
end_time

Timestamp

Wajib. Waktu berakhir periode waktu (inklusif).

UpdateDeliveryVehicleRequest

Pesan permintaan UpdateDeliveryVehicle.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
delivery_vehicle

DeliveryVehicle

Wajib. Pembaruan entity DeliveryVehicle yang akan diterapkan. Catatan: Anda tidak dapat memperbarui nama DeliveryVehicle.
update_mask

FieldMask

Wajib. Mask kolom yang menunjukkan kolom DeliveryVehicle yang akan diperbarui. Perhatikan bahwa update_mask harus berisi setidaknya satu kolom.

Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "remaining_vehicle_journey_segments".

UpdateTaskRequest

Pesan permintaan UpdateTask.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.
task

Task

Wajib. Tugas yang terkait dengan pembaruan. Kolom berikut dikelola oleh Fleet Engine. Jangan perbarui menggunakan Task.update.

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

Catatan: Anda tidak dapat mengubah nilai task_outcome setelah ditetapkan.

Jika Tugas telah ditetapkan ke kendaraan pengiriman, jangan tetapkan status Tugas ke CLOSED menggunakan Task.update. Sebagai gantinya, hapus VehicleStop yang berisi Tugas dari kendaraan pengiriman, yang secara otomatis menetapkan status Tugas ke DITUTUP.
update_mask

FieldMask

Wajib. Mask kolom yang menunjukkan kolom Tugas mana yang akan diperbarui. Catatan: update_mask harus berisi setidaknya satu kolom.

Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "task_outcome,task_outcome_time,task_outcome_location".

VehicleJourneySegment

Mewakili segmen perjalanan Kendaraan - dari perhentian sebelumnya ke perhentian saat ini. Jika ini adalah perhentian aktif pertama, maka rutenya adalah dari lokasi kendaraan saat ini ke perhentian ini.

Kolom
stop

VehicleStop

Menentukan lokasi perhentian, beserta Task yang terkait dengan perhentian. Beberapa kolom VehicleStop mungkin tidak ada jika segmen perjalanan ini adalah bagian dari JourneySharingInfo.
driving_distance_meters

Int32Value

Hanya output. Jarak perjalanan dari perhentian sebelumnya ke perhentian ini. Jika perhentian saat ini adalah perhentian pertama dalam daftar segmen perjalanan, titik awalnya adalah lokasi kendaraan yang dicatat pada saat perhentian ini ditambahkan ke daftar. Kolom ini mungkin tidak ada jika segmen perjalanan ini merupakan bagian dari JourneySharingInfo.
driving_duration

Duration

Hanya output. Waktu perjalanan dari perhentian sebelumnya ke perhentian ini. Jika perhentian saat ini adalah perhentian pertama dalam daftar segmen perjalanan, titik awalnya adalah lokasi Kendaraan yang dicatat pada saat perhentian ini ditambahkan ke daftar.

Jika kolom ini ditentukan di jalur Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) atau Task.remainingVehicleJourneySegments[0].drivingDuration (REST), maka kolom ini dapat diisi dengan nilai dari DeliveryVehicle.remaining_duration (gRPC) atau DeliveryVehicle.remainingDuration (REST). Hal ini memberikan durasi mengemudi yang tersisa dari lokasi terakhir yang diketahui aplikasi pengemudi, bukan waktu mengemudi dari perhentian sebelumnya.
path[]

LatLng

Hanya output. Jalur dari perhentian sebelumnya ke perhentian ini. Jika perhentian saat ini adalah perhentian pertama dalam daftar segmen perjalanan, maka ini adalah jalur dari lokasi kendaraan saat ini ke perhentian ini pada saat perhentian ditambahkan ke daftar. Kolom ini mungkin tidak ada jika segmen perjalanan ini merupakan bagian dari JourneySharingInfo.

Jika kolom ini ditentukan di jalur Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) atau Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST), kolom ini dapat diisi dengan LatLng yang didekode dari DeliveryVehicle.current_route_segment (gRPC) atau DeliveryVehicle.currentRouteSegment (REST). Hal ini memberikan jalur mengemudi dari lokasi terakhir yang diketahui aplikasi pengemudi, bukan jalur dari perhentian sebelumnya.

VehicleStop

Menjelaskan titik tempat Kendaraan berhenti untuk melakukan satu atau beberapa Task.

Kolom
planned_location

LocationInfo

Wajib. Lokasi perhentian. Perhatikan bahwa lokasi dalam Task mungkin tidak sama persis dengan lokasi ini, tetapi akan berada dalam jarak dekat dari lokasi ini. Kolom ini tidak akan diisi dalam respons panggilan GetTask.
tasks[]

TaskInfo

Daftar Task yang akan dilakukan di perhentian ini. Kolom ini tidak akan diisi dalam respons panggilan GetTask.
state

State

Status VehicleStop. Kolom ini tidak akan diisi dalam respons panggilan GetTask.

Negara Bagian

Status VehicleStop saat ini.

Enum
STATE_UNSPECIFIED Tak diketahui.
NEW Dibuat, tetapi tidak merutekan secara aktif.
ENROUTE Ditetapkan dan merutekan secara aktif.
ARRIVED Tiba di halte. Mengasumsikan bahwa saat Kendaraan sedang merutekan ke perhentian berikutnya, semua perhentian sebelumnya telah diselesaikan.

TaskInfo

Informasi tambahan tentang Tugas yang dilakukan di perhentian ini.

Kolom
task_id

string

ID Tugas. Kolom ini tidak akan diisi dalam respons panggilan GetTask. ID tugas tunduk pada batasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi hingga panjang maksimum 64 karakter.
  • Dinormalisasi sesuai dengan Unicode Normalization Form C.
  • Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'.
task_duration

Duration

Hanya output. Waktu yang diperlukan untuk melakukan Tugas.
target_time_window

TimeWindow

Hanya output. Periode waktu saat tugas harus diselesaikan. Nilai ini hanya ditetapkan dalam respons terhadap GetDeliveryVehicle.