Arsitektur dan Komponen

Untuk menerapkan Progres Perjalanan dan Pesanan, Anda harus menggunakan beberapa komponen Solusi Perjalanan dan Pengiriman On-demand -- Fleet Engine, Consumer SDK, dan Driver SDK:

  • Fleet Engine adalah layanan backend Solusi Perjalanan dan Pengiriman On-demand. Pengelola ini bertanggung jawab untuk mengelola perjalanan dan status kendaraan. Layanan ini menangani transaksi antara Driver SDK, Consumer SDK, dan layanan backend Anda, yang dapat berkomunikasi dengan Fleet Engine dengan melakukan panggilan REST atau gRPC.

  • Consumer SDK adalah library klien yang diintegrasikan ke dalam aplikasi konsumen Anda. Library ini bertanggung jawab untuk memberikan pengalaman berbagi perjalanan, yang mencakup pelacakan rute pengemudi, jarak yang tersisa, dan PWT. Consumer SDK dapat digunakan untuk perangkat seluler (Android atau iOS) atau untuk web (JavaScript).

  • Driver SDK adalah library klien yang diintegrasikan ke dalam aplikasi driver Anda. Library ini bertanggung jawab untuk mengupdate Fleet Engine dengan lokasi pengemudi, rute, jarak yang tersisa, dan PWT. API ini juga menggabungkan Navigation SDK, yang menyediakan petunjuk navigasi belokan demi belokan untuk pengemudi. Untuk mengetahui informasi selengkapnya, lihat Navigasi dengan Google Maps.

Diagram arsitektur berikut menunjukkan hubungan antara komponen ini:

Arsitektur

Perjalanan, kendaraan, dan titik jalan

Membuat aplikasi Progres Perjalanan dan Pesanan melibatkan penggunaan perjalanan, kendaraan, dan titik jalan.

Perjalanan

Perjalanan mewakili perjalanan, yaitu perjalanan yang mengangkut konsumen (atau makanan yang mereka pesan) dari lokasi pengambilan ke lokasi penjemputan, termasuk titik jalan perantara di sepanjang perjalanan.

Secara terprogram, objek Trip merangkum lokasi penjemputan, tujuan, lokasi kendaraan saat ini, rute yang akan ditempuh, titik jalan perantara, dan jenis perjalanan (eksklusif atau bersama).

Kendaraan

Kendaraan mewakili kendaraan di armada Anda. Secara terprogram, objek Vehicle merangkum lokasi kendaraan, daftar perjalanan saat ini, dan daftar titik jalan saat ini.

Titik jalan

Titik jalan mewakili lokasi di sepanjang rute. Area ini dapat berupa lokasi penjemputan, lokasi pengantaran, atau tonggak pencapaian yang hanya dilewati. Secara terprogram, objek Waypoint berisi posisi titik jalan sebagai kumpulan koordinat geografis, jenis titik jalan, dan ID perjalanan yang menyertakan titik jalan.

Perjalanan dan kendaraan berisi titik jalan:

  • Kumpulan titik jalan perjalanan berisi semua titik jalan yang relevan dengan perjalanan. Ini dapat mencakup titik jalan untuk perjalanan lain jika perjalanan tersebut digunakan bersama dengan perjalanan lain.

  • Kumpulan titik jalan kendaraan berisi semua titik jalan yang tersisa untuk kendaraan tersebut, termasuk titik jalan untuk beberapa perjalanan.

Alur contoh

Diagram berikut menunjukkan alur progres pesanan dan perjalanan yang biasa. Untuk informasi selengkapnya, lihat Membuat dan Menampilkan Satu Perjalanan Destinasi.

Diagram Urutan

Langkah-langkah berikut menjelaskan cara menyiapkan alur contoh:

  1. Buat kendaraan, aktifkan berbagi lokasi, lalu tetapkan status kendaraan ke online. Anda membuat kendaraan melalui Fleet Engine. Anda dapat menetapkan status kendaraan ke online melalui Fleet Engine, atau melalui Driver SDK.

  2. Cocokkan pelanggan dengan kendaraan Anda. Anda dapat menggunakan metode SearchVehicles() untuk menemukan daftar kendaraan potensial dari armada Anda.

  3. Buat perjalanan di Fleet Engine, tetapkan kendaraan ke perjalanan tersebut, kaitkan perjalanan tersebut dengan aplikasi konsumen, dan berikan lokasi penjemputan dan pengantaran kepada pengemudi.

  4. Driver SDK otomatis memperbarui PWT, jarak, dan rute selama perjalanan. Anda bertanggung jawab untuk memperbarui status perjalanan.

Untuk mulai menerapkan Progres Perjalanan dan Pesanan, lihat Membuat dan Menampilkan Satu Perjalanan Tujuan.