Apa itu perjalanan on-demand?

Dokumentasi di bagian ini menunjukkan cara membuat dan menggunakan perjalanan menggunakan layanan perjalanan on-demand Google Maps Mobility. Tutorial ini mengasumsikan bahwa Anda sudah memahami hal-hal berikut:

TripService yang akan Anda gunakan tersedia untuk gRPC dan REST. Agar lebih mudah, referensi kolom mengikuti konvensi gRPC.

Di Fleet Engine untuk layanan on-demand, perjalanan adalah jenis perjalanan yang memodelkan pemenuhan permintaan pengiriman makanan atau perjalanan dari konsumen Anda. Perjalanan memiliki status yang Anda laporkan ke Fleet Engine seiring perkembangan perjalanan, seperti NEW, ENROUTE_TO_PICKUP, dan lainnya. Status perjalanan sesuai dengan titik jalan yang ditentukan secara geografis yang ditetapkan ke kendaraan, dan Fleet Engine mengubah titik jalan kendaraan ini dengan setiap pembaruan perjalanan yang Anda lakukan. Lihat Perjalanan on demand di Dasar-dasar Fleet Engine untuk mengetahui informasi selengkapnya tentang perjalanan dan hubungannya dengan kendaraan.

Siklus perjalanan

Untuk melacak setiap perjalanan di Fleet Engine, Anda harus membuat entitas Trip terlebih dahulu. Lihat gRPC atau REST sebagai referensi.

Tabel berikut menjelaskan contoh alur menyeluruh dari perjalanan yang dibuat di sistem Anda dan tahap siklus prosesnya di Fleet Engine. Panduan ini mengasumsikan bahwa Anda telah menyiapkan Fleet Engine dan memiliki kendaraan untuk ditetapkan ke perjalanan, dengan pembaruan lokasi yang diaktifkan di aplikasi driver. Lihat Driver SDK: Perjalanan on-demand.

1 Menerima permintaan pemesanan. Sebelum perjalanan Fleet Engine dimulai, sistem pemesanan Anda akan menerima permintaan perjalanan atau pengiriman dari konsumen melalui aplikasi Anda atau sistem pemesanan lainnya. Sistem Anda kemudian membuat entity perjalanan menggunakan CreateTrip dengan kolom yang diperlukan, seperti lokasi penjemputan. Layanan ini juga dapat menetapkan kolom lain pada tahap ini, seperti penumpang dan lokasi pengantaran, atau menunggu hingga layanan menetapkan kendaraan. Lihat Membuat perjalanan satu tujuan.
2 Tetapkan kendaraan.

Anda dapat menetapkan kendaraan ke perjalanan secara langsung dalam sistem dan melaporkan penetapan tersebut ke Fleet Engine, atau Anda dapat menggunakan layanan Search Vehicle untuk menelusuri kendaraan, memfilter berdasarkan atribut perjalanan dan kendaraan untuk menemukan kendaraan terbaik untuk menyelesaikan perjalanan. Setiap kendaraan online dalam radius penelusuran Anda akan menginformasikan kedekatannya melalui pembaruan lokasi yang disediakan oleh Driver SDK.

Setelah SearchVehicle menampilkan kendaraan yang Anda cocokkan dengan perjalanan, sistem Anda akan memanggil endpoint UpdateTrip untuk melaporkan ID kendaraan yang Anda tetapkan ke perjalanan NEW.
3 Perbarui perjalanan. Setelah pengemudi menerima perjalanan dan mulai menavigasi ke lokasi penjemputan, sistem Anda akan memperbarui status perjalanan dari NEW menjadi ENROUTE_TO_PICKUP. Anda terus melakukan polling lokasi kendaraan selama perjalanan, baik melalui koneksi langsung dari aplikasi ke backend, atau dengan melakukan polling ke Fleet Engine, yang menerima aliran pembaruan lokasi kendaraan yang berkelanjutan dari Driver SDK. Sistem Anda kemudian melaporkan setiap pencapaian perjalanan ke Fleet Engine, yang akan memperbarui daftar titik jalan kendaraan.
4 Bagikan perjalanan kepada konsumen. Fleet Engine menyediakan detail perjalanan dan lokasi kendaraan untuk Consumer SDK, yang menggunakan pemroses untuk menerima update perjalanan dan menampilkannya di aplikasi pelanggan. Fleet Engine otomatis memperbarui PWT, sisa jarak, rute, dan titik jalan kendaraan yang tersisa. Lihat Membagikan perjalanan untuk perjalanan on demand untuk mengetahui informasi selengkapnya.
5 Perjalanan lengkap. Setelah kendaraan mencapai titik jalan tujuan perjalanan dan pengemudi menunjukkan perjalanan yang berhasil, sistem Anda akan menetapkan TripStatus ke COMPLETE di Fleet Engine. Perlu diingat bahwa, seperti kendaraan, entitas perjalanan tetap aktif dalam Fleet Engine selama 7 hari, apa pun statusnya, dan setelah itu akan dihapus.

Alur urutan perjalanan

Diagram berikut menunjukkan tampilan yang lebih mendetail dari alur ini.

TripSequenceDiagram

Langkah berikutnya