Mengelola titik jalan

Secara default, Navigation SDK for Android menemukan rute tercepat ke titik jalan, tetapi hal ini tidak menjamin bahwa kendaraan akan tiba di sisi jalan yang ditunggu konsumen atau tempat kedatangan aman bagi pengemudi untuk berhenti. Panduan ini menjelaskan dua fitur yang dapat Anda gunakan untuk situasi ini:

  • Sisi preferensi pemilihan rute jalan
  • Fitur persinggahan

Sisi preferensi perutean rute

Fitur ini memungkinkan Anda memastikan bahwa kendaraan tiba di sisi jalan yang benar. Anda menetapkan preferensi untuk kedatangan di sisi jalan tertentu saat membuat titik jalan untuk perhentian tersebut. Anda dapat menentukan preferensi dengan salah satu dari dua cara: memilih sisi jalan yang sama, atau memberikan arah kedatangan.

Pilih sisi jalan yang sama

Anda memberikan koordinat geografis titik jalan, lalu menetapkan tanda (setPreferSameSideOfRoad) yang menunjukkan bahwa Anda memilih untuk tiba di sisi jalan yang sama dengan titik jalan, yang dipaskan ke trotoar terdekat.

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setPreferSameSideOfRoad(true)
           .build()

Tetapkan judul kedatangan

Anda memberikan koordinat geografis titik jalan, lalu memberikan judul kedatangan (setPreferredHeading) yang sesuai dengan arah arus lalu lintas di sisi jalan yang sama dengan konsumen yang menunggu.

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setPreferredHeading(preferredHeading)
           .build()

Navigation SDK memilih segmen jalan yang paling dekat dengan titik jalan—yang memiliki arah jalur yang sejajar (dalam +/- 55 derajat) dengan sisi jalan tempat titik jalan berada.

Menetapkan preferensi persinggahan

Di tempat-tempat tertentu, pengemudi tidak dapat berhenti dengan aman (misalnya, area yang ditinggikan, kapal feri, lokasi bawah tanah, dan area dengan akses terbatas lainnya). Fitur Persinggahan memindahkan titik jalan ke tempat terdekat jika lokasinya tidak cocok bagi kendaraan untuk melakukan perhentian. Saat Anda menetapkan setVehicleStopover ke true, titik jalan akan otomatis dipindahkan saat rute dihitung, jika lokasi alternatif tersedia.

Cara kerjanya

Anda menetapkan preferensi persinggahan saat membuat titik jalan untuk perhentian tersebut. Untuk melakukannya, tentukan preferensi setVehicleStopover seperti yang ditunjukkan pada contoh berikut:

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setVehicleStopover(true)
           .build()