Solusi Armada Terakhir saat ini hanya tersedia untuk pelanggan tertentu. Hubungi bagian penjualan untuk mempelajari lebih lanjut.

Package maps.fleetengine.delivery.v1

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Indeks

LayananPenayangan

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.

GetDeliveryVehicle

rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle)

Menampilkan instance DeliveryVehicle yang ditentukan.

GetTask

rpc GetTask(GetTaskRequest) returns (Task)

Mendapatkan informasi tentang Task.

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.

SearchTasks

rpc SearchTasks(SearchTasksRequest) returns (SearchTasksResponse)

Mendapatkan semua Task dengan tracking_id tertentu.

UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Menulis data DeliveryVehicle yang telah diupdate ke Fleet Engine, dan menetapkan Tasks ke DeliveryVehicle. Anda tidak dapat memperbarui nama DeliveryVehicle. Namun, Anda dapat mengupdate remaining_vehicle_journey_segments, tetapi harus berisi semua VehicleJourneySegment yang saat ini berada di DeliveryVehicle. task_id akan diambil dari remaining_vehicle_journey_segments, dan Tasks yang sesuai akan ditetapkan ke DeliveryVehicle jika belum ditetapkan.

TugasPembaruan

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, maka kolom header dalam pesan CreateTaskRequest harus kosong atau harus cocok dengan kolom ini.

parent

string

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

requests[]

CreateTaskRequest

Wajib diisi. Pesan permintaan yang menentukan resource yang akan dibuat. Catatan: Anda dapat membuat maksimal 500 tugas dalam satu 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 diisi. Harus dalam format providers/{provider} Penyedia harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.

delivery_vehicle_id

string

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

  • Harus berupa string Unicode yang valid.
  • Dibatasi panjang maksimum 64 karakter.
  • Dinormalkan sesuai dengan Formulir Normalisasi Unicode C.
  • Tidak boleh berisi salah satu karakter ASCII berikut: '/', ':', ' ?>#39;, ',', atau '#'.
delivery_vehicle

DeliveryVehicle

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

  • lokasi_terakhir
  • atribut

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 diisi. Harus dalam format providers/{provider} provider harus berupa Project ID Google Cloud. Misalnya, sample-cloud-project.

task_id

string

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

  • Harus berupa string Unicode yang valid.
  • Dibatasi panjang maksimum 64 karakter.
  • Dinormalkan sesuai dengan Formulir Normalisasi Unicode C.
  • Tidak boleh berisi salah satu karakter ASCII berikut: '/', ':', ' ?>#39;, ',', atau '#'.
task

Task

Wajib diisi. 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 UNAVAILABLE tugas)
  • task_duration

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

HeaderPermintaanPenayangan

RequestHeader berisi kolom yang sama untuk semua permintaan RPC Penayangan.

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 diisi. Kode wilayah CLDR wilayah tempat permintaan berasal. Contoh nilai kolom: US.

sdk_version

string

Versi SDK panggilan, jika berlaku. Format versinya 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 diandalkan SDK panggilan, jika berlaku. Format versinya adalah "major.minor.patch", contoh: 5.2.1.

nav_sdk_version

string

Versi NavSDK yang digunakan untuk memanggil SDK, jika berlaku. Format versinya adalah "major.minor.patch", contoh: 2.1.0.

platform

Platform

Platform SDK panggilan.

manufacturer

string

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

android_api_level

int32

API level Android SDK panggilan, hanya berlaku untuk Android SDK. Contoh nilai kolom: 23.

Platform

Platform SDK panggilan.

Enumerasi
PLATFORM_UNSPECIFIED Nilai default. Nilai ini digunakan jika platform dihilangkan.
ANDROID Permintaan ini berasal dari Android.
IOS Permintaan ini berasal dari iOS.
WEB Permintaan ini berasal dari web.

Jenis Sdk

Kemungkinan jenis SDK.

Enumerasi
SDK_TYPE_UNSPECIFIED Nilai default. Nilai ini digunakan jika sdk_type dihilangkan.
CONSUMER SDK panggilan adalah Konsumen.
DRIVER SDK panggilan adalah Driver.
JAVASCRIPT SDK panggilan adalah JavaScript.

KendaraanKendaraan

Pesan DeliveryVehicle. Kendaraan pengiriman mengangkut pengiriman dari depot ke lokasi pengiriman, dan dari lokasi penjemputan ke depot. Dalam beberapa kasus, kendaraan pengiriman juga mengangkut pengiriman langsung dari lokasi penjemputan 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 Kendaraan yang terakhir dilaporkan.

navigation_status

DeliveryVehicleNavigationStatus

Status navigasi Kendaraan Pengiriman.

current_route_segment

bytes

Polyline yang dienkode yang menentukan rute yang direkomendasikan oleh navigasi ke titik jalan berikutnya. Aplikasi pengemudi Anda akan memperbaruinya saat perhentian tercapai atau dilewati, 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 driver belum memperbarui lokasinya baru-baru ini, jadi nilai terakhir yang diperbarui untuk kolom ini mungkin sudah tidak berlaku.

  • Aplikasi pengemudi baru-baru ini memperbarui lokasinya, tetapi current_route_segment sudah usang dan mengarah ke perhentian kendaraan sebelumnya.

Dalam kasus ini, Fleet Engine mengisi kolom ini dengan rute dari KendaraanStop yang baru saja diteruskan ke KendaraanStop yang akan datang untuk memastikan bahwa konsumen kolom ini memiliki informasi terbaik yang tersedia di jalur Kendaraan Pengiriman saat ini.

current_route_segment_end_point

LatLng

Lokasi tempat current_route_segment berakhir. Saat ini tidak diisi oleh aplikasi pengemudi, tetapi Anda dapat menyediakannya pada panggilan UpdateDeliveryVehicle. Hal ini dapat berupa LatLng dari perhentian kendaraan mendatang, atau LatLng terakhir dari current_route_segment. Fleet Engine kemudian akan melakukan yang terbaik untuk melakukan interpolasi terhadap 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. Nilai ini biasanya diperbarui oleh aplikasi pengemudi karena dianggap memiliki informasi yang lebih akurat tentang rute saat ini daripada Fleet Engine. Namun, data tersebut mungkin diisi oleh Fleet Engine. Untuk 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 Tugas aktif yang ditetapkan ke Kendaraan Pengiriman.

Kolom ini diabaikan dalam panggilan UpdateDeliveryVehicle jika kolom current_route_segment kosong.

remaining_duration

Duration

Sisa waktu mengemudi untuk current_route_segment. Nilai ini biasanya diperbarui oleh aplikasi pengemudi karena dianggap memiliki informasi yang lebih akurat tentang rute saat ini daripada Fleet Engine. Namun, data tersebut mungkin diisi oleh Fleet Engine. Untuk informasi selengkapnya, lihat DeliveryVehicle.current_route_segment: Kolom ini ditampilkan dalam Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) atau Task.remainingVehicleJourneySegments[0].drivingDuration (REST) untuk semua tugas aktif yang ditetapkan ke Kendaraan Pengiriman.

Kolom ini diabaikan dalam panggilan UpdateDeliveryVehicle jika kolom current_route_segment kosong.

remaining_vehicle_journey_segments[]

VehicleJourneySegment

Segmen perjalanan yang ditetapkan untuk Kendaraan Pengiriman ini, dimulai dari lokasi yang terakhir dilaporkan di Kendaraan.

attributes[]

DeliveryVehicleAttribute

Daftar atribut Custom Delivery Kendaraan. Kendaraan Pengiriman dapat memiliki maksimal 50 atribut, dan setiap atribut harus memiliki kunci yang unik.

AtributVehicleVehicle

Mendeskripsikan atribut kendaraan sebagai key-value pair. "key:value" panjang string tidak boleh lebih dari 256 karakter.

Kolom
key

string

Kunci atribut. Kunci tidak boleh berisi karakter titik dua (:).

value

string

Nilai atribut.

Lokasi mengelola Kendaraan

Lokasi, kecepatan, dan arah kendaraan pada waktu tertentu.

Kolom
location

LatLng

Lokasi kendaraan. Ketika 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 di location_sensor.

horizontal_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan latlng_accuracy.

latlng_accuracy

DoubleValue

Akurasi location dalam meter sebagai radius.

heading

Int32Value

Arah kendaraan bergerak dalam derajat. 0 mewakili Utara. Rentang yang valid adalah [0,360).

