Mengelola titik jalan

Secara default, Navigation SDK untuk Android menemukan rute tercepat ke titik jalan, tetapi hal ini tidak menjamin kendaraan akan tiba di sisi jalan yang ditunggu konsumen, atau bahwa 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 pemilihan rute rute

Fitur ini memungkinkan Anda memastikan kendaraan tiba di sisi jalan yang benar. Anda menetapkan preferensi untuk tiba 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 tujuan kedatangan.

Lebih suka 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 arah kedatangan

Anda memberikan koordinat geografis titik jalan, lalu memberikan arah kedatangan (setPreferredHeading) yang cocok 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 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 berhenti. Saat Anda menetapkan setVehicleStopover ke true, titik jalan akan otomatis dipindahkan saat rute dihitung, jika lokasi alternatif tersedia.

Cara kerjanya

Anda menetapkan preferensi untuk 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()