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 yang sebenarnya dalam operasi Anda di dunia nyata. Mesin Fleet Anda kendaraan juga harus sesuai dengan yang digunakan dalam sistem backend yang Anda gunakan untuk penugasan dan penentuan rute kendaraan.

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

Perjalanan on-demand

Tugas terjadwal

Permintaan kendaraan

Untuk kemampuan tugas on-demand dan terjadwal, Anda membuat dan memperbarui kendaraan dengan mengeluarkan pesan permintaan beserta kolom, yang dirangkum 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 name lapangan kendaraan.

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

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

Token autentikasi dan otorisasi

Permintaan ke Fleet Engine juga harus menyediakan 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 output saja. Kolom yang ditetapkan oleh layanan sebagai output dari metode lain dan tidak dapat langsung ditetapkan. Bidang penting dari adalah kolom name. Fleet Engine mengabaikan nilai apa pun yang diberikan untuk name kolom kendaraan per panduan dari AIP Google untuk ditentukan pengguna ID. Jika Anda memberikan nilai untuk kolom ini, Fleet Engine menghasilkan {i>error<i}.
  • Kolom wajib diisi. Kendaraan yang dibuat dalam layanan perjalanan on demand memerlukan bahwa {i>field<i} tertentu harus diatur saat pembuatan. Kendaraan yang dibuat sesuai jadwal layanan tugas tidak memiliki kolom resource kendaraan yang diperlukan.
  • Kolom opsional. Kedua layanan ini memiliki kolom yang dapat Anda tetapkan saat pembuatan atau setelahnya. Referensi ini dapat ditemukan di panduan referensi terkait untuk layanan yang digunakan.

Nama kendaraan (khusus output)

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

  • Parent: string yang terkait dengan ID project Google Cloud Anda dari dari providers/{provider} dengan {provider} adalah ID Cloud Anda proyek. Setiap kendaraan yang Anda buat untuk project tertentu akan memiliki induk.

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

  • ID untuk kendaraan, yang harus unik di semua kendaraan di fleet dan menjadi string Unicode yang valid. Ini adalah ID resource untuk saat ini. Baik perjalanan on demand maupun perhentian terjadwal menggunakannya untuk mengaitkan perjalanan atau tugas dengan kendaraan yang menyelesaikannya.

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

ID entitas unik

Format dan nilai ID entity unik yang digunakan dalam panggilan resource adalah buram ke 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 akan tetap tersedia untuk digunakan kembali di Fleet Engine selama 7 hari, yang berarti Anda bisa menggunakan kembali kendaraan pada hari kerja berikutnya tanpa harus membuat yang baru. Setiap kali Anda menggunakan kembali kendaraan, Fleet Engine akan mengatur ulang ketersediaannya, lalu pada Hitung mundur 7 hari dimulai lagi.

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

CATATAN: Beberapa kolom pada entity Vehicle seperti device_settings sepenuhnya merupakan debug informasi yang tidak disimpan oleh Fleet Engine. Memperbaruinya tidak memperpanjang masa pakai entity Vehicle.

Untuk analisis sistem yang lebih baik, sebaiknya gunakan kembali ID kendaraan pengemudi yang sama pemasangan 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