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. API ini menyediakan antarmuka yang membuat model 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 mengintegrasikan Consumer SDK ke dalam aplikasi dan menetapkan profil peran yang sesuai dalam Fleet Engine untuk membuat pengalaman konsumen ini.
API khusus platform Consumer SDK memungkinkan Anda membuat kemampuan untuk membagikan perjalanan secara native ke dalam aplikasi. 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 diambil dari jalan. Konsumen Anda dapat melihat rute kendaraan yang ditumpangkan 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 melaju di sepanjang rute, dengan posisinya diperbarui secara berkala.
Menampilkan perkiraan waktu tiba (PWT) untuk lokasi pengambilan dan penjemputan.
Menampilkan jarak yang tersisa.
Menampilkan lalu lintas langsung 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 membuat model 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 lengkap dengan detail seperti lalu lintas, penanda peta, perkiraan waktu tiba, 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 mengemudi ke lokasi pengambilan. |
| 5 | Mesin Armada mulai mengirim informasi perjalanan | Fleet Engine mulai melacak perjalanan dan membagikan progresnya dengan aplikasi konsumen. |
| 6 | Aplikasi konsumen menampilkan informasi perjalanan | Aplikasi konsumen akan memberi tahu konsumen dan mulai menampilkan informasi perjalanan kepada mereka, memperbarui perjalanan saat perjalanan berlangsung. |
| 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 konsumen berhenti mengikuti perjalanan | Perjalanan ditampilkan sebagai dibatalkan atau selesai. |
| 9 | Proses ini diulang untuk perjalanan berikutnya | Perjalanan baru akan dibuat dan prosesnya diulang. |
Cara menggunakan Consumer SDK
Pilih platform Anda untuk melihat cara mulai mengikuti perjalanan di aplikasi konsumen.
Android
| 1 | Menyiapkan Consumer SDK di Android | Untuk mengikuti perjalanan on-demand di aplikasi Anda, siapkan Consumer SDK. Untuk 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 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 selama perjalanan. Untuk 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 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 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 selama perjalanan. Untuk 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 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 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 memantau 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 informasi selengkapnya, lihat Mengeluarkan JWT.
Terapkan pengambil token autentikasi di aplikasi web atau seluler Anda untuk melakukan autentikasi akses ke data lokasi. Untuk informasi selengkapnya tentang cara menyiapkan pengambil token, lihat panduan penyiapan untuk Android, iOS, atau JavaScript.
Tampilan peta dan pelacak perjalanan
Melacak perjalanan mencakup komponen untuk visualisasi kendaraan dan titik jalan, serta feed data mentah untuk perkiraan waktu tiba (ETA) pengemudi atau jarak yang tersisa untuk berkendara.
Tabel berikut menjelaskan komponen ini:
| Komponen | Deskripsi |
|---|---|
| Tampilan peta konsumen | Tampilan peta mengelola siklus proses perjalanan, yang menampilkan titik perhentian untuk lokasi kendaraan saat perjalanan berlangsung. Jika rute untuk 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. Ini menandai lokasi penurunan penumpang. |
| Lokasi titik jalan | Lokasi titik jalan adalah lokasi perantara di sepanjang rute perjalanan yang dilacak. Meskipun secara teknis, titik perhentian dapat mencakup lokasi penjemputan dan pengantaran, titik perhentian biasanya mengacu pada perhentian perantara di sepanjang rute. Misalnya, perhentian antara lokasi pengambilan dan tujuan di rute pengiriman adalah lokasi titik jalan. Untuk mengetahui informasi selengkapnya, lihat Titik perhentian perjalanan dalam dokumentasi Fleet Engine. |
| Lokasi kendaraan | Lokasi kendaraan adalah lokasi yang dilaporkan oleh kendaraan. Untuk mengetahui informasi selengkapnya, lihat Lokasi kendaraan dalam dokumentasi Fleet Engine. |
Menata gaya peta
Gaya penanda dan polyline menentukan tampilan dan nuansa objek lokasi yang dilacak di peta. Anda dapat menggunakan opsi gaya kustom agar cocok dengan gaya aplikasi web Anda.
Mengontrol visibilitas lokasi yang dilacak
Penyedia lokasi standar di Fleet Engine mengikuti aturan visibilitas ini untuk objek lokasi yang dilacak di peta. Jika 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 ke perjalanan hingga waktu penumpang turun. 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 pengantaran 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: