Pengantar: Membuat kendaraan

Untuk informasi umum tentang cara kerja kendaraan di Fleet Engine, lihat panduan berikut di bagian penting Fleet Engine:

Dokumentasi di bagian ini menjelaskan cara membuat dan mengelola kendaraan di Fleet Engine. Anda membuat kendaraan di lingkungan server Fleet Engine untuk mencerminkan kendaraan sebenarnya dalam operasi dunia nyata Anda. Kendaraan Fleet Engine Anda juga harus sesuai dengan kendaraan yang digunakan dalam sistem backend yang Anda gunakan untuk penugasan dan perutean kendaraan.

Anda menggunakan metode pembuatan untuk membuat resource kendaraan, baik menggunakan gRPC maupun REST. Nama kolom dalam panduan ini menggunakan notasi gRPC untuk mempermudah.

Perjalanan on-demand

Tugas terjadwal

Permintaan kendaraan

Untuk kemampuan tugas on-demand dan terjadwal, Anda membuat dan memperbarui kendaraan dengan mengirimkan pesan permintaan dengan kolom, yang diringkas sebagai berikut:

  1. Parent: string yang terkait dengan ID project Google Cloud Anda, yang digunakan untuk mengisi kolom nama instance kendaraan.

  2. ID untuk kendaraan: string unik yang digunakan untuk mengisi name kolom kendaraan.

  3. Instance kendaraan dengan kolom wajibnya. Kolom ini bergantung pada kemampuan Fleet Engine yang Anda gunakan.

Informasi dalam isi permintaan bervariasi sesuai dengan sifat permintaan. Lihat detail tersebut di panduan masing-masing.

Token autentikasi dan otorisasi

Permintaan ke Fleet Engine juga harus memberikan kredensial akses yang benar. Contoh dalam panduan ini memiliki asumsi berikut:

  • Contoh gRPC mengasumsikan penggunaan library Otorisasi untuk Java.
  • Contoh REST mengilustrasikan header permintaan HTTP, yang harus berisi kolom Authorization dengan nilai Bearer <token> dengan <token> adalah JSON Web Token yang Anda terbitkan.

Untuk mengetahui detail selengkapnya, lihat panduan Menyiapkan Fleet Engine.

Kolom resource kendaraan

Resource kendaraan memiliki jenis kolom berikut:

  • Kolom hanya output. Kolom yang ditetapkan oleh layanan sebagai output dari metode lain dan tidak dapat ditetapkan secara langsung. Kolom penting dari jenis ini adalah kolom name. Fleet Engine mengabaikan nilai yang diberikan untuk kolom name kendaraan sesuai panduan dari Google AIP untuk ID yang ditentukan pengguna. Jika Anda memberikan nilai untuk kolom ini, Fleet Engine akan menampilkan error.
  • Kolom wajib. Kendaraan yang dibuat di layanan perjalanan on-demand mengharuskan kolom tertentu ditetapkan saat pembuatan. Kendaraan yang dibuat di layanan tugas terjadwal tidak memiliki kolom resource kendaraan yang wajib diisi.
  • Kolom opsional. Kedua layanan memiliki kolom yang dapat Anda tetapkan saat pembuatan atau setelahnya. Kolom ini dapat ditemukan di panduan referensi masing-masing untuk layanan yang Anda gunakan.

Nama kendaraan (hanya output)

Kolom name sama persis untuk perjalanan on-demand dan layanan tugas terjadwal. Fleet Engine menentukan kolom saat Anda membuat kendaraan, berdasarkan dua kolom yang Anda tetapkan saat pembuatan kendaraan:

  • Induk: string yang terkait dengan ID project Google Cloud Anda dalam bentuk providers/{provider} dengan {provider} adalah ID project Cloud Anda. Setiap kendaraan yang Anda buat untuk project tertentu akan memiliki jalur induk yang sama.

    Project Cloud yang Anda referensikan di sini juga harus berisi peran akun layanan Fleet Engine untuk layanan yang Anda gunakan. Lihat Akun Layanan untuk mengetahui daftar akun layanan tersebut. Fleet Engine tidak mendukung akses dari beberapa project Google Cloud.

  • ID untuk kendaraan, yang harus unik di semua kendaraan dalam armada Anda dan merupakan string Unicode yang valid. Ini adalah ID resource untuk kendaraan. Perjalanan on-demand dan perhentian terjadwal menggunakan ID ini untuk mengaitkan perjalanan atau tugas dengan kendaraan yang menyelesaikannya.

Di layanan berbasis Google Cloud, semua API harus merepresentasikan resource sebagai string. Lihat Penamaan resource di Fleet Engine untuk mengetahui detail selengkapnya.

ID entity unik

Format dan nilai ID entity unik yang digunakan dalam panggilan resource bersifat buram untuk Fleet Engine. Pastikan ID tidak berisi informasi identitas pribadi (PII) apa pun, seperti nomor telepon pengemudi.

Penggunaan kembali kendaraan

Setelah kendaraan menyelesaikan semua perhentian untuk rencana perjalanan tertentu, kendaraan tersebut akan tetap tersedia untuk digunakan kembali di Fleet Engine selama 7 hari, yang berarti Anda dapat menggunakan kembali kendaraan pada hari kerja berikutnya tanpa harus membuat kendaraan baru. Setiap kali Anda menggunakan kembali kendaraan, Fleet Engine akan mereset ketersediaannya, dan penghitungan mundur 7 hari akan dimulai lagi.

Pendekatan yang direkomendasikan untuk membuat kendaraan tetap tersedia di Fleet Engine adalah memperbarui lokasinya secara berkala. Pembaruan pada sebagian besar kolom lain di entity Vehicle juga akan memperpanjang masa pakainya, asalkan nilai kolom baru berbeda dengan nilai yang ada.

CATATAN: Beberapa kolom di entity Vehicle seperti device_settings hanyalah informasi debug yang tidak dipertahankan oleh Fleet Engine. Memperbaruinya tidak akan memperpanjang masa pakai entity Vehicle.

Untuk meningkatkan analisis sistem, sebaiknya gunakan kembali pasangan ID pengemudi-kendaraan yang sama dari hari ke hari. Lakukan hal ini dengan menggunakan ID kendaraan yang sama yang terkait dengan pengemudi untuk perhentian terjadwal atau perjalanan on-demand sebelumnya.

Langkah berikutnya