Merutekan menggunakan token titik navigasi

Developer Wilayah Ekonomi Eropa (EEA)

Token titik navigasi memungkinkan Anda mengirim informasi kontekstual penting tentang tujuan ke Navigation SDK for Android, Navigation SDK for iOS, atau Routes API untuk meningkatkan kualitas pemilihan rute dan pengalaman pengemudi. Hal ini berguna dalam kasus seperti pengiriman makanan atau transportasi online, saat titik penjemputan atau pengantaran mungkin ambigu tanpa input pengguna.

Untuk membuat dan meneruskan token titik navigasi, gunakan metode Destinations dari Geocoding API agar pengguna dapat memilih lokasi yang diinginkan dari daftar titik navigasi. Pilihan pengguna akan menjadi titik navigasi yang ditampilkan oleh metode Destinations di Geocoding API.

Kemudian, Anda dapat meneruskan token titik navigasi, yang berisi koordinat tujuan serta informasi kontekstual, ke Navigation SDK for Android atau Navigation SDK for iOS, atau Routes API, tempat titik jalan dibuat untuk pemilihan rute yang akurat. Tujuan akan ditandai untuk pengemudi oleh Navigation SDK berdasarkan Tempat yang terkait dengan token.

Contoh: Kasus penggunaan transportasi online

Ringkasan

Contoh ini menunjukkan cara menggabungkan Geocoding API, Routes API, dan Navigation SDK untuk iOS atau Android guna membuat aplikasi transportasi online yang menghitung harga rute dan mengarahkan pengemudi ke titik penjemputan yang benar.

Berikut adalah langkah-langkahnya secara umum:

  1. Mengambil token titik navigasi melalui Geocoding API.
  2. Gunakan Routes API untuk menghitung rute dan mengenkodekannya dalam token rute.
  3. Teruskan token titik navigasi dan token rute ke Navigation SDK.
  4. Gunakan Navigation SDK untuk mengarahkan pengemudi ke titik penjemputan yang benar.

Lihat bagian Bacaan lebih lanjut untuk mengetahui link ke dokumentasi Routes API, Navigation SDK for iOS, dan Navigation SDK for Android yang relevan.

Diagram ini menunjukkan cara aplikasi transportasi online atau pengiriman menggunakan Geocoding API, Routes API, dan Navigation SDK untuk iOS atau Android guna mengarahkan pengemudi menggunakan token rute dan token titik navigasi:

Diagram kasus penggunaan transportasi online atau pengiriman
Diagram kasus penggunaan transportasi online atau pengiriman

Contoh transportasi online

Bayangkan skenario transportasi online yang memiliki aplikasi untuk konsumen memesan tumpangan, dan aplikasi kedua untuk pengemudi menerima notifikasi tumpangan dan informasi rute ke tujuan.

Gambar ini menunjukkan contoh aplikasi transportasi online konsumen tempat titik navigasi dipilih, dan aplikasi pengemudi yang menggunakan Navigation SDK for Android untuk merutekan pengemudi secara akurat.

Contoh aplikasi konsumen dan pengemudi

Saat pelanggan membuka aplikasi pelanggan, aplikasi akan memanggil metode Destinations dari Geocoding API dan memberi pelanggan pilihan titik navigasi potensial:

Konsumen memilih titik pengantaran

Pengguna memilih titik yang diinginkan, yang merupakan salah satu dalam array navigationPoints di isi respons permintaan SearchDestinations:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

Backend aplikasi memberikan token titik navigasi ke Routes API untuk menghitung rute dan mengambil token rute.

Terakhir, token titik navigasi dan token rute diteruskan ke aplikasi pengemudi seluler yang menggunakan Navigation SDK untuk iOS atau Android guna membuat titik jalan untuk mengarahkan pengemudi ke titik penjemputan yang benar.

Bacaan lebih lanjut