Sesuaikan pengalaman konsumen untuk perjalanan sesuai permintaan dengan mengizinkan konsumen mengikuti perjalanan untuk pesanan, transportasi, atau layanan lain yang Anda berikan kepada mereka.
Apa yang dimaksud dengan Consumer SDK?
Consumer SDK adalah bagian dari Fleet Engine untuk perjalanan sesuai permintaan. SDK 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 membagikan perjalanan kepada pengguna konsumen Anda. 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 harus menggunakan Consumer SDK?
Dengan mengintegrasikan Consumer SDK ke dalam aplikasi perjalanan sesuai permintaan, Anda dapat memberikan pengalaman konsumen yang komprehensif, dengan update lokasi yang hampir real-time dan posisi yang disesuaikan dengan jalan. Konsumen Anda dapat melihat rute kendaraan yang di-overlay di atas peta, termasuk detail progres yang membantu mereka memahami lokasi transportasi 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:
Menyesuaikan UI peta agar sesuai dengan kebutuhan branding Anda.
Mengikuti lokasi kendaraan saat ini saat kendaraan bergerak di sepanjang rute, dengan posisi yang diperbarui secara berkala.
Menampilkan perkiraan waktu tiba (ETA) untuk lokasi penjemputan dan pengantaran.
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 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 lengkap 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 sesuai permintaan 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 penjemputan. |
| 5 | Fleet Engine mulai mengirimkan informasi perjalanan | Fleet Engine mulai melacak perjalanan dan membagikan progresnya ke aplikasi konsumen. |
| 6 | Aplikasi konsumen menampilkan informasi perjalanan | Aplikasi konsumen memberi tahu konsumen dan mulai menampilkan informasi perjalanan kepada mereka, serta memperbarui perjalanan saat 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 diulangi untuk perjalanan berikutnya | Perjalanan baru dibuat dan proses diulangi. |
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 sesuai permintaan 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 sesuai permintaan di aplikasi Anda, siapkan Consumer SDK. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan Consumer SDK iOS. |
| 2 | Menyiapkan antarmuka visual | 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 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. |
JavaScript
| 1 | Menyiapkan Consumer SDK di JavaScript | Untuk mengikuti perjalanan sesuai permintaan 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 | Perbarui detail perjalanan Anda seperti jarak perjalanan dan perkiraan waktu tiba, serta tangani error apa pun selama perjalanan. Untuk mengetahui informasi selengkapnya, lihat Memperbarui dan mengikuti progres perjalanan serta 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:
Menerapkan layanan pembuatan Token Web JSON (JWT) untuk Fleet Engine di server Anda. Untuk mengetahui informasi selengkapnya, lihat Menerbitkan JWT.
Menerapkan 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 ETA pengemudi atau jarak yang tersisa untuk dikemudikan.
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 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 akan 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 penjemputan | Lokasi penjemputan adalah lokasi tempat perjalanan dimulai. |
| Lokasi tujuan | Lokasi tujuan adalah lokasi tempat perjalanan berakhir. Lokasi 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 pengantaran, titik jalan biasanya merujuk ke perhentian perantara di sepanjang rute. Misalnya, perhentian 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 kendaraan yang dilaporkan. 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 penataan gaya kustom agar sesuai dengan gaya aplikasi web Anda.
Mengontrol visibilitas lokasi yang dilacak
Penyedia lokasi yang telah ditentukan sebelumnya di Fleet Engine mengikuti aturan visibilitas berikut 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 waktu kendaraan 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 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: