Pengantar: Membuat kendaraan

Untuk informasi umum tentang cara kerja kendaraan di Fleet Engine, lihat panduan berikut di bagian dasar-dasar 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 Engine Armada Anda juga harus sesuai dengan kendaraan yang digunakan di sistem backend yang Anda gunakan untuk penetapan dan pemilihan rute kendaraan.

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

Perjalanan on-demand

Tugas terjadwal

Permintaan kendaraan

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

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

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

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

Informasi dalam isi permintaan bervariasi sesuai dengan sifat permintaan. Lihat detail tersebut di bagian 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:

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 metode lain dan tidak dapat ditetapkan secara langsung. Kolom penting dari jenis ini adalah kolom name. Fleet Engine mengabaikan nilai apa pun 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 diisi. 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 diperlukan.
  • Kolom opsional. Kedua layanan tersebut memiliki kolom yang dapat Anda tetapkan saat pembuatan atau setelahnya. Informasi 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 project ID 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 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 entitas unik

Format dan nilai ID entitas 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 itinerari tertentu, kendaraan tersebut 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 pada saat itulah hitung mundur 7 hari dimulai lagi.

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

CATATAN: Beberapa kolom pada entitas Vehicle seperti device_settings adalah informasi debug murni yang tidak dipertahankan oleh Fleet Engine. Memperbaruinya tidak akan memperpanjang masa pakai entity Vehicle.

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

Langkah berikutnya