Apa itu perjalanan on-demand?

Dokumentasi di bagian ini menunjukkan cara membuat dan menangani perjalanan menggunakan layanan perjalanan on-demand Google Maps Mobility. Model ini mengasumsikan bahwa Anda telah memahami 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 menjadi model pemenuhan pesanan makanan atau transportasi dari konsumen Anda. Sebuah perjalanan memiliki status yang Anda laporkan ke Fleet Engine saat perjalanan berkembang, seperti NEW, ENROUTE_TO_PICKUP, dan lainnya. Status perjalanan sesuai dengan lokasi geografis titik jalan yang ditetapkan untuk kendaraan, dan Fleet Engine memodifikasi kendaraan ini titik jalan pada setiap pembaruan perjalanan yang Anda lakukan. Lihat Perjalanan on demand di Armada Dasar-dasar mesin untuk mengetahui informasi selengkapnya tentang perjalanan dan hubungannya dengan kendaraan.

Kehidupan perjalanan

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

Tabel berikut menjelaskan contoh alur perjalanan yang dibuat di sistem Anda dan tahapan siklus prosesnya di Fleet Engine. Ini mengasumsikan bahwa Anda telah menyiapkan Fleet Engine dan punya kendaraan untuk ditugaskan ke perjalanan, dengan pembaruan lokasi diaktifkan di aplikasi {i>driver<i}. Lihat SDK Driver: Perjalanan on demand.

1 Terima permintaan pemesanan. Sebelum perjalanan Fleet Engine dimulai, sistem pemesanan Anda terlebih dahulu akan menerima meminta transportasi atau pengantaran dari konsumen melalui aplikasi Anda atau sistem pemesanan. Sistem Anda kemudian membuat entitas perjalanan menggunakan CreateTrip dengan kolom wajib diisi, seperti lokasi pengambilan. Juga dapat mengatur isian lain pada titik ini, seperti penumpang lokasi pengantaran, atau menunggu hingga kendaraan tersebut ditugaskan. Lihat Membuat perjalanan satu tujuan.
2 Tugaskan kendaraan.

Anda dapat menetapkan kendaraan untuk perjalanan langsung dalam sistem Anda dan melaporkan tugas ke Fleet Engine, atau menggunakan Telusuri Kendaraan layanan untuk mencari kendaraan, memfilter menurut perjalanan dan kendaraan untuk menemukan kendaraan terbaik guna menyelesaikan perjalanan. Semua online kendaraan dalam radius penelusuran Anda membuat jaraknya diketahui melalui update lokasi yang disediakan oleh Driver SDK.

Setelah SearchVehicle mengembalikan kendaraan yang Anda cocokkan dengan sebuah perjalanan, sistem memanggil endpoint UpdateTrip untuk melaporkan ID kendaraan yang Anda tetapkan untuk perjalanan NEW.

3 Perbarui perjalanan. Setelah pengemudi menerima perjalanan dan mulai menavigasi ke lokasi pengambilan, sistem Anda akan memperbarui status perjalanan dari NEW ke ENROUTE_TO_PICKUP. Anda terus melakukan polling pada kendaraan lokasi di sepanjang perjalanan, baik melalui koneksi langsung dari aplikasi ke backend Anda, atau dengan melakukan polling Fleet Engine, yang menerima aliran pembaruan lokasi kendaraan secara berkelanjutan dari SDK Driver. Nama 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 bagi Consumer SDK, yang menggunakan pemroses untuk menerima info terbaru perjalanan dan menampilkannya di aplikasi konsumen. Fleet Engine memperbarui PWT secara otomatis, tersisa jarak, rute, dan titik jalan kendaraan yang tersisa. Lihat Bagikan perjalanan untuk perjalanan on demand untuk informasi selengkapnya.
5 Selesaikan perjalanan. Setelah kendaraan mencapai titik jalan tujuan perjalanan dan {i>driver <i}menunjukkan perjalanan yang berhasil, sistem Anda akan menyetel TripStatus ke COMPLETE di Fleet Engine. Tetap di perlu diingat bahwa, seperti kendaraan, entitas perjalanan tetap aktif di dalam Fleet Engine selama 7 hari, apa pun statusnya, pada saat mana iklan tersebut akan dihapus.

Alur urutan perjalanan

Diagram berikut menunjukkan tampilan alur ini yang lebih mendetail.

TripSequenceDiagram

Langkah berikutnya