Indeks
DeliveryService
(antar muka)BatchCreateTasksRequest
(pesan)BatchCreateTasksResponse
(pesan)CreateDeliveryVehicleRequest
(pesan)CreateTaskRequest
(pesan)DeliveryRequestHeader
(pesan)DeliveryRequestHeader.Platform
(enum)DeliveryRequestHeader.SdkType
(enum)DeliveryVehicle
(pesan)DeliveryVehicle.DeliveryVehicleType
(enum)DeliveryVehicleAttribute
(pesan)DeliveryVehicleLocation
(pesan)DeliveryVehicleLocationSensor
(enum)DeliveryVehicleNavigationStatus
(enum)GetDeliveryVehicleRequest
(pesan)GetTaskRequest
(pesan)GetTaskTrackingInfoRequest
(pesan)ListDeliveryVehiclesRequest
(pesan)ListDeliveryVehiclesResponse
(pesan)ListTasksRequest
(pesan)ListTasksResponse
(pesan)LocationInfo
(pesan)Task
(pesan)Task.JourneySharingInfo
(pesan)Task.State
(enum)Task.TaskOutcome
(enum)Task.TaskOutcomeLocationSource
(enum)Task.Type
(enum)TaskAttribute
(pesan)TaskTrackingInfo
(pesan)TaskTrackingViewConfig
(pesan)TaskTrackingViewConfig.VisibilityOption
(pesan)TimeWindow
(pesan)UpdateDeliveryVehicleRequest
(pesan)UpdateTaskRequest
(pesan)VehicleJourneySegment
(pesan)VehicleStop
(pesan)VehicleStop.State
(enum)VehicleStop.TaskInfo
(pesan)
DeliveryService
Layanan Pengiriman Kilometer Terakhir.
BatchCreateTasks |
---|
Membuat dan menampilkan batch objek |
CreateDeliveryVehicle |
---|
Membuat dan menampilkan |
CreateTask |
---|
Membuat dan menampilkan objek |
GetDeliveryVehicle |
---|
Menampilkan instance |
GetTask |
---|
Mendapatkan informasi tentang |
GetTaskTrackingInfo |
---|
Menampilkan instance |
ListDeliveryVehicles |
---|
Mendapatkan semua |
ListTasks |
---|
Mendapatkan semua |
UpdateDeliveryVehicle |
---|
Menulis data |
UpdateTask |
---|
Memperbarui data |
BatchCreateTasksRequest
Pesan permintaan BatchCreateTask
.
Kolom | |
---|---|
header |
Opsional. Header permintaan Delivery API standar. Catatan: Jika Anda menetapkan kolom ini, kolom header di pesan |
parent |
Wajib. Resource induk yang dibagikan oleh semua tugas. Nilai ini harus dalam format |
requests[] |
Wajib. Pesan permintaan yang menentukan resource yang akan dibuat. Catatan: Anda dapat membuat maksimum 500 tugas dalam satu batch. |
BatchCreateTasksResponse
Pesan respons BatchCreateTask
.
Kolom | |
---|---|
tasks[] |
Tugas yang dibuat. |
CreateDeliveryVehicleRequest
Pesan permintaan CreateDeliveryVehicle
.
Kolom | |
---|---|
header |
Opsional. Header permintaan Delivery API standar. |
parent |
Wajib. Harus dalam format |
delivery_vehicle_id |
Wajib. ID Kendaraan Pengiriman harus unik dan tunduk pada batasan berikut:
|
delivery_vehicle |
Wajib. Entity
Catatan: Kolom |
CreateTaskRequest
Pesan permintaan CreateTask
.
Kolom | |
---|---|
header |
Opsional. Header permintaan Delivery API standar. |
parent |
Wajib. Harus dalam format |
task_id |
Wajib. ID Tugas harus unik, tetapi tidak boleh berupa ID pelacakan pengiriman. Untuk menyimpan ID pelacakan pengiriman, gunakan kolom
|
task |
Wajib. Entity Tugas yang akan dibuat. Saat membuat Tugas, kolom berikut ini wajib diisi:
Catatan: Kolom |
DeliveryRequestHeader
RequestHeader berisi kolom yang umum untuk semua permintaan RPC Penayangan.
Kolom | |
---|---|
language_code |
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 mungkin dalam bahasa apa pun, dengan preferensi bahasa Inggris jika nama tersebut ada. Contoh nilai kolom: |
region_code |
Wajib. Kode wilayah CLDR untuk wilayah tempat permintaan berasal. Contoh nilai kolom: |
sdk_version |
Versi SDK panggilan, jika berlaku. Format versinya adalah "major.minor.patch", contoh: |
os_version |
Versi sistem operasi tempat SDK panggilan berjalan. Contoh nilai kolom: |
device_model |
Model perangkat tempat SDK panggilan berjalan. Contoh nilai kolom: |
sdk_type |
Jenis SDK yang mengirim permintaan. |
maps_sdk_version |
Versi MapSDK yang diandalkan SDK panggilan, jika ada. Format versinya adalah "major.minor.patch", contoh: |
nav_sdk_version |
Versi NavSDK yang diandalkan SDK panggilan, jika ada. Format versinya adalah "major.minor.patch", contoh: |
platform |
Platform SDK panggilan. |
manufacturer |
Produsen perangkat Android dari SDK panggilan, hanya berlaku untuk Android SDK. Contoh nilai kolom: |
android_api_level |
Level API Android SDK panggilan, hanya berlaku untuk Android SDK. Contoh nilai kolom: |
trace_id |
ID opsional yang dapat diberikan untuk tujuan logging guna mengidentifikasi permintaan. |
Platform
Platform SDK panggilan.
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
Nilai default. Nilai ini digunakan jika platform dihilangkan. |
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 dihilangkan. |
CONSUMER |
SDK panggilan adalah Konsumen. |
DRIVER |
SDK panggilan adalah Driver. |
JAVASCRIPT |
SDK panggilan adalah JavaScript. |
DeliveryVehicle
Pesan DeliveryVehicle
. Kendaraan pengiriman mengangkut pengiriman dari depot ke lokasi pengiriman, dan dari lokasi pengambilan ke depot. Dalam beberapa kasus, kendaraan pengiriman juga mengangkut pengiriman 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 |
Nama unik Kendaraan Pengiriman ini. Formatnya adalah |
last_location |
Lokasi Kendaraan Pengiriman yang terakhir dilaporkan. |
navigation_status |
Status navigasi Kendaraan Pengiriman. |
current_route_segment |
Polyline yang dienkodekan yang menentukan rute yang direkomendasikan navigasi untuk diambil ke titik jalan berikutnya. Aplikasi pengemudi akan mengupdate ini saat perhentian tercapai atau dilewati, dan saat navigasi diubah. Ada beberapa kasus yang membuat kolom ini mungkin tidak digunakan untuk mengisi
Dalam kasus ini, Fleet Engine mengisi kolom ini dengan rute dari VehicleStop yang terakhir diteruskan ke VehicleStop yang akan datang untuk memastikan konsumen kolom ini memiliki informasi terbaik yang tersedia tentang jalur Delivery Vehicle saat ini. |
current_route_segment_end_point |
Lokasi tempat Kolom ini diabaikan dalam panggilan |
remaining_distance_meters |
Sisa jarak mengemudi untuk Fleet Engine mengabaikan kolom ini di |
remaining_duration |
Sisa waktu mengemudi untuk Fleet Engine mengabaikan kolom ini di |
remaining_vehicle_journey_segments[] |
Segmen perjalanan yang ditetapkan untuk Kendaraan Pengiriman ini, dimulai dari lokasi Kendaraan yang terakhir dilaporkan. Kolom ini tidak akan diisi sebagai respons dari |
attributes[] |
Daftar atribut Kendaraan Pengiriman khusus. Kendaraan Pengiriman dapat memiliki maksimal 100 atribut, dan setiap atribut harus memiliki kunci unik. |
type |
Jenis kendaraan pengiriman ini. Jika tidak disetel, setelan ini akan ditetapkan secara default ke |
DeliveryVehicleType
Jenis kendaraan pengiriman.
Enum | |
---|---|
DELIVERY_VEHICLE_TYPE_UNSPECIFIED |
Nilainya tidak digunakan. |
AUTO |
Sebuah mobil. |
TWO_WHEELER |
Sepeda motor, moped, atau kendaraan roda dua lainnya |
BICYCLE |
Transportasi bertenaga manusia. |
PEDESTRIAN |
Transportasi manusia, biasanya berjalan atau berlari, yang bepergian di sepanjang jalur pejalan kaki. |
DeliveryVehicleAttribute
Menjelaskan atribut kendaraan sebagai pasangan nilai kunci. Panjang string "key:value" tidak boleh lebih dari 256 karakter.
Kolom | |
---|---|
key |
Kunci atribut. |
value |
Nilai atribut. |
Kolom union delivery_vehicle_attribute_value . Nilai atribut, dapat berupa string, bool, atau jenis ganda. delivery_vehicle_attribute_value hanya ada berupa salah satu diantara berikut: |
|
string_value |
Nilai atribut dengan jenis string. Catatan: Kolom ini sama dengan kolom |
bool_value |
Nilai atribut dengan jenis Boolean. |
number_value |
Nilai atribut diketik ganda. |
DeliveryVehicleLocation
Lokasi, kecepatan, dan arah tujuan kendaraan pada waktu tertentu.
Kolom | |
---|---|
location |
Lokasi kendaraan. Saat dikirim ke Fleet Engine, lokasi kendaraan adalah lokasi GPS. Jika Anda menerimanya, lokasi kendaraan dapat berupa lokasi GPS, lokasi tambahan, atau perkiraan lokasi lainnya. Sumber ditentukan dalam |
horizontal_accuracy |
Tidak digunakan lagi: Sebagai gantinya, gunakan |
latlng_accuracy |
Akurasi |
heading |
Arah laju kendaraan dalam derajat. 0 mewakili Utara. Rentang yang valid adalah [0.360). |
bearing_accuracy |
Tidak digunakan lagi: Sebagai gantinya, gunakan |
heading_accuracy |
Akurasi |
altitude |
Ketinggian dalam meter di atas WGS84. |
vertical_accuracy |
Tidak digunakan lagi: Sebagai gantinya, gunakan |
altitude_accuracy |
Akurasi |
speed_kmph |
Kecepatan kendaraan dalam kilometer per jam. Tidak digunakan lagi: Sebagai gantinya, gunakan |
speed |
Kecepatan kendaraan dalam meter/detik |
speed_accuracy |
Akurasi |
update_time |
Waktu saat |
server_time |
Hanya output. Waktu saat server menerima informasi lokasi. |
location_sensor |
Penyedia data lokasi (misalnya, |
is_road_snapped |
Apakah |
is_gps_sensor_enabled |
Hanya input. Menunjukkan apakah sensor GPS diaktifkan di perangkat seluler. |
time_since_update |
Hanya input. Waktu (dalam detik) sejak lokasi ini pertama kali dikirim ke server. Ini akan nol untuk pembaruan pertama. Jika waktu tidak diketahui (misalnya, saat aplikasi dimulai ulang), nilai ini direset ke nol. |
num_stale_updates |
Hanya input. Tidak digunakan lagi: Sinyal lain kini digunakan untuk menentukan apakah lokasi sudah tidak berlaku. |
raw_location |
Lokasi kendaraan mentah (tidak diproses oleh kakap jalan). |
raw_location_time |
Stempel waktu yang terkait dengan lokasi mentah. |
raw_location_sensor |
Sumber lokasi mentah. Default-nya adalah |
raw_location_accuracy |
Akurasi |
supplemental_location |
Lokasi tambahan yang disediakan oleh aplikasi yang mengintegrasikan. |
supplemental_location_time |
Stempel waktu yang terkait dengan lokasi tambahan. |
supplemental_location_sensor |
Sumber lokasi tambahan. Default-nya adalah |
supplemental_location_accuracy |
Akurasi |
road_snapped |
Tidak digunakan lagi: Sebagai gantinya, gunakan |
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 berbantuan, ID menara BTS, atau titik akses WiFi. |
PASSIVE |
ID menara BTS atau titik akses WiFi. |
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 diberikan 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 sebagai CUSTOMER_SuPLIED_LOCATION biasanya disediakan melalui last_location.supplemental_location_sensor Delivery Vehicle. |
FLEET_ENGINE_LOCATION |
Lokasi yang dihitung oleh Fleet Engine berdasarkan sinyal yang tersedia untuk lokasi tersebut. Hanya output. Nilai ini akan ditolak jika diterima dalam permintaan. |
FUSED_LOCATION_PROVIDER |
Penyedia Lokasi Gabungan Android. |
CORE_LOCATION |
Penyedia lokasi di sistem operasi Apple. |
GetDeliveryVehicleRequest
Pesan permintaan GetDeliveryVehicle
.
Kolom | |
---|---|
header |
Opsional. Header permintaan Delivery API standar. |
name |
Wajib. Harus dalam format |
GetTaskRequest
Pesan permintaan GetTask
.
Kolom | |
---|---|
header |
Opsional. Header permintaan Delivery API standar. |
name |
Wajib. Harus dalam format |
GetTaskTrackingInfoRequest
Pesan permintaan GetTaskTrackingInfoRequest
.
Kolom | |
---|---|
header |
Opsional. Header permintaan Delivery API standar. |
name |
Wajib. Harus dalam format |
ListDeliveryVehiclesRequest
Pesan permintaan ListDeliveryVehicles
.
Kolom | |
---|---|
header |
Opsional. Header permintaan Delivery API standar. |
parent |
Wajib. Harus dalam format |
page_size |
Opsional. Jumlah maksimum kendaraan untuk dikembalikan. Layanan mungkin menampilkan lebih sedikit dari jumlah ini. Jika Anda tidak menentukan angka ini, server akan menentukan jumlah hasil yang akan ditampilkan. |
page_token |
Opsional. Token halaman, diterima dari panggilan Saat melakukan penomoran halaman, semua parameter lain yang disediakan ke |
filter |
Opsional. Kueri filter yang akan diterapkan saat mencantumkan kendaraan pengiriman. Buka http://aip.dev/160 untuk mengetahui 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 Jumlah maksimum batasan yang diizinkan dalam kueri filter adalah 50. Batasan adalah bagian dari kueri dalam bentuk |
viewport |
Opsional. Filter yang membatasi kendaraan yang ditampilkan ke kendaraan yang lokasi terakhirnya diketahui berada di area persegi panjang yang ditentukan oleh area pandang. |
ListDeliveryVehiclesResponse
Pesan respons ListDeliveryVehicles
.
Kolom | |
---|---|
delivery_vehicles[] |
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 boleh kosong. Respons kosong menunjukkan bahwa tidak ada kendaraan pengiriman yang memenuhi kriteria filter yang diminta. |
next_page_token |
Anda dapat meneruskan token ini di |
total_size |
Jumlah total kendaraan pengiriman yang cocok dengan kriteria permintaan, di semua halaman. |
ListTasksRequest
Pesan permintaan ListTasks
.
Kolom | |
---|---|
header |
Opsional. Header permintaan Delivery API standar. |
parent |
Wajib. Harus dalam format |
page_size |
Opsional. Jumlah maksimum Tasks 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 |
Opsional. Token halaman diterima dari panggilan Saat melakukan penomoran halaman, semua parameter lain yang disediakan ke |
filter |
Opsional. Kueri filter yang akan diterapkan saat mencantumkan Tasks. Buka http://aip.dev/160 untuk mengetahui contoh sintaksis filter. Jika Anda tidak menentukan nilai, atau jika Anda memfilter pada string kosong, semua Tugas akan ditampilkan. Untuk mengetahui informasi tentang properti Tugas yang dapat Anda filter, lihat Membuat daftar tugas. |
ListTasksResponse
Respons ListTasks
yang berisi kumpulan Tasks yang memenuhi kriteria filter di ListTasksRequest
.
Kolom | |
---|---|
tasks[] |
Kumpulan Tugas yang memenuhi kriteria pemfilteran yang diminta. Jika tidak ada filter yang ditentukan, permintaan akan menampilkan semua tugas. Respons yang berhasil juga boleh kosong. Respons kosong menunjukkan bahwa tidak ditemukan Tasks yang memenuhi kriteria filter yang diminta. |
next_page_token |
Teruskan token ini di |
total_size |
Jumlah total Tasks yang cocok dengan kriteria permintaan, di semua halaman. |
LocationInfo
Lokasi dengan ID tambahan.
Kolom | |
---|---|
point |
Koordinat lokasi. |
Tugas
Tugas di Delivery API mewakili satu tindakan untuk dilacak. Secara umum, ada perbedaan antara Tasks terkait pengiriman dan Tasks. Sebuah pengiriman dapat memiliki beberapa Tugas yang terkait dengannya. Misalnya, mungkin ada satu Tugas untuk pengambilan, dan satu untuk pengantaran atau transfer. Selain itu, Tugas yang berbeda untuk pengiriman tertentu dapat ditangani oleh kendaraan yang berbeda. Misalnya, satu kendaraan dapat menangani pengambilan, mengarahkan pengiriman ke hub, sementara kendaraan lain menjalankan pengiriman 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 |
Harus dalam format |
type |
Wajib. Tidak dapat diubah. Mendefinisikan jenis Tugas. Misalnya, jeda atau pengiriman. |
state |
Wajib. Status eksekusi Tugas saat ini. |
task_outcome |
Hasil dari Tugas. |
task_outcome_time |
Stempel waktu yang menunjukkan kapan hasil |
task_outcome_location |
Lokasi tempat hasil |
task_outcome_location_source |
Menunjukkan asal nilai |
tracking_id |
Tidak dapat diubah. Kolom ini memfasilitasi penyimpanan ID sehingga Anda dapat menghindari penggunaan pemetaan yang rumit. Anda tidak dapat menetapkan
|
delivery_vehicle_id |
Hanya output. ID kendaraan yang menjalankan Tugas ini. ID Kendaraan Pengiriman tunduk pada batasan berikut:
|
planned_location |
Tidak dapat diubah. Lokasi tempat Tugas akan diselesaikan. Opsional untuk Tasks |
task_duration |
Wajib. Tidak dapat diubah. Waktu yang diperlukan untuk menjalankan Tugas di lokasi ini. |
target_time_window |
Periode waktu saat tugas harus diselesaikan. |
journey_sharing_info |
Hanya output. Kolom khusus berbagi perjalanan. Tidak diisi saat status adalah |
task_tracking_view_config |
Konfigurasi untuk pelacakan tugas yang menentukan elemen data mana yang terlihat oleh pengguna akhir dalam keadaan apa. |
attributes[] |
Daftar atribut Task kustom. Setiap atribut harus memiliki kunci unik. |
JourneySharingInfo
Berbagi perjalanan dengan kolom khusus.
Kolom | |
---|---|
remaining_vehicle_journey_segments[] |
Informasi pelacakan perhentian yang akan dibuat oleh kendaraan yang ditugaskan sebelum menyelesaikan Tugas ini. Perhatikan bahwa daftar ini dapat berisi perhentian dari tugas lain. Segmen pertama, |
last_location |
Menunjukkan lokasi terakhir kendaraan yang dilaporkan untuk kendaraan yang ditetapkan. |
last_location_snappable |
Menunjukkan apakah lastLocation kendaraan dapat diikat ke |
Negara Bagian
Status Tugas. Status ini menunjukkan progres Tasks.
Enum | |
---|---|
STATE_UNSPECIFIED |
Default. Digunakan untuk status Tugas yang tidak ditentukan atau tidak dikenal. |
OPEN |
Tugas belum ditetapkan ke kendaraan pengiriman, atau kendaraan pengiriman belum melewati perhentian kendaraan yang ditetapkan Task . |
CLOSED |
Saat kendaraan melewati perhentian kendaraan untuk Tugas ini. |
TaskOutcome
Hasil dari percobaan untuk menjalankan Tugas. Ketika TaskState
ditutup, TaskOutcome
akan menunjukkan apakah penutupan berhasil dilakukan.
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 kendaraan yang terakhir diketahui. |
Jenis
Jenis Tugas.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Defaultnya, Jenis tugas tidak diketahui. |
PICKUP |
Tugas pengambilan adalah tindakan yang diambil untuk mengambil kiriman dari pelanggan. Pengambilan kendaraan di depot atau pengumpan harus menggunakan jenis SCHEDULED_STOP . |
DELIVERY |
Tugas pengiriman adalah tindakan yang diambil untuk mengirimkan pesanan ke pelanggan akhir. Penurunan kendaraan di depot atau pengumpan harus menggunakan jenis SCHEDULED_STOP . |
SCHEDULED_STOP |
Tugas perhentian terjadwal digunakan untuk tujuan perencanaan. Misalnya, hal ini bisa berupa pengambilan atau pengantaran kiriman dari kendaraan atau depot pemasok. Nomor ini tidak boleh digunakan untuk pengiriman apa pun yang diambil atau diantarkan dari pelanggan akhir. |
UNAVAILABLE |
Tugas yang berarti Kendaraan tidak tersedia untuk diperbaiki. Misalnya, hal ini dapat terjadi saat pengemudi istirahat, atau saat kendaraan sedang mengisi bahan bakar. |
TaskAttribute
Menjelaskan atribut tugas sebagai pasangan nilai kunci. Panjang string "key:value" tidak boleh lebih dari 256 karakter.
Kolom | |
---|---|
key |
Kunci atribut. Kunci tidak boleh berisi karakter titik dua (:). |
Kolom union task_attribute_value . Nilai atribut, dapat berupa string, bool, atau jenis ganda. Jika tidak ada yang ditetapkan, string_value TaskAttribute akan disimpan sebagai string kosong "". task_attribute_value hanya dapat berupa salah satu dari yang berikut: |
|
string_value |
Nilai atribut dengan jenis string. |
bool_value |
Nilai atribut dengan jenis Boolean. |
number_value |
Nilai atribut diketik ganda. |
TaskTrackingInfo
Pesan TaskTrackingInfo
. Pesan ini berisi informasi pelacakan tugas yang akan digunakan untuk ditampilkan. Jika ID pelacakan dikaitkan dengan beberapa Tasks, Fleet Engine akan menggunakan heuristik untuk menentukan TaskTrackingInfo Tugas yang akan dipilih.
Kolom | |
---|---|
name |
Harus dalam format |
tracking_id |
Tidak dapat diubah. ID pelacakan Tugas. * Harus berupa string Unicode yang valid. * Dibatasi hingga panjang maksimum 64 karakter. * Dinormalkan menurut Formulir Normalisasi Unicode C. * Tidak boleh berisi karakter ASCII berikut: '/', ':', '?', ',', atau '#'. |
vehicle_location |
Lokasi terakhir kendaraan. |
route_polyline_points[] |
Daftar titik yang, jika dihubungkan, membentuk polyline rute yang diharapkan dari kendaraan ke lokasi tugas ini. |
remaining_stop_count |
Menunjukkan jumlah perhentian kendaraan yang tersisa hingga perhentian tugas tercapai, termasuk perhentian tugas. Misalnya, jika perhentian berikutnya kendaraan adalah perhentian tugas, nilainya akan menjadi 1. |
remaining_driving_distance_meters |
Total jarak yang tersisa dalam meter ke |
estimated_arrival_time |
Stempel waktu yang menunjukkan perkiraan waktu kedatangan ke lokasi perhentian. |
estimated_task_completion_time |
Stempel waktu yang menunjukkan perkiraan waktu penyelesaian Tugas. |
state |
Status eksekusi Tugas saat ini. |
task_outcome |
Hasil dari percobaan untuk menjalankan Tugas. |
task_outcome_time |
Stempel waktu yang menunjukkan kapan hasil Tugas ditetapkan oleh penyedia. |
planned_location |
Tidak dapat diubah. Lokasi tempat Tugas akan diselesaikan. |
target_time_window |
Periode waktu saat tugas harus diselesaikan. |
attributes[] |
Atribut kustom yang ditetapkan pada tugas. |
TaskTrackingViewConfig
Pesan konfigurasi yang menentukan kapan elemen data Tugas harus terlihat oleh pengguna akhir.
Kolom | |
---|---|
route_polyline_points_visibility |
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 |
Kolom yang menentukan kapan perkiraan waktu kedatangan dapat dilihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan. |
estimated_task_completion_time_visibility |
Kolom yang menentukan kapan perkiraan waktu penyelesaian tugas dapat dilihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan. |
remaining_driving_distance_visibility |
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 |
Kolom yang menentukan kapan jumlah perhentian tersisa dapat terlihat. Jika kolom ini tidak ditentukan, konfigurasi visibilitas default tingkat project untuk data ini akan digunakan. |
vehicle_location_visibility |
Kolom yang menentukan kapan lokasi kendaraan dapat dilihat. 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 telah dipilih. visibility_option hanya ada berupa salah satu diantara berikut: |
|
remaining_stop_count_threshold |
Elemen data ini dapat dilihat oleh pengguna akhir jika jumlah perhentian yang tersisa <= remaining_stop_count_threshold. |
duration_until_estimated_arrival_time_threshold |
Elemen data ini terlihat oleh pengguna akhir jika PWT ke perhentian <= duration_until_Estimated_arrival_time_threshold. |
remaining_driving_distance_meters_threshold |
Elemen data ini dapat dilihat oleh pengguna akhir jika jarak mengemudi yang tersisa dalam meter <= rest_driving_distance_meters_threshold. |
always |
Jika ditetapkan ke true, elemen data ini akan selalu terlihat oleh pengguna akhir tanpa nilai minimum. Kolom ini tidak boleh ditetapkan ke false. |
never |
Jika ditetapkan ke true, elemen data ini akan selalu disembunyikan dari pengguna akhir tanpa nilai minimum. Kolom ini tidak boleh ditetapkan ke false. |
TimeWindow
Rentang waktu.
Kolom | |
---|---|
start_time |
Wajib. Waktu mulai dari jangka waktu (inklusif). |
end_time |
Wajib. Waktu berakhir dari jangka waktu (inklusif). |
UpdateDeliveryVehicleRequest
Pesan permintaan UpdateDeliveryVehicle
.
Kolom | |
---|---|
header |
Opsional. Header permintaan Delivery API standar. |
delivery_vehicle |
Wajib. Pembaruan entitas |
update_mask |
Wajib. Mask kolom yang menunjukkan kolom Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: |
UpdateTaskRequest
Pesan permintaan UpdateTask
.
Kolom | |
---|---|
header |
Opsional. Header permintaan Delivery API standar. |
task |
Wajib. Tugas yang terkait dengan update. Kolom berikut dikelola oleh Fleet Engine. Jangan memperbaruinya menggunakan
Catatan: Anda tidak dapat mengubah nilai Jika Tugas telah ditetapkan ke kendaraan pengiriman, jangan tetapkan status Tugas ke DITUTUP menggunakan |
update_mask |
Wajib. Mask kolom yang menunjukkan kolom Tugas yang akan diperbarui. Catatan: Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: |
VehicleJourneySegment
Mewakili segmen perjalanan Kendaraan - dari perhentian sebelumnya hingga perhentian saat ini. Jika perhentian ini adalah perhentian aktif pertama, berarti perhentian tersebut berasal dari lokasi Kendaraan saat ini ke perhentian ini.
Kolom | |
---|---|
stop |
Menentukan lokasi perhentian, beserta |
driving_distance_meters |
Hanya output. Jarak perjalanan dari perhentian sebelumnya ke perhentian ini. Jika perhentian saat ini adalah perhentian pertama dalam daftar segmen perjalanan, maka titik awal adalah lokasi kendaraan yang dicatat pada saat perhentian ini ditambahkan ke daftar. Kolom ini mungkin tidak ada jika segmen perjalanan ini merupakan bagian dari |
driving_duration |
Hanya output. Waktu perjalanan dari perhentian sebelumnya ke perhentian ini. Jika perhentian saat ini adalah perhentian pertama dalam daftar segmen perjalanan, maka titik awal adalah lokasi Kendaraan yang tercatat pada saat perhentian ini ditambahkan ke daftar. Jika kolom ini ditentukan di jalur |
path[] |
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 Jika kolom ini ditentukan di jalur |
VehicleStop
Menjelaskan titik tempat Kendaraan berhenti untuk melakukan satu atau beberapa Task
.
Kolom | |
---|---|
planned_location |
Wajib. Lokasi perhentian. Perhatikan bahwa lokasi di |
tasks[] |
Daftar |
state |
Status |
Negara Bagian
Status VehicleStop
saat ini.
Enum | |
---|---|
STATE_UNSPECIFIED |
Tidak diketahui. |
NEW |
Dibuat, tetapi tidak secara aktif mengarahkan. |
ENROUTE |
Perutean yang ditetapkan dan aktif. |
ARRIVED |
Tiba di perhentian. Mengasumsikan bahwa saat Kendaraan melaju ke perhentian berikutnya, semua perhentian sebelumnya telah selesai. |
TaskInfo
Informasi tambahan tentang Tugas yang dilakukan di perhentian ini.
Kolom | |
---|---|
task_id |
ID Tugas. Kolom ini tidak akan diisi sebagai respons dari panggilan
|
task_duration |
Hanya output. Waktu yang diperlukan untuk melakukan Tugas. |
target_time_window |
Hanya output. Periode waktu saat tugas harus diselesaikan. Ini hanya ditetapkan sebagai respons terhadap |