Rozwiązanie na żądanie dotyczące przejazdów i dostaw jest obecnie dostępne tylko dla wybranych partnerów. Aby dowiedzieć się więcej, skontaktuj się z zespołem sprzedaży.

Ta strona została przetłumaczona przez Cloud Translation API.

Nawigator

interfejs publiczny Nawigator

Singiel, który udostępnia metody sterowania nawigacją.

Gwarantujemy, że wszystkie metody są bezpieczne w wątku, z wyjątkiem metod setAudioGuidance i setHeadsUpnotificationEnabled, które muszą być wywoływane w wątku UI.

Podsumowanie zagnieżdżonych zajęć

interfejs,	Navigator.ArrivalListener	Definiuje podpisy metod wywoływanych, gdy kierowca dotrze na punkt pośredni.
@interfejs	Navigator.AudioGuidance	AudioGuidance to zestaw flag służących do określania rodzajów alertów i wskazówek dźwiękowych, które mają być używane podczas nawigacji.
interfejs,	Navigator.RemainingTimeOrDistanceChangedListener	Definiuje podpisy metod, które są wywoływane w przypadku zmiany pozostałego czasu lub odległości do następnego miejsca docelowego.
interfejs,	Navigator.RouteChangedListener	Definiuje podpisy metod wywoływanych w przypadku zmiany trasy.
enum \| typ wyliczeniowy	Navigator.RouteStatus	Stan trasy to kod stanu reprezentujący wynik obliczenia trasy, do którego dostęp można uzyskać za pomocą wartości Przyszłość zwracanej przez funkcję `setDestination(Waypoint)`.

Podsumowanie metod publicznych

