Mengelola titik jalan

Pemberitahuan: fromLatLng() dan fromPlaceId() tidak digunakan lagi, tetapi akan tetap tersedia tanpa update lebih lanjut. Sebaiknya Anda bermigrasi ke Waypoint.Builder baru.

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

• Preferensi pemilihan rute sisi jalan
• Fitur persinggahan

Preferensi pemilihan rute sisi jalan

Anda dapat menetapkan preferensi untuk tiba di sisi jalan tertentu saat membuat titik jalan untuk perhentian. Anda dapat menentukan preferensi dengan salah satu dari dua cara: memilih sisi jalan yang sama, atau memberikan arah kedatangan.

Lebih memilih sisi jalan yang sama

Anda memberikan koordinat geografis titik jalan, lalu menetapkan tanda (setPreferSameSideOfRoad) yang menunjukkan bahwa Anda lebih suka tiba di sisi jalan yang sama dengan titik jalan—disesuaikan dengan trotoar terdekat.

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

Poin Penting: Dalam beberapa situasi, saat titik jalan disesuaikan ke sisi jalan terdekat, jalan terdekat mungkin bukan jalan yang tepat. Misalnya, mungkin ada jalan di sekitar sudut dari konsumen yang menunggu. Anda dapat mencegah hal ini terjadi dengan menggunakan setPreferredHeading, bukan setPreferSameSideOfRoad (lihat bagian berikutnya untuk mengetahui detailnya).

Menetapkan heading kedatangan

Anda memberikan koordinat geografis titik jalan, lalu memberikan arah 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 tertentu, pengemudi tidak dapat berhenti dengan aman (misalnya, area tinggi, feri, lokasi bawah tanah, dan area lain dengan akses terbatas). Fitur Persinggahan memindahkan titik jalan ke tempat terdekat jika lokasinya tidak sesuai untuk kendaraan berhenti. Saat Anda menetapkan setVehicleStopover ke true, titik jalan akan otomatis dipindahkan saat rute dihitung, jika lokasi alternatif tersedia.

Cara kerjanya

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

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