Przegląd
Jest to główna klasa pakietu Google Navigation SDK na iOS i udostępnia metody kontrolowania nawigacji do celu oraz uzyskiwania dostępu do informacji o trasie i postępach.
Ta klasa nie obsługuje klas podrzędnych.
W tej klasie nie można używać wątków. Wszystkie metody muszą być wywoływane z wątku głównego.
Publiczne funkcje członków | |
| (void) | – addListener: |
| Dodaje detektor. | |
| (BOOL) | – removeListener: |
| Usuwa detektor. | |
| (void) | – setDestinations:callback: |
| Ustawia wiele miejsc docelowych do nawigacji i zastępuje wcześniej ustawione miejsca docelowe. | |
| (void) | – setDestinations:routingOptions:callback: |
| Ustawia wiele miejsc docelowych do nawigacji i zastępuje wcześniej ustawione miejsca docelowe. | |
| (void) | – setDestinations:routeToken:callback: |
| Ustawia wiele miejsc docelowych do nawigacji, używając tokena trasy, aby nawigować po wstępnie wyliczonej trasie. | |
| (void) | – getRouteInfoForDestination:withRoutingOptions:callback: |
| Zwraca informacje o trasie na podstawie strategii routingu: domyślna najlepsza lub krótsza trasa. | |
| (wartość null GMSNavigationWaypoint *) | – continueToNextDestination |
| Rola wycofana. | |
| (void) | - clearDestinations |
| Usuwa wszystkie wcześniej ustawione miejsca docelowe i usuwa z mapy wszystkie obliczone trasy. | |
| (NSTimeInterval) | – timeToWaypoint: |
| Zwraca szacowany czas dotarcia do danego punktu na trasie lub wartość CLTimeIntervalMax, jeśli punkt pośredni nie należy do bieżącej trasy. | |
| (CLLocationLocation) | – distanceToWaypoint: |
| Zwraca szacowaną odległość do danego punktu na trasie lub CLLocationDISTANCEMax, jeśli punkt pośredni nie należy do bieżącej trasy. | |
| (void) | – setTransactionIDs:errorHandler: |
| Ustawia i rejestruje na serwerze identyfikatory trwających transakcji, które mają zastosowanie do zdarzeń nawigacji w trakcie bieżącej sesji nawigacji. | |
Usługi | |
| BOOL | avoidsHighways |
| Określa, czy podczas generowania tras do miejsc docelowych nie uwzględniać autostrad. | |
| BOOL | avoidsTolls |
| Określa, czy podczas generowania tras do miejsc docelowych unikać dróg płatnych. | |
| BOOL | avoidsFerries |
| Określa, czy unikać promów podczas generowania tras do miejsc docelowych. | |
| GMSNavigationLicensePlateRestriction * | licensePlateRestriction |
| Ustaw ograniczenie dla tablicy rejestracyjnej przy użyciu ostatniej cyfry numeru rejestracyjnego i kodu kraju. | |
| BOOL | guidanceActive |
| Określa, czy są obecnie włączone szczegółowe wskazówki dojazdu. | |
| BOOL | stopGuidanceAtArrival |
Określa, czy wskazówki mają być automatycznie zatrzymywane po wywołaniu funkcji -navigator:didInviteAtWaypoint:. | |
| NSTimeInterval | timeUpdateThreshold |
Minimalna zmiana szacowanego czasu do następnego miejsca docelowego, która spowoduje wywołanie metody navigator:didUpdateRemainingTime:. | |
| CLLocationLocation | distanceUpdateThreshold |
Minimalna zmiana szacowanej odległości do następnego miejsca docelowego, która spowoduje wywołanie metody navigator:didUpdateRemainingDistance:. | |
| NSTimeInterval | timeToNextDestination |
| Zwraca szacowany czas do następnego miejsca docelowego. | |
| CLLocationLocation | distanceToNextDestination |
| Zwraca szacowaną odległość do następnego miejsca docelowego. | |
| GMS NavigationOpóźnienieCategory | delayCategoryToNextDestination |
| Zwraca kategorię opóźnienia do następnego miejsca docelowego. | |
| GMSRouteLeg * | currentRouteLeg |
| Bieżący etap podróży. | |
| NSArray< GMSRouteLeg * > * | routeLegs |
| Tablica etapów trasy, z których każdy odpowiada ustawionemu celowi podróży. | |
| GMSPath * | traveledPath |
| Ścieżka, jaką pokonało urządzenie od czasu ostatniej aktywności wskazówkamiaktywnymi na YES. | |
| GMSNavigationVoiceGuidance | voiceGuidance |
| Określa, czy wskazówki głosowe mają być włączone dla informacji o natężeniu ruchu i ostrzeżenia zakręt po zakręcie. | |
| GMSVoiceGuidanceAudioDeviceType | audioDeviceType |
| Określa, na jakich urządzeniach audio mogą być odtwarzane wskazówki głosowe. | |
| BOOL | vibrationEnabled |
| Określa, czy urządzenie ma też wibrować przy odtwarzaniu alertów głosowych. | |
| BOOL | sendsBackgroundNotifications |
| Określa, czy aplikacja UILocalPowiadomienia zawierające wskazówki mają być wyświetlane, gdy aplikacja działa w tle. | |
| GMSNavigationLightingMode | suggestedLightingMode |
| Zalecany tryb oświetlenia na podstawie pory dnia i lokalizacji urządzenia. | |
| BOOL | shouldDisplayPrompts |
| Określa, czy powinny być wyświetlane prośby o informacje o korkach, lepsze trasy i incydenty. | |
| GMSNavigationSpeedAlertOptions * | speedAlertOptions |
| GMSNavigationSpeedAlertOptions służące do dostosowywania progów wyzwalania na potrzeby GMS NavigationSpeedAlertSeverity. | |
Powiązane funkcje | |
Pamiętaj, że nie są to funkcje składowe. | |
| typedef void(^ | GMSRouteStatusCallback )(stan trasy GMSRouteStatus) |
| Wywoływane, gdy zostanie znaleziona trasa od lokalizacji urządzenia do podanych miejsc docelowych lub nie uda się jej znaleźć z powodu podanego w polu RouteStatus. | |
| typedef void(^ | GMSRouteInfoCallback )(GMSNavigationRouteInfo *_Nullable routeInfo) |
| Wywoływane podczas obliczania informacji o trasie (szacowany czas dotarcia i odległość) do podanego punktu pośredniego. | |
| typedef void(^ | GMSNavigationTransactionIDErrorHandler )(NSError *error) |
| Wywoływane, jeśli nie udało się skonfigurować identyfikatorów transakcji za pomocą parametru setTransactionID. | |
Dokumentacja funkcji członka
| – (void) addListener: | (id< GMSNavigatorListener >) | słuchacz |
Dodaje detektor.
Słuchacz ma słabe odwołanie.
- Parametry:
-
detektor Obiekt zgodny z protokołem GMSNavigatorListener.
| – (BOOL) removeListener: | (id< GMSNavigatorListener >) | słuchacz |
Usuwa detektor.
- Parametry:
-
detektor Obiekt zgodny z protokołem GMSNavigatorListener.
- Zwroty:
- Zwraca wartość TAK, jeśli odbiornik został usunięty. Zwraca wartość NO, jeśli obiekt nie był detektorem.
| – (void) setDestinations: | (NSArray< GMSNavigationWaypoint * > *) | miejsca docelowe | |
| wywołanie zwrotne: | (GMSRouteStatusCallback). | callback (oddzwonienie) | |
Ustawia wiele miejsc docelowych do nawigacji i zastępuje wcześniej ustawione miejsca docelowe.
Podane wywołanie zwrotne zostanie wykonane z funkcją GMSRouteStatusOK, jeśli zostanie znaleziona trasa z lokalizacji urządzenia do podanego miejsca docelowego. Jeśli przed znalezieniem trasy zostanie ustawione nowe miejsce docelowe, żądanie zostanie anulowane, a wywołanie zwrotne zostanie wykonane z funkcją GMSRouteStatusCanceled. Jeśli z jakiegokolwiek innego powodu nie uda się znaleźć trasy, wywołanie zwrotne zostanie przekazane z odpowiednim stanem błędu.
Wywołanie zwrotne będzie zawsze wysyłane asynchronicznie w głównej kolejce.
| – (void) setDestinations: | (NSArray< GMSNavigationWaypoint * > *) | miejsca docelowe | |
| Opcje routingu: | (GMSNavigationRoutingOptions *) | routingOptions | |
| wywołanie zwrotne: | (GMSRouteStatusCallback). | callback (oddzwonienie) | |
Ustawia wiele miejsc docelowych do nawigacji i zastępuje wcześniej ustawione miejsca docelowe.
Zwrócone trasy są obliczane przy użyciu opcji routingu.
- Parametry:
-
miejsca docelowe Tablica docelowych punktów na trasie. routingOptions Opcje, które wpływają na logikę routingu (strategię routingu). wywołanie zwrotne Wywoływane, gdy zostanie znaleziona trasa z lokalizacji konsumenta do podanych miejsc docelowych lub nie uda się jej znaleźć z powodu podanego w atrybucie RouteStatus.
| – (void) setDestinations: | (NSArray< GMSNavigationWaypoint * > *) | miejsca docelowe | |
| trasaToken: | (NSString *) | routeToken | |
| wywołanie zwrotne: | (GMSRouteStatusCallback). | callback (oddzwonienie) | |
Ustawia wiele miejsc docelowych do nawigacji, używając tokena trasy, aby nawigować po wstępnie wyliczonej trasie.
Trasy będą takie same, zmienią się ustawienia lokalizacji kierowcy oraz warunki na drodze i natężeniu ruchu. Ponowne przekierowania będą nadal wykonywane na podstawie opcji routingu zakodowanego w tokenie.
Gdy użyjesz tokena trasy do uruchomienia sesji nawigacji, obsługiwane są tylko GMSNavigationTravelModeDriving i GMSNavigationTravelModeTwoWheeler. Aby skonfigurować tryb podróży, ustaw travelMode. Jeśli bieżący tryb podróży jest nieobsługiwany, połączenie nie powiedzie się. W wywołaniu zwrotnym zostanie zwrócony kod GMSRouteStatusTravelModeUnsupported.
- Parametry:
-
miejsca docelowe Tablica docelowych punktów na drodze powinna być taka sama jak miejsca docelowe podane w interfejsie RoutesPreferred API, aby uzyskać token trasy. routeToken Ciąg tokena trasy zwrócony przez interfejs RoutesPreferred API. Opcje routingu określone w interfejsie RoutesPreferred API są zakodowane w tym tokenie trasy i zostaną wykorzystane do ponownego wygenerowania wstępnie obliczonej trasy lub nowej trasy przy ponownym wyznaczeniu trasy. wywołanie zwrotne Wywoływane, gdy zostanie znaleziona trasa z lokalizacji konsumenta do podanych miejsc docelowych lub nie uda się jej znaleźć z powodu podanego w atrybucie RouteStatus.
| - (void) getRouteInfoForDestination: | (GMSNavigationWaypoint *) | miejsce docelowe | |
| withRoutingOptions: | (GMSNavigationRoutingOptions *) | routingOptions | |
| wywołanie zwrotne: | (GMSRouteInfoCallback) | callback (oddzwonienie) | |
Zwraca informacje o trasie na podstawie strategii routingu: domyślna najlepsza lub krótsza trasa.
Zwraca wartość nil, jeśli projekt nie ma uprawnień do wywołania tego interfejsu API.
- Parametry:
-
usługa docelowa | konto usługi docelowej Docelowy punkt na trasie. routingOptions Opcje używane do pobierania informacji o trasie. Strategia wyznaczania trasy i strategia alternatywnych tras są ignorowane, ponieważ ta metoda zwraca informacje o trasie dla wszystkich strategii określania trasy. wywołanie zwrotne Wywołanie zwrotne jest wykonywane po otrzymaniu informacji o trasach.
| - (wartość null GMSNavigationWaypoint *) continueToNextDestination |
Rola wycofana.
Zamiast wywoływać tę metodę, wywołaj jedną z metod -setDestinations:... z nową listą miejsc docelowych.
Powoduje wyświetlenie pierwszego miejsca docelowego z bieżącej listy miejsc docelowych. Po tej rozmowie przekierujemy Cię do wskazówek dojazdu do kolejnego miejsca docelowego (jeśli jest).
- Zwroty:
- wskazówki dotyczące punktu na trasie zmierzają w kierunku lub zero, jeśli nie ma już żadnych punktów pośrednich.
- Uwaga:
- Ta funkcja została wycofana. Użyj jednej z metod -setDestinations:...
| – (void) clearDestinations |
Usuwa wszystkie wcześniej ustawione miejsca docelowe i usuwa z mapy wszystkie obliczone trasy.
Jeśli wskazówki są aktywne, automatycznie je zatrzymają.
| – (NSTimeInterval) timeToWaypoint: | (GMSNavigationWaypoint *) | punkt pośredni |
Zwraca szacowany czas dotarcia do danego punktu na trasie lub wartość CLTimeIntervalMax, jeśli punkt pośredni nie należy do bieżącej trasy.
Ta wartość jest aktualizowana na podstawie bieżącej pozycji urządzenia, gdy włączone są wskazówki.
Zwraca wartość CLTimeIntervalMax, jeśli podany punkt pośredni nie jest celem podróży na bieżącej trasie.
| – (CLLocationLocation) distanceToWaypoint: | (GMSNavigationWaypoint *) | punkt pośredni |
Zwraca szacowaną odległość do danego punktu na trasie lub CLLocationDISTANCEMax, jeśli punkt pośredni nie należy do bieżącej trasy.
Ta wartość będzie aktualizowana na podstawie bieżącej pozycji urządzenia przy włączonym wskazówkach.
Zwraca wartość CLLocationDISTANCEMax, jeśli podany punkt pośredni nie jest celem podróży na bieżącej trasie.
| – (void) setTransactionIDs: | (NSArray< NSString * > *) | transactionIDs | |
| errorHandler: | (wartość null GMSNavigationTransactionIDErrorHandler) | errorHandler | |
Ustawia i rejestruje na serwerze identyfikatory trwających transakcji, które mają zastosowanie do zdarzeń nawigacji w trakcie bieżącej sesji nawigacji.
Identyfikatory transakcji zostaną wyczyszczone po zakończeniu sesji nawigacji.
- Parametry:
-
transactionIDs Identyfikatory transakcji, które mają zastosowanie do bieżącej sesji nawigacji. Identyfikator transakcji musi być unikalny dla każdej transakcji podlegającej rozliczeniu. Identyfikator pojedynczej transakcji może zawierać od 1 do 64 znaków. Lista może być pusta po zakończeniu transakcji (ale sesja nadal trwa). errorHandler Blok, który będzie wywoływany asynchronicznie w wątku głównym w przypadku wystąpienia błędu w przypadku nieprawidłowych identyfikatorów transakcji.
Dokumentacja funkcji „Znajomi i pokrewne”
– (typedef void(^ GMSRouteStatusCallback)(GMSRouteStatus routeStatus)) [related] |
Wywoływane, gdy zostanie znaleziona trasa od lokalizacji urządzenia do podanych miejsc docelowych lub nie uda się jej znaleźć z powodu podanego w polu RouteStatus.
- (typedef void(^ GMSRouteInfoCallback)(GMSNavigationRouteInfo *_Nullable routeInfo) [related] |
Wywoływane podczas obliczania informacji o trasie (szacowany czas dotarcia i odległość) do podanego punktu pośredniego.
- Parametry:
-
routeInfo Informacje o trasie do danego miejsca docelowego. Jeśli obliczenia się nie udają, wartość ta będzie równa zero.
- (typedef void(^ GMSNavigationTransactionIDErrorHandler)(NSError *error)) [related] |
Wywoływane, jeśli nie udało się skonfigurować identyfikatorów transakcji za pomocą parametru setTransactionID.
Więcej informacji znajdziesz w dokumentacji interfejsu API.
Dokumentacja usługi
- (BOOL) avoidsHighways [read, write, assign] |
Określa, czy podczas generowania tras do miejsc docelowych nie uwzględniać autostrad.
Wartość domyślna to NO.
- (BOOL) avoidsTolls [read, write, assign] |
Określa, czy podczas generowania tras do miejsc docelowych unikać dróg płatnych.
Wartość domyślna to NO.
- (BOOL) avoidsFerries [read, write, assign] |
Określa, czy unikać promów podczas generowania tras do miejsc docelowych.
Domyślna wartość to TAK.
– (GMSNavigationLicensePlateRestriction*) licensePlateRestriction [read, write, assign] |
Ustaw ograniczenie dla tablicy rejestracyjnej przy użyciu ostatniej cyfry numeru rejestracyjnego i kodu kraju.
Pozwala to ominąć niektóre rodzaje ograniczeń dróg na podstawie numerów rejestracyjnych. Będzie to miało zastosowanie tylko do wywołań setDestinations wykonanych po ustawieniu tej wartości. Najlepiej ustawić je od razu po wyświetleniu nawigatora.
Jeśli nie ma ograniczeń dotyczących tablic rejestracyjnych, ustaw wartość nil. Wartość domyślna to nil.
– (BOOL) guidanceActive [read, write, assign] |
Określa, czy są obecnie włączone szczegółowe wskazówki dojazdu.
Jeśli wskazówkiAktywne są ustawione na TAK, ale obecnie nie jest dostępna żadna trasa, rozpocznie się wyświetlanie wskazówek, gdy trasa stanie się dostępna. Jeśli ta właściwość zostanie wywołana lub dotrzesz do punktu pośredniego, ta właściwość będzie ustawiona na NO (NIE).
- (BOOL) stopGuidanceAtArrival [read, write, assign], |
Określa, czy wskazówki mają być automatycznie zatrzymywane po wywołaniu funkcji -navigator:didInviteAtWaypoint:.
Jeśli NIE, nagłówek i stopka nawigacji będą nadal wyświetlane po wejściu. W nagłówku nawigacji będzie nadal wyświetlany ostatni krok wskazówek, a stopka nawigacji będzie aktualizować pozostały czas i odległość do momentu osiągnięcia wartości 0. Dodatkowo aktualizacje -navigator:didUpdateDetailsTime i -navigator:didUpdateGuestHeight będą kontynuowane. Aby wyłączyć wskazówki i pozostałe aktualizacje czasu i odległości, ustaw guidanceActive na NIE.
Jeśli wybierzesz „TAK”, po przyjeździe na urządzenie guidanceActive automatycznie wybierze „NIE”.
Domyślna wartość to TAK.
– (NSTimeInterval) timeUpdateThreshold [read, write, assign] |
Minimalna zmiana szacowanego czasu do następnego miejsca docelowego, która spowoduje wywołanie metody navigator:didUpdateRemainingTime:.
Jeśli ma wartość NSTimeIntervalMax, wywołania zwrotne aktualizowania czasu są wyłączone. Jeśli jest ustawiona na wartość ujemną, stosowana jest domyślna wartość progowa wynosząca 1 sekundę. Domyślna wartość to 1 sekunda.
- Uwaga:
- Ta wartość jest ignorowana, jeśli żaden detektor nie zaimplementuje parametru
navigator:didUpdateRemainingTime:.
– (CLLocationLocation) distanceUpdateThreshold [read, write, assign] |
Minimalna zmiana szacowanej odległości do następnego miejsca docelowego, która spowoduje wywołanie metody navigator:didUpdateRemainingDistance:.
Jeśli ustawiona jest wartość CLLocationLocationMax, wywołania zwrotne aktualizowania odległości są wyłączone. Jeśli jest ustawiona na wartość ujemną, używany jest domyślny próg, który wynosi jeden metr. Domyślna wartość to jeden metr.
- Uwaga:
- Ta wartość jest ignorowana, jeśli żaden detektor nie zaimplementuje parametru
navigator:didUpdateRemainingDistance:.
– (NSTimeInterval) timeToNextDestination [read, assign] |
Zwraca szacowany czas do następnego miejsca docelowego.
Ta wartość będzie aktualizowana na podstawie bieżącej pozycji urządzenia przy włączonym wskazówkach.
Zwraca wartość CLTimeIntervalMax, jeśli nie jest dostępna żadna trasa.
– (CLLocationLocation) distanceToNextDestination [read, assign] |
Zwraca szacowaną odległość do następnego miejsca docelowego.
Ta wartość będzie aktualizowana na podstawie bieżącej pozycji urządzenia przy włączonym wskazówkach.
Zwraca wartość CLLocationDISTANCEMax, jeśli nie jest dostępna żadna trasa.
– (GMS NavigationOpóźnienieCategory) delayCategoryToNextDestination [read, assign] |
Zwraca kategorię opóźnienia do następnego miejsca docelowego.
Ta wartość będzie aktualizowana na podstawie bieżącej pozycji urządzenia przy włączonym wskazówkach.
Zwraca obiekt GMS NavigationParameterNoData, gdy nie ma dostępnej trasy lub dane o ruchu drogowym są niedostępne.
– (GMSRouteLeg*) currentRouteLeg [read, assign] |
Bieżący etap podróży.
Ten obiekt GMSRouteLeg będzie miał swoją pozycję początkową jako ostatnią znaną (bez drogi) pozycję urządzenia.
– (NSArray<GMSRouteLeg *>*) routeLegs [read, assign] |
Tablica etapów trasy, z których każdy odpowiada ustawionemu celowi podróży.
- (GMSPath*) traveledPath [read, assign] |
Ścieżka, jaką pokonało urządzenie od czasu ostatniej aktywności wskazówkamiaktywnymi na YES.
Ta ścieżka jest pusta, jeśli nie uruchomiono jeszcze wskazówek. Ścieżka składa się z lokalizacji wydzielonej na drodze zwracanej przez funkcję GMSRoadSnappedLocationProvider, ale w celu usunięcia zbędnych punktów. Na przykład przekształcenie następujących po sobie punktów współliniowych w jeden segment linii.
– (GMSNavigationVoiceGuidance) voiceGuidance [read, write, assign] |
Określa, czy wskazówki głosowe mają być włączone dla informacji o natężeniu ruchu i ostrzeżenia zakręt po zakręcie.
Wartość domyślna to GMS NavigationVoiceGuidanceAlertsAndGuidance.
– (GMSVoiceGuidanceAudioDeviceType) audioDeviceType [read, write, assign] |
Określa, na jakich urządzeniach audio mogą być odtwarzane wskazówki głosowe.
Wartość domyślna to GMSVoiceGuidanceAudioDeviceTypeBluetooth.
– (BOOL) vibrationEnabled [read, write, assign] |
Określa, czy urządzenie ma też wibrować przy odtwarzaniu alertów głosowych.
- (BOOL) sendsBackgroundNotifications [read, write, assign] |
Określa, czy aplikacja UILocalPowiadomienia zawierające wskazówki mają być wyświetlane, gdy aplikacja działa w tle.
Domyślna wartość to TAK.
– (GMSNavigationLightingMode) suggestedLightingMode [read, assign] |
Zalecany tryb oświetlenia na podstawie pory dnia i lokalizacji urządzenia.
– (BOOL) shouldDisplayPrompts [read, write, assign] |
Określa, czy powinny być wyświetlane prośby o informacje o korkach, lepsze trasy i incydenty.
Domyślna wartość to TAK.
– (GMSNavigationSpeedAlertOptions*) speedAlertOptions [read, write, assign] |
GMSNavigationSpeedAlertOptions służące do dostosowywania progów wyzwalania na potrzeby GMS NavigationSpeedAlertSeverity.
Za pomocą tej właściwości możesz dostosować wyrażone w procentach progi wyzwalania alertów dotyczących szybkości, zarówno w przypadku poważnych, jak i mniejszych alertów. Za pomocą tej metody możesz też dostosować próg wyzwalania na podstawie czasu dla ostrzeżenia o największej prędkości.
Jeśli ustawisz wartość nil, nie będziesz otrzymywać żadnych danych o prędkości, a w pakiecie NavSDK wyświetli się domyślny alert dotyczący prędkości: ostrzeżenie o prędkości wyświetla czerwony tekst, jeśli prędkość przekracza 5 mil lub 10 km/h, a przy prędkości powyżej 20 km/h wyświetla się biały tekst i czerwone tło.