abstrakcja void	cleanup() Czyści wewnętrzny stan Nawigatora.
abstrakcja void	clearDestinations() Usuwa wszystkie ustawione wcześniej miejsca docelowe i usuwa z mapy obliczone trasy.
abstrakcja void	clearLicensePlateRestrictionInfo() Usuwa informacje o tablicy rejestracyjnej bieżącego kierowcy.
abstrakcja void	clearRemainingTimeOrDistanceChangedListener() Usuwa informacje o zmianie pozostałego czasu lub odległości.
abstrakcyjny Punkt pośredni	continueToNextDestination() Usuwa bieżące miejsce docelowe.
abstract ListenableResultFuture<RouteInfo>	fetchRouteInfo(Waypoint, opcje routingu RoutingOptions) Zwraca informacje o trasie dla tras na podstawie każdej wartości `RoutingOptions.RoutingStrategy`.
abstrakcyjny RouteSegment	getCurrentRouteSegment(), Zwraca bieżący etap podróży.
abstrat TimeAndDistance	getCurrentTimeAndDistance() Zwraca szacowany czas i odległość od bieżącej pozycji do aktualnego miejsca docelowego.
streszczenie Lista<RouteSegment>	getRouteSegments() Zwraca listę segmentów trasy.
abstrakcja Symulator	getSimulator() Zwraca obiekt symulatora do użycia podczas testowania.
abstract Lista<TimeAndDistance>	getTimeAndDistanceList() Zwraca listę czasów i odległości związanych z każdym miejscem docelowym na bieżącej trasie, określającą szacowany czas i odległość od bieżącej pozycji do każdego miejsca docelowego.
abstrat Lista<LatLng>	getTraveledRoute(), Zwraca trasę przebytą do tej pory podczas tej sesji ze wskazówkami (od ostatniego połączenia z numerem `startGuidance()`).
abstrakcyjna wartość logiczna	isGuidanceRunning() Zwraca wartość `true`, jeśli obecnie uruchomione są wskazówki.
abstrakcja void	setArrivalListener(detektor Navigator.ArrivalListener) Rejestruje detektor zdarzeń przyjazdu.
abstrakcja void	setAudioGuidance(ze wskazówkami) Określa, które typy wskazówek głosowych (w tym wibracje) mają być włączone.
abstract ListenableResultFuture<Navigator.RouteStatus>	setDestination(miejsce docelowe Waypoint, RoutingOptions, opcje routingu, DisplayOptions displayOptions) Ustawia jeden cel nawigacji, zastępując wszystkie wcześniej ustawione miejsca docelowe.
abstract ListenableResultFuture<Navigator.RouteStatus>	setDestination(miejsce docelowe Waypoint, opcje RoutingOptions) Ustawia jeden cel nawigacji, zastępując wszystkie wcześniej ustawione miejsca docelowe.
abstract ListenableResultFuture<Navigator.RouteStatus>	setDestination(miejsce docelowe Waypoint) Ustawia jeden cel nawigacji, zastępując wszystkie wcześniej ustawione miejsca docelowe.
abstract ListenableResultFuture<Navigator.RouteStatus>	setDestinations(miejsca docelowe na liście<Waypoint>, opcje RoutingOptions) Ustawia wiele miejsc docelowych do nawigacji i zastępuje wszystkie wcześniej ustawione miejsca docelowe.
abstract ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Lista<Waypoint> miejsc docelowych, RoutingOptions routingOptions, DisplayOptions displayOptions) Ustawia wiele miejsc docelowych do nawigacji i zastępuje wszystkie wcześniej ustawione miejsca docelowe.
abstract ListenableResultFuture<Navigator.RouteStatus>	setDestinations(lista miejsc docelowych<Waypoint>) Ustawia wiele miejsc docelowych do nawigacji i zastępuje wszystkie wcześniej ustawione miejsca docelowe.
abstrakcja void	setHeadsUpNotificationEnabled(wartość logiczna włączona) Określa, czy mają być wyświetlane powiadomienia z ostrzeżeniem.
abstrakcja void	setLicensePlateRestrictionInfo(int rawLicensePlateLastDigit, String LicensePlateCountryCode) Służy do ustawiania informacji o tablicy rejestracyjnej bieżącego kierowcy.
abstrakcja void	setRemainingTimeOrDistanceChangedListener(int timeChangeThresholdSeconds, int kindZmieńThresholdMeters, detektor Navigator.RemainingTimeOrDistanceChangedListener) Rejestruje detektor w przypadku, gdy pozostały czas lub odległość do miejsca docelowego zmieni się o większy niż określony próg.
abstrakcja void	setRouteChangedListener(detektor Navigator.RouteChangedListener) Rejestruje odbiornik zdarzeń zmiany trasy.
abstrakcja void	setSpeedingListener(SpeedingListener szybkośćingListener) Rejestruje wartość `SpeedingListener` jako wartość procentową powyżej ograniczenia prędkości, z którą kierowca porusza się obecnie.
abstrakcja void	startGuidance(intencja wznowienia intencji) To samo co `startGuidance()`, ale określenie intencji, która może posłużyć do wznowienia aplikacji z poziomu powiadomienia na pasku stanu w nawigatorze.
abstrakcja void	startGuidance() Jeśli miejsce docelowe zostało ustawione i wyznaczona dla niego trasa, rozpocznie się szczegółowa nawigacja na tej trasie.
abstrakcja void	stopGuidance() Zatrzymuje nawigację zakręt po zakręcie.

Metody publiczne

public abstract void cleanup ()

Czyści wewnętrzny stan Nawigatora.

Uwaga: wywołanie tej metody spowoduje anulowanie wszystkich oczekujących żądań wysłanych do: setDestinations(List).

public abstract void clearDestinations ()

Usuwa wszystkie ustawione wcześniej miejsca docelowe i usuwa z mapy obliczone trasy. Jeśli nawigacja jest uruchomiona, zostanie automatycznie zatrzymana.

public abstract void clearLicensePlateRestrictionInfo ()

Usuwa informacje o tablicy rejestracyjnej bieżącego kierowcy. Będzie to miało zastosowanie tylko do wywołań setDestination po ustawieniu tej wartości.

public abstract void clearRemainingTimeOrDistanceChangedListener ()

Usuwa informacje o zmianie pozostałego czasu lub odległości.

public abstract Waypoint continueToNextDestination ()

Usuwa bieżące miejsce docelowe. Po tej rozmowie wskazówki dojazdu zostaną wyświetlone, a informacje o starym miejscu docelowym nie będą dostępne.

Akcje powrotne

wskazówki dotyczące punktu pośredniego są teraz kierowane lub wartość null, jeśli nie było więcej punktów na trasie.

public abstract ListenableResultFuture<RouteInfo> fetchRouteInfo (punkt pośredni, RoutingOptions)

Zwraca informacje o trasie dla tras na podstawie każdej wartości RoutingOptions.RoutingStrategy. Parametr RoutingOptions.RoutingStrategy jest ignorowany, ponieważ ta metoda zwraca informacje o trasie dla wszystkich strategii routingu.

Uwaga: ta wartość jest obliczana ponownie przy każdym wywołaniu i może nie odpowiadać trasom aktualnie wykorzystywanym przez nawigację, ponieważ natężenie ruchu i inne czynniki mogły zostać w międzyczasie zaktualizowane.

Parametry

punkt drogi	docelowy punkt na trasie
routingOptions	opcje używane do pobierania informacji o trasie,

Akcje powrotne

zwrócona przyszłość

public abstrakcja RouteSegment getCurrentRouteSegment ()

Zwraca bieżący etap podróży. Ten segment trasy będzie miał swoją pozycję początkową jako ostatnią znaną (przypiętą do drogi) pozycję urządzenia.

Akcje powrotne

obiekt segmentu trasy lub null, jeśli nie ma bieżącej trasy.

public abstract TimeAndDistance getCurrentTimeAndDistance ()

Zwraca szacowany czas i odległość od bieżącej pozycji do aktualnego miejsca docelowego.

Akcje powrotne

obiekt czasu i odległości lub null, jeśli nie ma aktualnej trasy;

public abstract Lista<RouteSegment> getRouteSegments ()

Zwraca listę segmentów trasy. Miejsce docelowe każdego zwróconego segmentu będzie odpowiadać miejscu docelowemu ustawionemu przez setDestination(s).

public abstract Simulator getSimulator ()

Zwraca obiekt symulatora do użycia podczas testowania.

public abstract Lista<TimeAndDistance> getTimeAndDistanceList ()

Zwraca listę czasów i odległości związanych z każdym miejscem docelowym na bieżącej trasie, określającą szacowany czas i odległość od bieżącej pozycji do każdego miejsca docelowego.

public abstract Lista<LatLng> getTraveledRoute ()

Zwraca trasę przebytą do tej pory podczas tej sesji ze wskazówkami (od ostatniego wywołania funkcji startGuidance()). Zarejestrowana trasa składa się z lokalizacji połączonych z drogą, które zostałyby zwrócone przez RoadSnappedLocationProvider. Jest ona uproszczony, aby usunąć zbędne punkty, np. zamienić kolejne punkty współliniowe w jeden odcinek.

public abstract boolean isGuidanceRunning ()

Zwraca wartość true, jeśli obecnie uruchomione są wskazówki. Pamiętaj, że wskazówki będą działać dopiero po obliczeniu trasy do miejsca docelowego i wywołaniu funkcji startGuidance().

public abstract void setArrivalListener (Navigator.ArrivalListener słuchacz)

Rejestruje detektor zdarzeń przyjazdu. Zastępuje wszystkich wcześniej zarejestrowanych detektorów.

Uwaga: aby uniknąć wycieku pamięci, należy wywoływać setNavArrivalListener(null), gdy odbiornik nie jest już wymagany.

Parametry

detektor	do zarejestrowania się przez odbiornik. Można ustawić na `null`, aby usunąć wcześniej zarejestrowany detektor.

public abstract void setAudioGuidance (w wytycznych)

Określa, które typy wskazówek głosowych (w tym wibracje) mają być włączone. Domyślnie włączone są wibracje, głos i głos przez Bluetooth (jeśli są dostępne).

Metoda musi zostać wywołana w wątku UI.

Parametry

Wskazówki	kombinację flag `Navigator.AudioGuidance` określających typy wskazówek audio, które powinny być włączone

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint miejsce docelowe, RoutingOptions, opcje routingu, DisplayOptions displayOptions)

Parametry

usługa docelowa \| konto usługi docelowej	nowe miejsce docelowe do ustawienia
routingOptions	opcje, które posłużą do wygenerowania trasy
displayOptions	opcje, które zostaną użyte do wyświetlenia trasy

Akcje powrotne

zwrócona przyszłość

Rzuty

NullPointerException	jeśli dane miejsce docelowe ma wartość null

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint, opcje: RoutingOptions)

Ustawia jeden cel nawigacji, zastępując wszystkie wcześniej ustawione miejsca docelowe. Jeśli zostanie znaleziona trasa z lokalizacji użytkownika do danego miejsca docelowego, zwrócona w przyszłości będzie ustawiona wartość OK. Do wyświetlania trasy będzie używana domyślna wartość DisplayOptions.

Parametry

usługa docelowa \| konto usługi docelowej	nowe miejsce docelowe do ustawienia
Opcje	opcje, które posłużą do wygenerowania trasy

Akcje powrotne

zwrócona przyszłość

Rzuty

NullPointerException	jeśli dane miejsce docelowe ma wartość null

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestination (miejsce docelowe Waypoint)

Ustawia jeden cel nawigacji, zastępując wszystkie wcześniej ustawione miejsca docelowe. Jeśli zostanie znaleziona trasa z lokalizacji użytkownika do danego miejsca docelowego, zwrócona w przyszłości będzie ustawiona wartość OK. Do znalezienia trasy będzie używana domyślna wartość RoutingOptions, a do jej wyświetlania używana jest domyślna wartość DisplayOptions.

Parametry

usługa docelowa \| konto usługi docelowej	nowe miejsce docelowe do ustawienia

Akcje powrotne

zwrócona przyszłość

Rzuty

NullPointerException	jeśli dane miejsce docelowe ma wartość null

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestinations (Lista<Waypoint> miejsc docelowych, RoutingOptions)

Ustawia wiele miejsc docelowych do nawigacji i zastępuje wszystkie wcześniej ustawione miejsca docelowe. Jeśli zostanie znaleziona trasa z lokalizacji użytkownika do danego miejsca docelowego, zwrócona w przyszłości będzie ustawiona wartość OK. Do wyświetlania trasy będzie używana domyślna wartość DisplayOptions.

Parametry

miejsca docelowe	nowa lista miejsc docelowych do ustawienia
Opcje	opcje, które posłużą do wygenerowania trasy

Akcje powrotne

zwrócona przyszłość

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestinations (Lista<Waypoint> miejsc docelowych, RoutingOptions, opcje routingu, DisplayOptions displayOptions)

Parametry

miejsca docelowe	nowa lista miejsc docelowych do ustawienia
routingOptions	opcje, które posłużą do wygenerowania trasy
displayOptions	opcje, które zostaną użyte do wyświetlenia trasy

Akcje powrotne

zwrócona przyszłość

public abstract ListenableResultFuture<Navigator.RouteStatus> setDestinations (Lista<Waypoint> miejsc docelowych)

Ustawia wiele miejsc docelowych do nawigacji i zastępuje wszystkie wcześniej ustawione miejsca docelowe. Jeśli zostanie znaleziona trasa z lokalizacji użytkownika do danego miejsca docelowego, zwrócona w przyszłości będzie ustawiona wartość OK. Do znalezienia trasy będzie używana domyślna wartość RoutingOptions, a do jej wyświetlania używana jest domyślna wartość DisplayOptions.

Parametry

miejsca docelowe	nowa lista miejsc docelowych do ustawienia

Akcje powrotne

zwrócona przyszłość

public abstract void setHeadsUpNotificationEnabled (boolean enabled)

Określa, czy mają być wyświetlane powiadomienia z ostrzeżeniem. Domyślnie powiadomienia są włączone. Zdarzenia z ostrzeżeniem to zdarzenia związane ze wskazówkami, np. skręt, wyświetlane, gdy mapa nie jest widoczna.

Metoda musi zostać wywołana w wątku UI.

Parametry

włączone	flaga wskazująca, czy powiadomienia z ostrzeżeniem mają być włączone

public abstract void setLicensePlateRestrictionInfo (int rawLicensePlateLastDigit, String LicensePlateCountryCode)

