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. Untuk mempermudah, referensi kolom mengikuti konvensi gRPC.

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

Masa berlaku perjalanan

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

Tabel berikut menjelaskan contoh alur perjalanan menyeluruh yang dibuat di sistem Anda dan tahapan siklus prosesnya di Fleet Engine. Ini mengasumsikan bahwa Anda telah menyiapkan Fleet Engine dan memiliki kendaraan untuk ditetapkan ke perjalanan, dengan pembaruan lokasi diaktifkan di aplikasi pengemudi. 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 terlebih dahulu melalui aplikasi Anda atau sistem pemesanan lainnya. Sistem Anda kemudian akan membuat entitas perjalanan menggunakan CreateTrip dengan kolom yang diperlukan, seperti lokasi penjemputan. Pada tahap ini, sistem juga dapat menetapkan kolom lain, seperti penumpang dan lokasi penjemputan, atau menunggu hingga menetapkan kendaraan. Lihat Membuat perjalanan satu tujuan.
2 Menetapkan kendaraan.

Anda dapat menetapkan kendaraan ke perjalanan langsung dalam sistem dan melaporkan penetapan ke Fleet Engine, atau Anda dapat menggunakan layanan Search Vehicle untuk menelusuri kendaraan, memfilter menurut atribut perjalanan dan kendaraan untuk menemukan kendaraan terbaik guna menyelesaikan perjalanan. Setiap kendaraan online dalam radius penelusuran Anda akan membuat kedekatannya diketahui 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 pada Fleet Engine, yang menerima streaming pembaruan lokasi kendaraan yang sedang berlangsung dari Driver SDK. Sistem Anda kemudian melaporkan setiap pencapaian perjalanan ke Fleet Engine, yang memperbarui daftar titik jalan kendaraan.
4 Membagikan perjalanan dengan konsumen. Fleet Engine menyediakan detail perjalanan dan lokasi kendaraan ke Consumer SDK, yang menggunakan pemroses untuk menerima pembaruan perjalanan dan menampilkannya di aplikasi konsumen. Fleet Engine otomatis memperbarui perkiraan waktu tiba, jarak tersisa, rute, dan titik jalan kendaraan yang tersisa. Lihat Membagikan perjalanan untuk perjalanan on demand untuk mengetahui informasi selengkapnya.
5 Perjalanan selesai. 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, terlepas dari statusnya, dan setelah itu entitas tersebut akan dihapus.

Alur urutan perjalanan

Diagram berikut menunjukkan tampilan yang lebih mendetail tentang alur ini.

TripSequenceDiagram

Langkah berikutnya