Referensi cepat Layanan Fleet Engine

Fleet Engine adalah layanan backend yang memodelkan armada kendaraan di dunia nyata dan menyediakan rute, perkiraan waktu tiba, lalu lintas, dan pembaruan status untuk perjalanan on-demand dan tugas terjadwal. SDK ini menggunakan data lokasi dan rute dari Driver SDK serta berfungsi dengan Consumer SDK dan API Google Maps Platform lainnya.

Layanan Fleet Engine: fakta penting

  • Produk: Layanan Fleet Engine
  • Juga dikenal sebagai: Fleet Engine, Fleet Engine API, Local Rides and Deliveries API
  • Kategori: Rute
  • Platform: Layanan web (REST)
  • Berjalan di: Server (kode backend)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Layanan Fleet Engine

Layanan Fleet Engine: kapan harus menggunakannya

Gunakan Layanan Fleet Engine jika:

  • Anda memerlukan backend yang memodelkan kendaraan dan perjalanan on-demand (penjemputan, titik jalan, pengantaran), termasuk perjalanan multi-tujuan, berturut-turut, atau bersama.
  • Anda perlu membuat model tugas pengiriman atau layanan terjadwal yang ditetapkan ke kendaraan dan melacak perhentian, hasil, dan perkiraan waktu kedatangan (ETA).
  • Anda perlu menelusuri atau mencantumkan kendaraan di suatu wilayah untuk mencocokkannya dengan perjalanan yang diminta.
  • Anda memerlukan pelacakan perjalanan atau pengiriman konsumen dan pelacakan operator armada yang didukung oleh pembaruan lokasi Driver SDK.

Jangan gunakan Layanan Fleet Engine jika:

  • Anda perlu menampilkan penanda GPS atau jalur aset secara langsung di peta web dari database atau streaming Anda sendiri, tanpa orkestrasi perjalanan atau tugas Fleet Engine. Gunakan Maps JavaScript API.
  • Anda perlu menampilkan penanda atau jalur langsung dari data Anda sendiri di aplikasi Android, tanpa orkestrasi perjalanan atau tugas Fleet Engine. Gunakan Maps SDK for Android.
  • Anda perlu menampilkan penanda atau jalur langsung dari data Anda sendiri di aplikasi iOS, tanpa orkestrasi perjalanan atau tugas Fleet Engine. Gunakan Maps SDK for iOS.
  • Anda perlu menghitung rencana rute yang dioptimalkan untuk seluruh armada; Fleet Engine hanya mengambil rencana rute dari pemecah masalah yang Anda sediakan. Gunakan Route Optimization API.

Layanan Fleet Engine: penyiapan

Paket Layanan Fleet Engine resmi:

  • maven: com.google.maps:google-maps-fleetengine
  • maven: com.google.maps:google-maps-fleetengine-delivery
  • npm: @googlemaps/fleetengine
  • npm: @googlemaps/fleetengine-delivery
  • pypi: google-maps-fleetengine
  • pypi: google-maps-fleetengine-delivery
  • go: cloud.google.com/go/maps

Layanan Fleet Engine: kesalahan umum

  • Masalah: Permintaan ke Fleet Engine terkadang dapat gagal, dan setelah kegagalan, entitas seperti kendaraan mungkin tidak ada lagi (NOT_FOUND saat update). Perbaikan: Terapkan percobaan ulang dengan backoff (library klien mencoba ulang secara default), dan buat ulang kendaraan atau tugas yang hilang dalam statusnya saat ini. Lihat /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Masalah: Error DEADLINE_EXCEEDED terjadi saat permintaan memerlukan waktu lebih lama daripada waktu tunggu default library klien. Perbaikan: Sesuaikan setelan percobaan ulang RPC (misalnya, setTotalTimeout di VehicleServiceSettings di klien Java). Lihat /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Masalah: PERMISSION_DENIED (HTTP 403) jika JWT tidak memiliki klaim yang benar atau akun layanan penandatanganan tidak memiliki peran IAM Fleet Engine yang diperlukan (misalnya, "JWT does not contain a matching scope for requested trip"). Perbaikan: Periksa peran akun layanan dan pastikan klaim JWT menyertakan cakupan untuk kendaraan, perjalanan, atau tugas yang diakses. Lihat /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Masalah: Saat bermigrasi dari Perjalanan dan Pengiriman Sesuai Permintaan ke paket Mobility apa pun, atau dari Last Mile Fleet Solution ke Mobility Activate atau Optimize, permintaan Mobility Billing API menampilkan HTTP 202 hingga migrasi selesai dan tidak menghasilkan penagihan. Perbaikan: Panggil Fleet Engine ReportBillableTrip dan Mobility Billing API dari beberapa hari sebelum hingga beberapa hari setelah migrasi, bandingkan jumlah permintaan di Cloud Logging, lalu hapus panggilan ReportBillableTrip. Lihat /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.

Layanan Fleet Engine: fitur lama dan tidak digunakan lagi

  • Metode UpdateVehicleLocation: Dinonaktifkan sejak 01-05-2024. Penggantian: UpdateVehicle di VehicleService. Gejala: Tidak digunakan lagi pada 1 Februari 2024; dinonaktifkan pada Mei 2024.
  • Metode SearchFuzzedVehicles: Dinonaktifkan sejak 01-05-2024. Penggantian: SearchVehicles di VehicleService. Gejala: Tidak digunakan lagi pada 1 Februari 2024; dinonaktifkan pada Mei 2024.
  • Metode SearchTasks: Dinonaktifkan sejak 01-05-2024. Penggantian: GetTaskTrackingInfo di DeliveryService. Gejala: Tidak digunakan lagi pada 1 Februari 2024; dinonaktifkan pada Mei 2024.
  • ReportBillableTrip setelah bermigrasi ke paket Mobilitas (Perjalanan dan Pengiriman on-demand ke paket apa pun, atau Last Mile Fleet Solution ke paket Activate atau Optimize): Lama. Pengganti: Mobility Billing API reportBillableEvent. Gejala: Khusus kontrak, bukan penghentian penggunaan API. Setelah migrasi, panggilan dapat menampilkan "Invalid Contract: This project [...] is not authorized to use FleetEngine.". Lihat panduan migrasi.

Yang dapat Anda lakukan dengan Layanan Fleet Engine

Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.