Sesuaikan pengalaman konsumen untuk perjalanan on-demand dengan mengizinkan konsumen mengikuti perjalanan untuk pesanan, perjalanan, atau layanan lain yang Anda berikan kepada mereka.
Apa yang dimaksud dengan Consumer SDK?
Consumer SDK adalah bagian dari Fleet Engine untuk perjalanan on-demand. Library ini menyediakan antarmuka yang memodelkan data perjalanan dan mengikuti perjalanan di Fleet Engine, serta menyediakan class yang Anda gunakan untuk membuat tampilan berbasis peta yang lengkap untuk berbagi perjalanan dengan pengguna konsumen Anda. Anda mengintegrasikan Consumer SDK ke dalam aplikasi dan menetapkan profil peran yang sesuai dalam Fleet Engine untuk menciptakan pengalaman konsumen ini.
API khusus platform Consumer SDK memungkinkan Anda membangun kemampuan untuk membagikan perjalanan secara native ke dalam aplikasi Anda. Consumer SDK tersedia untuk platform berikut:
Mengapa menggunakan Consumer SDK?
Mengintegrasikan Consumer SDK ke dalam aplikasi perjalanan on-demand memungkinkan Anda memberikan pengalaman konsumen yang komprehensif, dengan pembaruan lokasi hampir real-time dan posisi yang disesuaikan dengan jalan. Konsumen Anda dapat melihat rute kendaraan yang dihamparkan di atas peta, termasuk detail progres yang membantu mereka memahami lokasi perjalanan atau pengiriman mereka.
Apa yang dapat Anda lakukan dengan Consumer SDK?
Anda dapat menggunakan informasi dari Driver SDK dan Fleet Engine untuk membuat pengalaman konsumen yang disesuaikan, termasuk fitur berikut:
Sesuaikan UI peta agar sesuai dengan kebutuhan branding Anda.
Ikuti lokasi kendaraan saat ini saat kendaraan bergerak di sepanjang rute, dengan posisinya yang diperbarui secara berkala.
Menampilkan perkiraan waktu tiba (ETA) untuk lokasi penjemputan dan pengantaran.
Menampilkan sisa jarak.
Menampilkan lalu lintas real-time di rute.
Cara kerja Consumer SDK
Secara garis besar, Consumer SDK mengandalkan mekanisme berikut:
- Memiliki peran Fleet Engine yang sesuai sehingga aplikasi yang diautentikasi dapat mengikuti perjalanan yang terkait dengan pesanan konsumen.
- Pengaitan antara konsumen dan perjalanan, yang disediakan oleh sistem backend Anda.
- Class SDK
TripModeldanJourneySharingSessionyang membuat model data perjalanan dan membagikan sesi perjalanan di aplikasi pelanggan.
Consumer SDK juga menyediakan antarmuka dan class lain sehingga Anda dapat membuat pengalaman aplikasi yang lengkap dengan detail seperti lalu lintas, penanda peta, perkiraan waktu kedatangan, dan data rute.
Tabel ini menunjukkan alur perjalanan yang diikuti oleh aplikasi pelanggan.
| 1 | Aplikasi pelanggan meminta perjalanan | Server backend Anda mendapatkan permintaan perjalanan on-demand dan melakukan
hal berikut:
|
| 2 | Pengemudi menerima perjalanan | Aplikasi pengemudi mendapatkan ID perjalanan dan informasi perjalanan, dan pengemudi menerima perjalanan. |
| 3 | Aplikasi pelanggan meminta akses untuk mengikuti perjalanan | Aplikasi pelanggan mendapatkan ID perjalanan dari backend Anda dan meminta untuk mulai mengikuti perjalanan. |
| 4 | Pengemudi memulai perjalanan | Saat pengemudi menggunakan aplikasi pengemudi untuk menunjukkan bahwa perjalanan telah dimulai, aplikasi akan memberi tahu server backend Anda melalui Driver SDK. Misalnya, saat pengemudi akan meninggalkan restoran atau berkendara ke lokasi penjemputan. |
| 5 | Fleet Engine mulai mengirim informasi perjalanan | Fleet Engine mulai melacak perjalanan dan membagikan progresnya ke aplikasi pelanggan. |
| 6 | Aplikasi pelanggan menampilkan informasi perjalanan | Aplikasi konsumen memberi tahu konsumen dan mulai menampilkan informasi perjalanan kepada mereka, serta memperbarui perjalanan seiring progresnya. |
| 7 | Perjalanan dibatalkan atau selesai | Saat pengemudi membatalkan atau menyelesaikan perjalanan, aplikasi pengemudi akan menonaktifkan pelacakan lokasi, dan server backend Anda akan memberi tahu Fleet Engine untuk menandai perjalanan sebagai dibatalkan atau selesai. |
| 8 | Aplikasi pelanggan berhenti mengikuti perjalanan | Perjalanan ditampilkan sebagai dibatalkan atau selesai. |
| 9 | Proses ini akan diulangi untuk perjalanan berikutnya | Perjalanan baru dibuat dan prosesnya berulang. |
Cara menggunakan Consumer SDK
Pilih platform Anda untuk melihat cara mulai mengikuti perjalanan di aplikasi pelanggan Anda.
Android
| 1 | Menyiapkan Consumer SDK di Android | Untuk mengikuti perjalanan on demand di aplikasi Anda, siapkan Consumer SDK. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan Consumer SDK Android. |
| 2 | Menyiapkan antarmuka visual | Tentukan peta dan tambahkan dukungan untuk peta vektor guna menyiapkan pengalaman konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan peta. |
| 3 | Mengikuti perjalanan | Ikuti perjalanan untuk membagikan lokasi kendaraan yang sesuai kepada konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Mengikuti perjalanan. |
| 5 | Memperbarui progres perjalanan dan menangani error perjalanan | Perbarui detail perjalanan Anda seperti jarak perjalanan dan perkiraan waktu tiba, serta tangani error apa pun selama perjalanan. Untuk mengetahui informasi selengkapnya, lihat Memperbarui progres perjalanan dan Menangani error perjalanan. |
| 5 | Saat perjalanan selesai, berhenti mengikuti | Berhenti mengikuti perjalanan untuk berhenti membagikan lokasi kendaraan kepada konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Berhenti mengikuti perjalanan. |
iOS
| 1 | Menyiapkan Consumer SDK di iOS | Untuk mengikuti perjalanan on demand di aplikasi Anda, siapkan Consumer SDK. Untuk informasi selengkapnya, lihat Mendapatkan Consumer SDK iOS. |
| 2 | Menyiapkan antarmuka visual | Lakukan inisialisasi tampilan peta dan tangani peristiwa peta untuk menyiapkan pengalaman konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan peta. |
| 3 | Mengikuti perjalanan | Ikuti perjalanan untuk membagikan lokasi kendaraan yang sesuai kepada konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Mengikuti perjalanan. |
| 5 | Memperbarui progres perjalanan dan menangani error perjalanan | Memperbarui detail perjalanan Anda seperti jarak perjalanan dan perkiraan waktu tiba, serta menangani error selama perjalanan. Untuk mengetahui informasi selengkapnya, lihat Memperbarui progres perjalanan dan Menangani error perjalanan. |
| 5 | Saat perjalanan selesai, berhenti mengikuti | Berhenti mengikuti perjalanan untuk berhenti membagikan lokasi kendaraan kepada konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Berhenti mengikuti perjalanan. |
JavaScript
| 1 | Menyiapkan Consumer SDK di JavaScript | Untuk mengikuti perjalanan on demand di aplikasi Anda, siapkan Consumer SDK. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Consumer SDK JavaScript. |
| 2 | Memuat dan menyesuaikan peta | Aktifkan Maps JavaScript API dan siapkan otorisasi untuk menyiapkan pengalaman konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan peta. |
| 3 | Mengikuti perjalanan | Ikuti perjalanan untuk membagikan lokasi kendaraan yang sesuai kepada konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Mengikuti perjalanan. |
| 5 | Memperbarui progres perjalanan dan menangani error perjalanan | Memperbarui detail perjalanan Anda seperti jarak perjalanan dan perkiraan waktu tiba, serta menangani error apa pun dalam perjalanan. Untuk mengetahui informasi selengkapnya, lihat Memperbarui dan mengikuti progres perjalanan dan Menangani error perjalanan. |
| 5 | Saat perjalanan selesai, berhenti mengikuti | Berhenti mengikuti perjalanan untuk berhenti membagikan lokasi kendaraan kepada konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Berhenti mengikuti perjalanan. |
Komponen
Bagian ini merangkum dua komponen yang diperlukan untuk mengikuti perjalanan:
Secara opsional, Anda juga dapat menyesuaikan pengalaman konsumen dengan komponen berikut:
Pengambil token autentikasi
Untuk mengontrol akses ke data lokasi yang disimpan di Fleet Engine, Anda harus melakukan hal berikut:
Terapkan layanan pembuatan Token Web JSON (JWT) untuk Fleet Engine di server Anda. Untuk mengetahui informasi selengkapnya, lihat Mengeluarkan JWT.
Terapkan pengambil token autentikasi di aplikasi web atau seluler Anda untuk mengautentikasi akses ke data lokasi. Untuk mengetahui informasi selengkapnya tentang cara menyiapkan pengambil token, lihat panduan penyiapan untuk Android, iOS, atau JavaScript.
Tampilan peta dan pelacak perjalanan
Mengikuti perjalanan mencakup komponen untuk visualisasi kendaraan dan titik jalan, serta feed data mentah untuk perkiraan waktu tiba (ETA) pengemudi atau sisa jarak yang harus ditempuh.
Tabel berikut menjelaskan komponen ini:
| Komponen | Deskripsi |
|---|---|
| Tampilan peta konsumen | Tampilan peta mengelola siklus proses perjalanan, yang menampilkan titik jalan untuk lokasi kendaraan seiring berjalannya perjalanan. Jika rute kendaraan diketahui, tampilan peta akan memperbarui polyline rute kendaraan untuk menunjukkan progres kendaraan di sepanjang rutenya. |
| Penyedia lokasi perjalanan di JavaScript | Untuk aplikasi web JavaScript, penyedia lokasi perjalanan memasukkan informasi lokasi untuk objek yang dilacak ke dalam peta perjalanan bersama. Untuk mengetahui informasi selengkapnya, lihat Membuat instance penyedia lokasi perjalanan.
Anda dapat menggunakan penyedia lokasi perjalanan untuk melacak detail berikut untuk
perjalanan:
|
Objek lokasi yang dilacak
Penyedia lokasi melacak lokasi objek seperti titik jalan dan kendaraan, yang dijelaskan dalam tabel berikut.
| Lokasi yang dilacak | Deskripsi |
|---|---|
| Lokasi pengambilan | Lokasi penjemputan adalah lokasi tempat perjalanan dimulai. |
| Lokasi tujuan | Lokasi tujuan adalah lokasi tempat perjalanan berakhir. Penanda ini menandai lokasi pengantaran. |
| Lokasi titik jalan | Lokasi titik jalan adalah lokasi perantara di sepanjang rute perjalanan yang dilacak. Meskipun secara teknis, titik jalan dapat mencakup lokasi penjemputan dan penurunan, titik jalan biasanya mengacu pada perhentian sementara di sepanjang rute. Misalnya, perhentian antara lokasi pengambilan dan tujuan pada rute pengiriman adalah lokasi titik jalan. Untuk mengetahui informasi selengkapnya, lihat Titik jalan perjalanan dalam dokumentasi Fleet Engine. |
| Lokasi kendaraan | Lokasi kendaraan adalah lokasi kendaraan yang dilaporkan. Untuk mengetahui informasi selengkapnya, lihat Lokasi kendaraan dalam dokumentasi Fleet Engine. |
Menata gaya peta Anda
Gaya penanda dan polyline menentukan tampilan dan nuansa objek lokasi yang dilacak di peta. Anda dapat menggunakan opsi gaya kustom agar sesuai dengan gaya aplikasi web Anda.
Mengontrol visibilitas lokasi yang dipantau
Penyedia lokasi yang telah ditetapkan di Fleet Engine mengikuti aturan visibilitas ini untuk objek lokasi yang dilacak di peta. Jika Anda membuat penyedia lokasi kustom atau turunan, Anda dapat mengubah aturan visibilitas.
Kendaraan hanya terlihat saat perjalanan sedang berlangsung: Kendaraan perjalanan terlihat sejak ditetapkan ke perjalanan hingga waktu pengantaran. Jika perjalanan dibatalkan, kendaraan tidak akan terlihat lagi.
Semua penanda lokasi lainnya selalu terlihat: Semua penanda lokasi lainnya untuk tempat asal, tujuan, dan titik jalan selalu ditampilkan di peta. Misalnya, lokasi penurunan perjalanan atau lokasi pengiriman selalu ditampilkan di peta, terlepas dari status perjalanan atau pengiriman.
Langkah berikutnya
Lihat dokumentasi untuk platform tempat Anda ingin mengikuti perjalanan: