Merutekan ke titik navigasi

Navigation SDK for Android menawarkan cara yang lebih baik untuk menentukan titik jalan, atau titik navigasi, sehingga memberikan perutean yang lebih akurat dan pengalaman kedatangan yang lebih baik, terutama untuk tujuan dengan beberapa pintu masuk atau titik navigasi tertentu. Anda dapat merutekan ke lokasi presisi menggunakan navigationPointToken, yang merupakan string yang mengenkode lokasi dan konteks rute tambahan. Anda juga dapat menggabungkan koordinat lintang dan bujur dengan ID Tempat untuk menambahkan konteks.

Latar belakang

Sebelum v7.4, Anda dapat menentukan Waypoint menggunakan koordinat lintang dan bujur atau ID Tempat. Meskipun terkadang efektif, perutean hanya ke garis lintang dan bujur terkadang dapat menyebabkan titik keluar atau penjemputan yang kurang optimal, terutama untuk tempat besar, taman, atau bangunan dengan beberapa pintu masuk. Hasilnya mungkin akan menyesuaikan dengan segmen jalan terdekat, yang mungkin bukan titik navigasi yang paling nyaman atau benar.

Opsi titik jalan yang ditingkatkan mengatasi hal ini dengan memungkinkan lebih banyak konteks diberikan.

Menggunakan token titik navigasi

Untuk perutean yang paling akurat ke titik navigasi tertentu seperti pintu masuk, tempat bongkar muat, atau area pengambilan yang ditentukan, Anda dapat menggunakan navigationPointToken. Token ini diperoleh dengan memanggil metode destinations API Geocoding. Menunjukkan titik navigasi spesifik yang dapat dirutekan dan terkait dengan suatu tempat.

Untuk menentukan token Titik Navigasi:

1. Dapatkan navigationPointToken dari respons Destinations method of the Geocoding API.
2. Buat Waypoint menggunakan metode setNavigationPointToken() di builder.

Catatan: Saat menggunakan setNavigationPointToken(), Anda tidak dapat menggunakan setLatLng() atau setPlaceIdString() secara bersamaan. Metode ini tidak dapat muncul bersamaan dengan setNavigationPointToken().

// Assuming 'navPointToken' is a String obtained from the destinations method of the Geocoding API
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithToken = Waypoint.builder()
    .setTitle(destinationName)
    .setNavigationPointToken(navPointToken)
    .build();

// Use this waypoint in navigator.setDestinations()

Menggunakan token titik navigasi dan token rute

Anda dapat mengambil token titik navigasi melalui Geocoding API, mengambil token rute dari Routes API, lalu meneruskan token titik navigasi dan token rute ke Navigation SDK. Hal ini berguna dalam skenario seperti layanan transportasi online atau pengiriman, saat Anda menggunakan Routes API untuk menghitung harga perjalanan dan Anda menginginkan presisi token titik navigasi.

Token rute memengaruhi rute yang dipilih oleh Navigation SDK ke rute yang digunakan untuk harga. Hal ini mengurangi risiko rute yang lebih panjang atau lebih pendek digunakan untuk perjalanan, yang dapat menimbulkan "kejutan harga".

Lihat dokumentasi Routes API untuk mengetahui informasi selengkapnya tentang menentukan lokasi menggunakan token titik navigasi dan membuat token rute. Lihat "Merencanakan rute" untuk mempelajari cara merencanakan rute menggunakan token rute.

Diagram ini menunjukkan cara aplikasi layanan transportasi online atau pengiriman menggunakan token titik navigasi dan token rute secara bersamaan:

Menggabungkan ID Tempat dan lintang serta bujur

Mulai v7.4, Anda dapat memberikan kedua ID Tempat dan koordinat garis lintang dan bujur saat membuat Waypoint. Metode ini berguna saat Anda ingin menentukan titik yang tepat (lat/lng) sambil tetap memberikan konteks tempat secara keseluruhan (ID Tempat). Hal ini memungkinkan Navigation SDK memberikan pengalaman kedatangan yang lebih kaya dengan menandai bangunan tujuan atau menampilkan tempat menarik terdekat yang terkait dengan ID Tempat.

// Assuming 'placeId' is the Place ID String
// Assuming 'lat' and 'lng' are the double values for latitude and longitude
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithPlaceIdAndLatLng = Waypoint.builder()
    .setTitle(destinationName)
    .setPlaceIdString(placeId)
    .setLatLng(lat, lng)
    .build();

// Use this waypoint in navigator.setDestinations()

Pertimbangan

Jika Anda memberikan placeId dan latlng:

• Rute terutama menargetkan latlng yang ditentukan.
• placeId digunakan sebagai konteks untuk meningkatkan pengalaman kedatangan.
• Pengalihan: Jika SDK menentukan bahwa placeId yang diberikan sesuai dengan fitur yang terlalu jauh dari latlng yang diberikan, placeId akan diabaikan. Dalam skenario ini, perutean hanya akan dilanjutkan ke latlng, dan peningkatan pengalaman kedatangan khusus tempat tidak akan tersedia.

Ringkasan konfigurasi titik jalan yang valid