Mengelola titik jalan

Pemberitahuan: fromLatLng() dan fromPlaceId() tidak digunakan lagi, tetapi akan tetap tersedia tanpa update lebih lanjut. Sebaiknya 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 perhentian

Preferensi pemilihan rute sisi jalan

Fitur ini memungkinkan Anda memastikan bahwa 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 kedatangan.

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—dihubungkan ke trotoar terdekat.

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

Poin Penting: Dalam beberapa situasi, saat titik jalan disambungkan ke sisi jalan terdekat, jalan terdekat mungkin bukan jalan yang tepat. Misalnya, mungkin 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 judul kedatangan

Anda memberikan koordinat geografis titik jalan, lalu memberikan arah kedatangan (setPreferredHeading) yang cocok dengan arah aliran 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 perhentian sementara

Di tempat tertentu, pengemudi tidak dapat berhenti dengan aman (misalnya, area yang ditinggikan, feri, lokasi bawah tanah, dan area lain dengan akses terbatas ). Fitur Perhentian memindahkan titik jalan ke tempat terdekat jika lokasinya tidak cocok untuk kendaraan 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 perhentian 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()