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 di dunia nyata. 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 agar lebih sederhana.

Perjalanan on-demand

Tugas terjadwal

Permintaan kendaraan

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

  1. Parent: string yang terkait dengan project ID Google Cloud Anda, 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 dalam 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 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 AIP Google 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 memiliki kolom yang dapat Anda tetapkan saat pembuatan atau setelahnya. Kunci ini dapat ditemukan di panduan referensi masing-masing untuk layanan yang Anda gunakan.

Nama kendaraan (hanya output)

Kolom name persis sama 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:

  • Parent: 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 seluruh kendaraan dalam armada Anda dan berupa 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 entitas unik

Format dan nilai ID entitas unik yang digunakan dalam panggilan resource tidak transparan bagi Fleet Engine. Pastikan ID tidak berisi informasi identitas pribadi (PII), 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 itu hitungan mundur 7 hari akan dimulai lagi.

Pendekatan yang direkomendasikan untuk menjaga ketersediaan kendaraan di Fleet Engine adalah memperbarui lokasinya secara berkala. Pembaruan pada sebagian besar kolom lainnya dalam entitas Vehicle juga akan memperpanjang masa pakainya, asalkan nilai kolom baru berbeda dari nilai yang ada.

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

Untuk analisis sistem yang lebih baik, 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 perjalanan terjadwal sebelumnya atau perjalanan sesuai permintaan.

Langkah berikutnya