Dokumen ini mencakup kolom kendaraan penting yang dapat Anda saat membuat dan mengelola kendaraan.
|
Untuk mengetahui daftar lengkap kolom kendaraan, lihat:
|
Kolom status kendaraan
Sistem Anda dapat menyetel status kendaraan ke OFFLINE
atau ONLINE
. Misalnya, Anda
dapat menetapkan status kendaraan ke ONLINE
setiap hari pukul 09.00 dan OFFLINE
setiap hari
pukul 17.00.
Mode OFFLINE | Mode ONLINE |
---|---|
Gunakan OFFLINE untuk menunjukkan bahwa kendaraan tidak menerima
perjalanan baru. Perhatikan bahwa kendaraan masih dapat menyelesaikan perjalanan yang ditetapkan saat
status ini. |
|
Kolom atribut kendaraan
Gunakan kolom attributes
kendaraan untuk membuat kriteria yang disesuaikan guna memungkinkan
konsumen atau operator armada untuk menemukan kendaraan
di armada Anda di tempat yang lebih luas
beragam kriteria pencarian. Tindakan ini akan meningkatkan kemampuan aplikasi Anda untuk
memberikan kecocokan kendaraan yang lebih baik dibandingkan dengan yang Anda inginkan dari menggunakan kriteria penelusuran
hanya berdasarkan kolom kendaraan lainnya. Setiap kendaraan dapat memiliki maksimal 100 atribut, dan setiap atribut harus memiliki kunci unik. Nilai dapat berupa string,
boolean, atau angka.
Misalnya, Anda dapat mendeklarasikan atribut khusus yang disebut class untuk
membedakan kendaraan {i>rideshare<i} Anda
di berbagai tingkat kelas. Anda akan menggunakan
nilai string berikut untuk mewakili tingkat kelas kendaraan: ECONOMY
,
STANDARD
, dan LUXURY
.
Namun, nilai atribut khusus tidak harus saling eksklusif. Anda mungkin menggunakan kriteria seperti cocok untuk hewan peliharaan, tidak merokok, dan dapat menghabiskan waktu lebih lama perjalanan. Masing-masing dapat menjadi atribut khusus terpisah yang menggunakan boolean masing-masing. Kendaraan yang diberikan dapat diberi ketiga atribut khusus ini bersama dengan atribut khusus class yang disetel ke nilai string yang sesuai.
Dengan menggunakan atribut dengan cara ini, Anda dapat memperoleh berbagai fitur yang berguna untuk menemukan kendaraan untuk perjalanan dengan kebutuhan tertentu. Untuk mendapatkan petunjuk cara Untuk menggunakan atribut khusus sebagai filter kueri, lihat artikel Menelusuri kendaraan.
Perbarui atribut kendaraan
Anda dapat memperbarui atribut kendaraan menggunakan UpdateVehicle
atau
UpdateVehicleAttributes
. Setiap kunci attributes
hanya dapat memiliki satu nilai per
kendaraan. Anda mendeklarasikan atribut kendaraan khusus menggunakan attributes
pada mask kolom, lalu memberikan nilai berdasarkan metode di bawah ini.
UpdateVehicle |
UpdateVehicleAttributes |
|
---|---|---|
API ini tidak mengizinkan update satu atribut saja. Saat menggunakan
metode ini, setiap penggunaan attributes
di mask kolom menghasilkan seluruh set
atribut kendaraan yang
dideklarasikan ulang untuk kendaraan tersebut. Hal ini menghasilkan
menimpa atribut yang sudah ada sebelumnya dan tidak disertakan secara eksplisit dalam
mask kolom. Jika menggunakan metode ini untuk mendeklarasikan atribut kustom baru,
Anda juga harus mendeklarasikan ulang setiap atribut kustom yang ingin disimpan
kendaraan. Jika Anda mengecualikan attributes dalam mask kolom,
metode ini membiarkan atribut khusus yang ada seperti yang ditentukan sebelumnya
untuk kendaraan. Jika Anda menggunakan attributes di mask kolom,
tetapi tanpa menetapkan nilai, tindakan tersebut setara dengan menghapus semua atribut
kustom dari kendaraan.
|
Metode ini menerima daftar atribut tertentu untuk memperbarui. Permintaan hanya memperbarui atau menambahkan atribut yang ditentukan dalam mask kolom. Atribut yang sudah ada sebelumnya dan tidak ditentukan tetap tidak diubah. |
Perbarui contoh kolom kendaraan
Bagian ini menunjukkan cara memperbarui kolom kendaraan menggunakan UpdateVehicleRequest
,
yang menyertakan update_mask
untuk menunjukkan kolom yang akan diperbarui. Lihat
Dokumentasi Buffering Protokol tentang mask kolom untuk mengetahui detailnya.
Pembaruan pada kolom selain last_location
memerlukan hak istimewa Admin On-demand
Fleet Engine.
Contoh: mengaktifkan jenis perjalanan baru dan atribut kustom
Contoh ini memungkinkan perjalanan back_to_back
untuk kendaraan dan juga menentukan
atribut baru: class
. Seperti yang disebutkan di Memperbarui atribut kendaraan sebelumnya,
memperbarui kolom attributes
menggunakan pendekatan ini mengharuskan Anda menunjukkan semua
atribut kustom yang ingin dipertahankan. Oleh karena itu, contoh ini menunjukkan cash_only
yang ditulis agar tidak ditimpa selama operasi update
yang menentukan kolom attributes
.
Untuk memperbarui nilai dari satu pasangan atribut nilai kunci saja, gunakan metode
Metode UpdateVehicleAttributes
sebagai gantinya dan tidak menyertakan kolom attribute
di mask kolom untuk permintaan UpdateVehicle
.
Lihat referensi providers.vehicles.update
untuk gRPC dan REST.
gRPC
static final String PROJECT_ID = "project-id";
static final String VEHICLE_ID = "vid-8241890";
VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);
String vehicleName = "providers/" + PROJECT_ID + "/vehicles/" + VEHICLE_ID;
Vehicle updatedVehicle = Vehicle.newBuilder()
.setVehicleState(VehicleState.ONLINE)
.addAllAttributes(ImmutableList.of(
VehicleAttribute.newBuilder().setKey("class").setValue("ECONOMY").build(),
VehicleAttribute.newBuilder().setKey("cash_only").setValue("false").build()))
.setBackToBackEnabled(true)
.build();
UpdateVehicleRequest updateVehicleRequest = UpdateVehicleRequest.newBuilder()
.setName(vehicleName)
.setVehicle(updatedVehicle)
.setUpdateMask(FieldMask.newBuilder()
.addPaths("vehicle_state")
.addPaths("attributes")
.addPaths("back_to_back_enabled"))
.build();
try {
Vehicle updatedVehicle =
vehicleService.updateVehicle(updateVehicleRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
// Most implementations will call CreateVehicle in this case
break;
case PERMISSION_DENIED:
break;
}
return;
}
// If no Exception, Vehicle updated successfully.
REST
curl -X PUT \
"https://fleetengine.googleapis.com/v1/providers/project-id/vehicles/vid-8241890?updateMask=vehicle_state,attributes,back_to_back_enabled" \
-H "Authorization: Bearer $JWT" \
-H "Content-Type: application/json" \
--data-binary @- << EOM
{
"vehicleState": "ONLINE",
"attributes": [
{"key": "class", "value": "LUXURY"},
{"key": "cash_only", "value": "false"}
],
"backToBackEnabled": true
}
EOM