Służy do ustawiania informacji o tablicy rejestracyjnej bieżącego kierowcy. Pozwala to omijać określone rodzaje ograniczeń na drogach na podstawie numerów rejestracyjnych. Będzie to miało zastosowanie tylko do wywołań setDestination po ustawieniu tej wartości. Najlepiej jest zadzwonić od razu po odtworzeniu nawigatora.

Parametry

rawLicensePlateLastDigit	Ostatnia cyfra na tablicy rejestracyjnej (musi mieścić się w zakresie od 0 do 9).
licensePlateCountryCode	Obecnie obsługujemy inne kraje z Indonezji (ID) i Brazylii (BZ) w przyszłości. Możesz podać te informacje z wyprzedzeniem.

public abstract void setRemainingTimeOrDistanceChangedListener (int timeChangeThresholdSeconds, int meetingChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener)

Rejestruje detektor w przypadku, gdy pozostały czas lub odległość do miejsca docelowego zmieni się o większy niż określony próg. Zastępuje wszystkich wcześniej zarejestrowanych detektorów.

Detektor może zostać wywołany w wyniku (na przykład) przemieszczania się użytkownika, zmiany warunków na drodze, zmiany trasy, zmiany miejsca docelowego lub informacji o pozostałym czasie i odległości.

Uwaga: aby uniknąć wycieku pamięci, należy wywoływać clearNavProgressionListener(), gdy odbiornik nie jest już wymagany.

Parametry

timeChangeThresholdSeconds	Jeśli bezwzględna zmiana pozostałego czasu w sekundach jest większa lub równa tej wartości, wywoływany jest detektor. Próg nie może być ujemny.
distanceChangeThresholdMeters	Jeśli bezwzględna zmiana pozostałej odległości w metrach jest większa lub równa tej wartości, wywoływany jest detektor. Próg nie może być ujemny.
detektor	do zarejestrowania się przez odbiornik. Wartość nie może być wartością `null`.

public abstract void setRouteChangedListener (Navigator.RouteChangedListener detektor)

Rejestruje odbiornik zdarzeń zmiany trasy. Zastępuje wszystkich wcześniej zarejestrowanych detektorów.

Uwaga: aby uniknąć wycieku pamięci, należy wywoływać setNavRouteChangeListener(null), gdy odbiornik nie jest już wymagany.

Parametry

detektor	do zarejestrowania się przez odbiornik. Można ustawić na `null`, aby usunąć wcześniej zarejestrowany detektor.

public abstract void setSpeedingListener (SpeedingListener speedingListener)

Rejestruje wartość SpeedingListener jako wartość procentową powyżej ograniczenia prędkości, z którą kierowca porusza się obecnie.

Jeśli skonfigurujesz null SpeedingListener lub nie skonfigurujesz żadnego z nich, nie będziesz otrzymywać żadnych plików danych o szybkim czasie działania.

Parametry

speedingListener

public abstract void startGuidance (Intent returnIntent)

To samo co startGuidance(), ale określenie intencji, która może posłużyć do wznowienia aplikacji z poziomu powiadomienia na pasku stanu w nawigatorze. Bez tej intencji nie można wznowić aplikacji z poziomu paska stanu.

Parametry

resumeIntent	intencji wznowienia aplikacji. W większości przypadków wartość zwracana przez funkcję `android.app.Activity#getIntent()` będzie odpowiednia.

public abstract void startGuidance ()

Jeśli miejsce docelowe zostało ustawione i wyznaczona dla niego trasa, rozpocznie się szczegółowa nawigacja na tej trasie. Jeśli trasa nie została jeszcze wytyczona, po jej przesłaniu zostaną uruchomione szczegółowe wskazówki.

Aby zatrzymać usługę nawigacji, musisz wyraźnie wywołać funkcję stopGuidance(). Usługa nawigacji nie zatrzyma się automatycznie po przyjeździe. Jeśli chcesz zatrzymać usługę nawigacji po dotarciu do celu, musisz wywołać stopGuidance() w funkcji NavArrivalListener.

Uwaga: ta metoda nie zmienia położenia elementu Camera.

public abstract void stopGuidance ()

Zatrzymuje nawigację zakręt po zakręcie.