Sesuaikan pengalaman konsumen untuk perjalanan on-demand dengan mengizinkan konsumen mengikuti perjalanan untuk pesanan, perjalanan dengan kendaraan, atau layanan lain yang Anda berikan kepada mereka.
Apa itu 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 kaya untuk membagikan perjalanan kepada 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 spesifik per 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?
Dengan mengintegrasikan Consumer SDK ke dalam aplikasi perjalanan on-demand, Anda dapat memberikan pengalaman konsumen yang komprehensif, dengan update lokasi hampir real-time dan posisi yang disesuaikan dengan jalan. Konsumen Anda dapat melihat rute kendaraan yang ditampilkan 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 bergerak di sepanjang rute, dengan posisi yang diperbarui secara berkala.
Menampilkan perkiraan waktu tiba (PWT) untuk lokasi pengambilan dan pengantaran.
Tampilkan jarak yang tersisa.
Menampilkan lalu lintas live di rute.
Cara kerja Consumer SDK
Pada tingkat tinggi, Consumer SDK mengandalkan mekanisme berikut:
- Memiliki peran Fleet Engine yang sesuai sehingga aplikasi yang diautentikasi dapat mengikuti perjalanan yang terkait dengan pesanan konsumen.
- Asosiasi antara konsumen dan perjalanan, yang disediakan oleh sistem backend Anda.
- Class SDK
TripModeldanJourneySharingSessionyang memodelkan data perjalanan dan membagikan sesi perjalanan di aplikasi konsumen.
Consumer SDK juga menyediakan antarmuka dan class lain sehingga Anda dapat membuat pengalaman aplikasi yang kaya dengan detail seperti lalu lintas, penanda peta, ETA, dan data rute.
Tabel ini menunjukkan alur perjalanan yang diikuti oleh aplikasi konsumen.
| 1 | Aplikasi konsumen 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 konsumen meminta akses untuk mengikuti perjalanan | Aplikasi konsumen 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 pengambilan. |
| 5 | Fleet Engine mulai mengirim informasi perjalanan | Fleet Engine mulai melacak perjalanan dan membagikan progresnya dengan aplikasi konsumen. |
| 6 | Aplikasi konsumen menampilkan informasi perjalanan | Aplikasi konsumen memberi tahu konsumen dan mulai menampilkan informasi perjalanan kepada mereka, memperbarui perjalanan seiring kemajuannya. |
| 7 | Perjalanan dibatalkan atau diselesaikan | 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 diselesaikan. |
| 8 | Aplikasi konsumen berhenti mengikuti perjalanan | Perjalanan ditampilkan sebagai dibatalkan atau selesai. |
| 9 | Proses ini 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 konsumen 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 Android Consumer SDK. |
| 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 kedatangan, serta tangani error apa pun selama perjalanan. Untuk mengetahui informasi selengkapnya, lihat Memperbarui progres perjalanan dan Menangani error perjalanan. |
| 5 | Setelah 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 mengetahui informasi selengkapnya, lihat Mendapatkan iOS Consumer SDK. |
| 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 | Perbarui detail perjalanan Anda seperti jarak perjalanan dan perkiraan waktu kedatangan, serta tangani error apa pun selama perjalanan. Untuk mengetahui informasi selengkapnya, lihat Memperbarui progres perjalanan dan Menangani error perjalanan. |
| 5 | Setelah 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 JavaScript Consumer SDK. |
| 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 | Perbarui detail perjalanan Anda seperti jarak perjalanan dan perkiraan waktu kedatangan, serta tangani error apa pun dalam perjalanan. Untuk mengetahui informasi selengkapnya, lihat Memperbarui dan mengikuti progres perjalanan dan Menangani error perjalanan. |
| 5 | Setelah 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 Menerbitkan JWT.
Terapkan pengambilan 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 pengemudi atau jarak yang tersisa untuk berkendara.
Tabel berikut menjelaskan komponen ini:
| Komponen | Deskripsi |
|---|---|
| Tampilan peta konsumen | Tampilan peta mengelola siklus proses perjalanan, menampilkan titik jalan untuk lokasi kendaraan saat perjalanan berlangsung. 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 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. Menandai lokasi penurunan penumpang. |
| Lokasi titik jalan | Lokasi titik jalan adalah lokasi perantara di sepanjang rute perjalanan yang dilacak. Secara teknis, titik jalan dapat mencakup lokasi penjemputan dan pengantaran, tetapi titik jalan biasanya merujuk pada perhentian di tengah rute. Misalnya, perhentian di antara lokasi penjemputan dan tujuan di rute pengiriman adalah lokasi titik jalan. Untuk mengetahui informasi selengkapnya, lihat Titik jalan perjalanan dalam dokumentasi Fleet Engine. |
| Lokasi kendaraan | Lokasi kendaraan adalah lokasi yang dilaporkan dari kendaraan. 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 ditentukan sebelumnya 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 saat kendaraan ditetapkan untuk perjalanan hingga saat penurunan penumpang. Jika perjalanan dibatalkan, kendaraan tidak akan terlihat lagi.
Semua penanda lokasi lainnya selalu terlihat: Semua penanda lokasi lainnya untuk asal, tujuan, dan titik jalan selalu ditampilkan di peta. Misalnya, lokasi tujuan 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: