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 berdasarkan lokasi geografis yang ditetapkan untuk kendaraan, dan Fleet Engine memodifikasi titik jalan kendaraan ini pada setiap update 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. Kemudian, sistem Anda akan membuat entitas perjalanan menggunakan CreateTrip dengan kolom wajib diisi, seperti lokasi pengambilan. Layanan ini juga dapat menetapkan kolom lain pada titik ini, seperti lokasi penumpang dan penurunan, atau menunggu hingga kendaraan ditetapkan. Lihat Membuat perjalanan satu tujuan.
2 Tetapkan 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 Bagikan perjalanan kepada 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 menyetel TripStatus ke COMPLETE di Fleet Engine. Perlu diingat bahwa, seperti kendaraan, entitas perjalanan tetap aktif di dalam Fleet Engine selama 7 hari terlepas dari status penghapusannya.

Alur urutan perjalanan

Diagram berikut menunjukkan tampilan yang lebih mendetail tentang alur ini.

TripSequenceDiagram

Langkah berikutnya