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
- Layanan yang akan diaktifkan:
fleetengine.googleapis.com - Autentikasi: Akun layanan, JSON Web Token (JWT), OAuth 2.0
- Atribusi penggunaan: Fitur beta opsional: tetapkan header HTTP
X-Goog-Maps-Experience-IDke ID Transaksi Mobilitas (atau ID terkait, seperti ID sesi) pada panggilan ke layanan paket Mobilitas; pisahkan beberapa ID dengan koma. Teruskan ID terkait direlated_idssaat melaporkan transaksi. - Memulai: Menyiapkan Layanan Fleet Engine
- Referensi: Referensi Layanan Fleet Engine
- Kebijakan: Kebijakan Fleet Engine Service
- Catatan rilis: Catatan rilis Fleet Engine Service
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: produk terkait
- Sering digunakan dengan: Driver SDK for Android, Driver SDK for iOS, Consumer SDK for Android, Consumer SDK for iOS, JavaScript Consumer SDK, Route Optimization API
Layanan Fleet Engine: kesalahan umum
- Masalah: Permintaan ke Fleet Engine terkadang dapat gagal, dan setelah kegagalan, entitas seperti kendaraan mungkin tidak ada lagi (
NOT_FOUNDsaat 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_EXCEEDEDterjadi saat permintaan memerlukan waktu lebih lama daripada waktu tunggu default library klien. Perbaikan: Sesuaikan setelan percobaan ulang RPC (misalnya,setTotalTimeoutdiVehicleServiceSettingsdi 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
ReportBillableTripdan Mobility Billing API dari beberapa hari sebelum hingga beberapa hari setelah migrasi, bandingkan jumlah permintaan di Cloud Logging, lalu hapus panggilanReportBillableTrip. 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:UpdateVehiclediVehicleService. Gejala: Tidak digunakan lagi pada 1 Februari 2024; dinonaktifkan pada Mei 2024. - Metode
SearchFuzzedVehicles: Dinonaktifkan sejak 01-05-2024. Penggantian:SearchVehiclesdiVehicleService. Gejala: Tidak digunakan lagi pada 1 Februari 2024; dinonaktifkan pada Mei 2024. - Metode
SearchTasks: Dinonaktifkan sejak 01-05-2024. Penggantian:GetTaskTrackingInfodiDeliveryService. Gejala: Tidak digunakan lagi pada 1 Februari 2024; dinonaktifkan pada Mei 2024. ReportBillableTripsetelah 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 APIreportBillableEvent. 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.
- Melaporkan penggunaan perjalanan Fleet Engine yang dapat ditagih.
- Membuat dan menampilkan perjalanan Fleet Engine baru.
- Menampilkan informasi tentang perjalanan Fleet Engine.
- Menampilkan daftar semua perjalanan Fleet Engine untuk kendaraan yang ditentukan.
- Memperbarui data perjalanan untuk perjalanan Fleet Engine.
- Membuat instance kendaraan baru di Fleet Engine yang terkait dengan penyedia transportasi online atau pengiriman on-demand.
- Menampilkan kendaraan dari layanan Fleet Engine.
- Menampilkan daftar kendaraan yang diberi nomor halaman di Fleet Engine yang terkait dengan penyedia yang cocok dengan kriteria yang ditentukan.
- Menampilkan daftar kendaraan di Fleet Engine yang cocok dengan kriteria yang ditentukan.
- Memperbarui data kendaraan untuk kendaraan di Fleet Engine.
- Memperbarui atribut kendaraan untuk kendaraan di Fleet Engine.
- Menampilkan informasi perjalanan untuk kendaraan dari layanan Fleet Engine.