Wyznaczanie trasy do punktów nawigacyjnych

Pakiet SDK do nawigacji na Androida oferuje ulepszone sposoby określania punktów pośrednich, co zapewnia dokładniejsze wyznaczanie trasy i lepsze wrażenia z przyjazdu, zwłaszcza w przypadku miejsc docelowych z wieloma wejściami lub konkretnymi punktami nawigacyjnymi. Możesz wyznaczać trasy do dokładnych lokalizacji, korzystając z navigationPointToken lub łącząc współrzędne geograficzne z identyfikatorem miejsca, aby uzyskać dodatkowe informacje. Wyróżnianie miejsca docelowego będzie nadal działać w stosownych przypadkach.

Tło

Przed wersją 7.4 można było zdefiniować Waypoint za pomocą współrzędnych geograficznych lub identyfikatora miejsca. Chociaż czasami jest to skuteczne, kierowanie wyłącznie na szerokość i długość geograficzną może czasami prowadzić do nieoptymalnych punktów odbioru lub wysiadania, zwłaszcza w przypadku dużych obiektów, parków lub budynków z wieloma wejściami. Wynik może zostać przyciągnięty do najbliższego segmentu drogi, który może nie być najwygodniejszym lub najdokładniejszym punktem nawigacyjnym.

Ulepszone opcje punktu pośredniego rozwiązują ten problem, ponieważ umożliwiają podanie większej ilości kontekstu.

Używanie tokena punktu nawigacyjnego

Aby uzyskać najdokładniejsze wyznaczanie trasy do konkretnych punktów nawigacyjnych, takich jak wejścia, rampy załadunkowe lub wyznaczone miejsca odbioru, możesz użyć parametru navigationPointToken. Ten token uzyskuje się przez wywołanie metody destinations interfejsu Geocoding API. Reprezentuje konkretny punkt nawigacyjny związany z miejscem, do którego można wyznaczyć trasę.

Aby określić token punktu nawigacyjnego:

1. Uzyskaj navigationPointToken z odpowiedzi metody Destinations interfejsu Geocoding API.
2. Utwórz Waypoint za pomocą metody setNavigationPointToken() w konstruktorze.

Uwaga: podczas korzystania z właściwości setNavigationPointToken() nie można jednocześnie używać właściwości setLatLng() ani setPlaceIdString(). Te metody wykluczają się wzajemnie z 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()

Łączenie identyfikatora miejsca z szerokością i długością geograficzną

Od wersji 7.4 podczas tworzenia Waypoint możesz podać zarówno identyfikator miejsca, jak i współrzędne geograficzne. Ta metoda jest przydatna, gdy chcesz określić dokładny punkt (szerokość i długość geograficzną), a jednocześnie podać kontekst całego miejsca (identyfikator miejsca). Dzięki temu pakiet Navigation SDK może zapewnić lepsze wrażenia po dotarciu na miejsce, wyróżniając budynek docelowy lub pokazując pobliskie ciekawe miejsca powiązane z identyfikatorem miejsca.

// 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()

Uwagi

Jeśli podasz zarówno placeId, jak i latlng:

• Trasa jest przeznaczona głównie dla określonego latlng.
• placeId służy jako kontekst, który zwiększa komfort przyjazdu.
• Wycofanie: jeśli pakiet SDK stwierdzi, że podany atrybut placeId odpowiada funkcji, która jest zbyt oddalona od podanego atrybutu latlng, atrybut placeId zostanie zignorowany. W takim przypadku trasa będzie prowadzić tylko do latlng, a ulepszenia dotyczące miejsca docelowego nie będą dostępne.

Podsumowanie prawidłowych konfiguracji punktów pośrednich

Metoda	setLatLng()	setPlaceIdString()	setNavigationPointToken()	Działanie routingu	Wyróżnianie miejsca docelowego
tylko współrzędne geograficzne szerokości i długości,	zestaw	brak	brak	Trasy do segmentu drogi najbliższego określonych współrzędnych	Wyświetlane, jeśli miejsce docelowe można określić z dużą pewnością.
Tylko identyfikator miejsca	brak	zestaw	brak	Trasy do domyślnego punktu nawigacyjnego dla identyfikatora miejsca	Z identyfikatora miejsca
Tylko token punktu nawigacyjnego	brak	brak	zestaw	trasy do dokładnego punktu nawigacyjnego reprezentowanego przez token;	Z miejsca docelowego określonego w pierwotnym żądaniu metody destinations interfejsu Geocoding API
Połączenie współrzędnych geograficznych szerokości i długości z identyfikatorem miejsca	zestaw	zestaw	brak	Trasy do segmentu drogi najbliższego określonych współrzędnych	na podstawie identyfikatora miejsca, ale nie jest wyświetlana, jeśli identyfikator miejsca jest zbyt oddalony od współrzędnych geograficznych.