bearing_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan heading_accuracy.

heading_accuracy

DoubleValue

Akurasi heading dalam derajat.

altitude

DoubleValue

Ketinggian dalam meter di atas WGS84.

vertical_accuracy
(deprecated)

DoubleValue

Tidak digunakan lagi: Sebagai gantinya, gunakan altitude_accuracy.

altitude_accuracy

DoubleValue

Akurasi altitude dalam meter.

speed_kmph
(deprecated)

Int32Value

Kecepatan kendaraan dalam kilometer per jam. Tidak digunakan lagi: Sebagai gantinya, gunakan speed.

speed

DoubleValue

Kecepatan kendaraan dalam meter/detik

speed_accuracy

DoubleValue

Akurasi speed dalam meter/detik.

update_time

Timestamp

Waktu saat location dilaporkan oleh sensor sesuai dengan jam sensor.

server_time

Timestamp

Hanya output. Waktu ketika server menerima informasi lokasi.

location_sensor

DeliveryVehicleLocationSensor

Penyedia data lokasi (misalnya, GPS).

is_road_snapped

BoolValue

Apakah location dipaskan ke jalan.

is_gps_sensor_enabled

BoolValue

Hanya input. Menunjukkan apakah sensor GPS diaktifkan pada perangkat seluler.

time_since_update

Int32Value

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

num_stale_updates

Int32Value

Hanya input. Jumlah upaya tambahan untuk mengirim lokasi ini ke server. Jika nilai ini nol, berarti data tersebut sudah tidak berlaku.

raw_location

LatLng

Lokasi kendaraan mentah (tidak diproses oleh snapper jalan).

raw_location_time

Timestamp

Hanya input. Stempel waktu yang terkait dengan lokasi mentah.

raw_location_sensor

DeliveryVehicleLocationSensor

Hanya input. Sumber lokasi mentah.

raw_location_accuracy

DoubleValue

Hanya input. Akurasi raw_location sebagai radius, dalam meter.

supplemental_location

LatLng

Hanya input. Lokasi tambahan yang disediakan oleh aplikasi integrasi.

supplemental_location_time

Timestamp

Hanya input. Stempel waktu yang terkait dengan lokasi tambahan.

supplemental_location_sensor

DeliveryVehicleLocationSensor

Hanya input. Sumber lokasi tambahan.

supplemental_location_accuracy

DoubleValue

Hanya input. Akurasi supplemental_location sebagai radius, dalam meter.

road_snapped
(deprecated)

bool

Tidak digunakan lagi: Sebagai gantinya, gunakan is_road_snapped.

DeliveryVehicleLocationSensor

Sensor atau metodologi yang digunakan untuk menentukan lokasi.

Enumerasi
UNKNOWN_SENSOR Sensor tidak ditentukan atau tidak diketahui.
GPS GPS atau GPS Berbantuan.
NETWORK GPS berbantuan, ID menara BTS, atau titik akses WiFi.
PASSIVE ID menara BTS atau titik akses Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Sinyal lokasi yang dipaskan ke posisi jalan terbaik.
FUSED_LOCATION_PROVIDER Penyedia lokasi gabungan dalam layanan Google Play.
CORE_LOCATION Penyedia lokasi di sistem operasi Apple.

StatusNavigasiKendaraanKendaraan

Status navigasi kendaraan.

Enumerasi
UNKNOWN_NAVIGATION_STATUS Status navigasi tidak ditentukan.
NO_GUIDANCE Navigasi aplikasi Pengemudi dalam mode FREE_NAV.
ENROUTE_TO_DESTINATION Navigasi belokan demi belokan tersedia dan navigasi aplikasi Pengemudi 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. ID Berikutnya: 4

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.

name

string

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

GetTaskRequest

Pesan permintaan GetTask.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.

name

string

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

ListDeliveryVehiclesRequest

Pesan permintaan ListDeliveryVehicles.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.

parent

string

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

page_size

int32

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

page_token

string

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

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk ListDeliveryVehicles harus sesuai dengan panggilan yang disediakan 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 satu-satunya kueri yang didukung untuk ListDeliveryVehicles ada di 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 formulir attribute.<KEY> <COMPARATOR> <VALUE>, misalnya attributes.foo = bar adalah 1 pembatasan.

viewport

Viewport

Opsional. Filter yang membatasi area penelusuran menjadi persegi panjang yang ditentukan oleh titik sudut timur laut dan barat daya.

Jika ditentukan, hanya kendaraan yang berada di area penelusuran yang ditampilkan.

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 dapat 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 dalam 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 diisi. Harus dalam format providers/{provider} provider harus berupa Project ID 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 disediakan untuk ListTasks harus sesuai dengan panggilan yang disediakan token halaman.

filter

string

Opsional. Kueri filter yang akan diterapkan saat mencantumkan Tasks. 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 difilter, lihat Daftar 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 dapat kosong. Respons kosong menunjukkan bahwa tidak ada Tasks yang ditemukan memenuhi kriteria filter yang diminta.

next_page_token

string

Teruskan token ini di ListTasksRequest untuk terus mencantumkan hasil. Jika semua hasil telah ditampilkan, kolom ini dapat berupa string kosong, atau tidak muncul dalam respons.

total_size

int64

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

InfoLokasi

Lokasi dengan ID tambahan.

Kolom
point

LatLng

Koordinat lokasi.

SearchTasksRequest

Pesan permintaan SearchTasks yang berisi tracking_id.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.

parent

string

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

tracking_id

string

Wajib diisi. ID kumpulan Tugas terkait yang diminta. ID pelacakan tunduk pada pembatasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi panjang maksimum 64 karakter.
  • Dinormalkan sesuai dengan Formulir Normalisasi Unicode C.
  • Tidak boleh berisi salah satu karakter ASCII berikut: '/', ':', ' ?>#39;, ',', atau '#'.
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, diterima dari panggilan SearchTasks sebelumnya. Anda harus memberikan nilai ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk SearchTasks harus sesuai dengan panggilan yang disediakan token halaman.

ResponsSearchTasks

Respons SearchTasks. File ini berisi kumpulan Tugas yang memenuhi kriteria penelusuran di SearchTasksRequest.

Kolom
tasks[]

Task

Kumpulan Tugas untuk tracking_id yang diminta. Respons yang berhasil juga dapat kosong. Respons kosong menunjukkan bahwa tidak ada Tasks yang dikaitkan dengan tracking_id yang diberikan.

next_page_token

string

Teruskan token ini di SearchTasksRequest untuk terus mencantumkan hasil. Jika semua hasil telah ditampilkan, kolom ini dapat berupa string kosong, atau tidak muncul dalam respons.

Tugas

Tugas di Delivery API mewakili satu tindakan untuk dilacak. Secara umum, ada perbedaan antara Tugas terkait pengiriman dan Tugas penghentian. Pengiriman dapat memiliki beberapa Tugas yang terkait. Misalnya, mungkin ada satu Tugas untuk pengambilan, dan satu untuk penurunan atau transfer. Selain itu, Tugas yang berbeda untuk pengiriman tertentu dapat ditangani oleh kendaraan yang berbeda. Misalnya, satu kendaraan dapat menangani pengambilan, mendorong pengiriman ke pusat, sementara kendaraan lain mendorong pengiriman yang sama dari pusat 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 DeliveryVehicle.journeySharingInfo di REST API merujuk ke kolom yang sama.

Kolom
name

string

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

type

Type

Wajib diisi. Tidak dapat diubah. Menentukan jenis Tugas. Misalnya, jeda atau pengiriman.

state

State

Wajib diisi. Status eksekusi Task saat ini.

task_outcome

TaskOutcome

Hasil Tugas.

task_outcome_time

Timestamp

Stempel waktu yang menunjukkan kapan hasil Tugas ditetapkan oleh penyedia.

task_outcome_location

LocationInfo

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

task_outcome_location_source

TaskOutcomeLocationSource

Menunjukkan dari mana nilai task_outcome_location berasal.

tracking_id

string

Tidak dapat diubah. Kolom ini memfasilitasi penyimpanan ID sehingga Anda dapat menghindari penggunaan pemetaan yang rumit. Anda tidak dapat menyetel tracking_id untuk Tasks jenis UNAVAILABLE dan SCHEDULED_STOP. ID ini tunduk pada pembatasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi panjang maksimum 64 karakter.
  • Dinormalkan sesuai dengan Formulir Normalisasi Unicode C.
  • Tidak boleh berisi salah satu karakter ASCII berikut: '/', ':', ' ?>#39;, ',', atau '#'.
delivery_vehicle_id

string

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

  • Harus berupa string Unicode yang valid.
  • Dibatasi panjang maksimum 64 karakter.
  • Dinormalkan sesuai dengan Formulir Normalisasi Unicode C.
  • Tidak boleh berisi salah satu karakter ASCII berikut: '/', ':', ' ?>#39;, ',', atau '#'.
planned_location

LocationInfo

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

task_duration

Duration

Wajib diisi. Tidak dapat diubah. Waktu yang diperlukan untuk mengeksekusi Tugas di lokasi ini.

journey_sharing_info

JourneySharingInfo

Hanya output. Kolom khusus berbagi perjalanan. Tidak diisi jika status adalah CLOSED.

Info Perjalanan

Perjalanan berbagi kolom tertentu.

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 yang diketahui pengemudi ke VehicleStop mendatang. 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. Class ini memberikan informasi rute antara VehicleStops yang tersisa.

last_location

DeliveryVehicleLocation

Menunjukkan lokasi kendaraan yang terakhir dilaporkan.

last_location_snappable

bool

Menunjukkan apakah lastLocation kendaraan dapat dipasang ke current_route_segment. Nilai ini Salah jika last_location atau current_route_segment tidak ada. Nilai ini dihitung oleh Fleet Engine. Pembaruan dari klien akan diabaikan.

Negara bagian

Status Tugas. Ini menunjukkan kemajuan Tasks.

Enumerasi
STATE_UNSPECIFIED Default. Digunakan untuk status Tugas yang tidak ditetapkan atau tidak dikenal.
OPEN Tugas belum ditugaskan ke kendaraan pengiriman, atau kendaraan pengiriman belum melewati perhentian kendaraan yang ditetapkan untuk Tugas.
CLOSED Saat kendaraan melewati kendaraan berhenti untuk Tugas ini.

Hasil Tugas

Hasil dari mencoba menjalankan Tugas. Saat TaskState ditutup, TaskOutcome menunjukkan apakah berhasil diselesaikan.

Enumerasi
TASK_OUTCOME_UNSPECIFIED Hasil tugas sebelum nilainya ditetapkan.
SUCCEEDED Tugas berhasil diselesaikan.
FAILED Tugas tersebut tidak dapat diselesaikan, atau telah dibatalkan.

TaskResultsLocationSource

Identitas sumber yang mengisi task_outcome_location.

Enumerasi
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED Hasil Tugas sebelum ditetapkan.
PROVIDER Penyedia menentukan task_outcome_location.
LAST_VEHICLE_LOCATION Penyedia tidak menentukan task_outcome_location, jadi Fleet Engine menggunakan lokasi kendaraan terakhir yang diketahui.

Jenis

Jenis Tugas.

Enumerasi
TYPE_UNSPECIFIED Default, jenis Tugas tidak diketahui.
PICKUP Tugas pengambilan adalah tindakan yang diambil untuk mengambil pengiriman dari pelanggan. Pengambilan kendaraan di depot atau feeder harus menggunakan jenis SCHEDULED_STOP.
DELIVERY Tugas pengiriman adalah tindakan yang dilakukan untuk mengirimkan pengiriman kepada pelanggan akhir. Pemindahan kendaraan depot atau pengumpan harus menggunakan jenis SCHEDULED_STOP.
SCHEDULED_STOP Tugas penghentian terjadwal digunakan untuk tujuan perencanaan. Misalnya, hal itu dapat mewakili pengambilan atau penurunan pengiriman dari kendaraan pengangkut atau depot. Sebaiknya tidak digunakan untuk pengiriman yang diambil atau diturunkan dari pelanggan akhir.
UNAVAILABLE Tugas yang berarti Kendaraan tidak tersedia untuk diservis. Misalnya, hal ini dapat terjadi saat pengemudi istirahat, atau saat kendaraan sedang diisi bahan bakar.

UpdateDeliveryVehicleRequest

Pesan permintaan UpdateDeliveryVehicle.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.

delivery_vehicle

DeliveryVehicle

Wajib diisi. Pembaruan entitas DeliveryVehicle yang akan diterapkan. Catatan: Anda tidak dapat memperbarui nama DeliveryVehicle.

update_mask

FieldMask

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

Ini adalah daftar kolom yang sepenuhnya memenuhi syarat yang dipisahkan koma. Contoh: "remaining_vehicle_journey_segments".

UpdateTaskRequest

Pesan permintaan UpdateTask.

Kolom
header

DeliveryRequestHeader

Opsional. Header permintaan Delivery API standar.

task

Task

Wajib diisi. Tugas yang terkait dengan update. 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 menyetelnya.

Jika Tugas telah ditetapkan ke kendaraan pengiriman, jangan menyetel status Tugas ke TUTUP menggunakan Task.update. Sebagai gantinya, hapus VehicleStop yang berisi Tugas dari kendaraan pengiriman, yang otomatis menyetel status Tugas ke CLOSED.

update_mask

FieldMask

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

Ini adalah daftar kolom yang sepenuhnya memenuhi syarat yang dipisahkan koma. Contoh: "task_outcome,task_outcome_time,task_outcome_location".

Segmen Perjalanan Kendaraan

Mewakili segmen perjalanan Kendaraan - dari perhentian sebelumnya hingga perhentian saat ini. Jika ini adalah perhentian aktif pertama, artinya kendaraan berasal dari lokasi Kendaraan saat ini hingga perhentian ini.

Kolom
stop

VehicleStop

Menentukan lokasi perhentian, beserta Tugas yang terkait dengan perhentian. Beberapa kolom KendaraanBerhenti 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 awal adalah lokasi kendaraan yang dicatat pada saat perhentian ini ditambahkan ke daftar. Kolom ini mungkin tidak ada jika segmen perjalanan ini adalah 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), kolom tersebut mungkin akan diisi dengan nilai dari DeliveryVehicle.remaining_duration (gRPC) atau DeliveryVehicle.remainingDuration (REST). Data ini memberikan durasi mengemudi yang tersisa dari lokasi terbaru 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, 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 adalah 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 tersebut mungkin akan diisi dengan LatLngs yang didekode dari DeliveryVehicle.current_route_segment (gRPC) atau DeliveryVehicle.currentRouteSegment (REST). Ini memberikan jalur mengemudi dari lokasi terbaru aplikasi pengemudi yang diketahui, bukan jalur dari perhentian sebelumnya.

Perhentian Kendaraan

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

Kolom
planned_location

LocationInfo

Wajib diisi. Lokasi perhentian. Perlu diketahui bahwa lokasi di Tasks mungkin tidak sama persis dengan lokasi ini, namun akan berada dalam jarak pendek. Kolom ini tidak akan diisi sebagai respons terhadap panggilan GetTask atau SearchTasks.

tasks[]

TaskInfo

Daftar Tugas yang akan dilakukan pada perhentian ini. Kolom ini tidak akan diisi sebagai respons terhadap panggilan GetTask atau SearchTasks.

state

State

Status VehicleStop. Kolom ini tidak akan diisi sebagai respons terhadap panggilan GetTask atau SearchTasks.

Negara bagian

Status VehicleStop saat ini.

Enumerasi
STATE_UNSPECIFIED Tidak diketahui.
NEW Dibuat, tetapi tidak merutekan secara aktif.
ENROUTE Pemilihan rute yang ditetapkan dan aktif.
ARRIVED Tiba di perhentian. Dengan asumsi bahwa saat Kendaraan merutekan ke perhentian berikutnya, semua perhentian sebelumnya telah diselesaikan.

InfoTugas

Informasi tambahan tentang Tugas yang dilakukan di perhentian ini.

Kolom
task_id

string

ID Tugas. Kolom ini tidak akan diisi sebagai respons terhadap panggilan GetTask atau SearchTasks. ID tugas tunduk pada batasan berikut:

  • Harus berupa string Unicode yang valid.
  • Dibatasi panjang maksimum 64 karakter.
  • Dinormalkan sesuai dengan Formulir Normalisasi Unicode C.
  • Tidak boleh berisi salah satu karakter ASCII berikut: '/', ':', ' ?>#39;, ',', atau '#'.
task_duration

Duration

Waktu yang diperlukan untuk melakukan Tugas.