Perbarui kolom kendaraan

Kolom status kendaraan

Sistem Anda dapat menetapkan status kendaraan ke OFFLINE atau ONLINE. Sebagai contoh, Anda mungkin menetapkan status kendaraan ke ONLINE setiap hari pada pukul 09.00 dan OFFLINE setiap hari pada pukul 17.00.

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. Hal ini meningkatkan kemampuan aplikasi Anda untuk memberikan pencocokan kendaraan yang lebih baik daripada yang Anda lakukan dengan menggunakan kriteria penelusuran yang hanya didasarkan pada kolom kendaraan lainnya. Setiap kendaraan dapat memiliki maksimal 100 atribut, dan setiap atribut harus memiliki kunci unik. Nilai-nilai bisa berupa {i>string<i}, boolean, atau angka.

Misalnya, Anda dapat mendeklarasikan atribut kustom yang disebut class untuk membedakan kendaraan transportasi online Anda di seluruh tingkat class. Anda akan menggunakan nilai string berikut untuk merepresentasikan tingkat kelas kendaraan: ECONOMY, STANDARD, dan LUXURY.

Namun, nilai atribut kustom tidak harus saling eksklusif. Anda dapat menggunakan kriteria seperti ramah hewan, tidak merokok, dan dapat melakukan perjalanan yang lebih lama. Masing-masing dapat berupa atribut kustom terpisah yang menggunakan nilai boolean. Kendaraan tertentu dapat diberi ketiga atribut kustom ini bersama dengan atribut kustom class yang ditetapkan ke nilai string yang sesuai.

Menggunakan atribut dengan cara ini dapat memberi Anda berbagai macam fitur yang berguna untuk mencari kendaraan untuk perjalanan dengan kebutuhan tertentu. Untuk petunjuk tentang cara menggunakan atribut kustom sebagai filter kueri, lihat 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 kustom menggunakan attributes di mask kolom, lalu memberikan nilai berdasarkan metode di bawah.

Contoh pembaruan 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 Fleet Engine On-demand Hak istimewa admin.

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 hanya memperbarui nilai satu pasangan atribut nilai kunci, gunakan metode UpdateVehicleAttributes dan jangan sertakan kolom attribute dalam mask kolom untuk permintaan UpdateVehicle.

Lihat referensi providers.vehicles.update untuk gRPC dan REST.

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.

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

Langkah berikutnya

• Memperbarui lokasi kendaraan