Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Najczęstsze pytania

Szczegóły usługi

Jak powinno być wyświetlane powiadomienie o Warunkach korzystania z Navigation SDK?

W aplikacji musi być zaimplementowane okno z informacją o Warunkach korzystania z usługi Navigation SDK, które każdy kierowca musi zaakceptować. W tym oknie kierowca może zaakceptować Warunki korzystania z usługi. Plik tekstowy z warunkami jest dostarczany z pakietem Navigation SDK.

Na Androidzie użyj metody NavigationApi.showTermsAndConditionsDialog, aby wyświetlić okno z warunkami.

W iOS wywołaj GMSNavigationServices.showTermsAndConditionsDialogIfNeededWithCompanyName.

W jakich językach dostępne są wskazówki głosowe?

Wszystkie języki obsługiwane przez Mapy Google na urządzenia mobilne są automatycznie dostępne w pakiecie Navigation SDK. Urządzenie ma domyślny język systemu, którego aplikacja nie może zmienić. Aplikacja ma jednak dostęp do ponad 70 języków.

Czy kierunek jest zachowywany, gdy kierowca wyjdzie z trybu nawigacji?

Tak. Po uruchomieniu LocationListener w Androidzie będzie nadal działać w tle. Aplikacja nadal będzie przyciągać pozycję do drogi i utrzymywać kierunek.

Aby nadal otrzymywać aktualizacje lokalizacji dotyczące pozycji i kierunku w tle w iOS, zaimplementuj przyciąganie do drogi i ustaw wartość allowsBackgroundLocationUpdates na YES.

Czy podczas rozpoczynania lub zmieniania trasy dostępne są polilinie?

Tak. Gdy trasa zostanie utworzona lub zmieniona, interfejs RouteChangeListener udostępnia polilinie.

Czy użytkownicy aplikacji muszą mieć zainstalowaną aplikację Mapy Google na urządzenia mobilne?

Nie, pakiet Navigation SDK nie wymaga zainstalowania na urządzeniu aplikacji Mapy Google na urządzenia mobilne.

Czy pakiet Navigation SDK może identyfikować parkingi w pobliżu restauracji i innych ciekawych miejsc?

Nie, Navigation SDK nie udostępnia obecnie tej funkcji.

Czy pakiet Navigation SDK pokazuje kierunek ruchu na pasach podczas zbliżania się do punktu skrętu?

Tak. Kierunek ruchu jest dostępny i wyświetlany domyślnie.

Problemy

W Xcode 12 aplikacje nie są prawidłowo kompilowane na potrzeby symulatora. Jak rozwiązać ten problem?

Aby rozwiązać ten problem, otwórz ustawienia kompilacji projektu Xcode i dodaj arm64 do Excluded Architectures tylko w przypadku kompilacji „iOS Simulator”.

Więcej informacji znajdziesz w tym wątku na StackOverflow.

GMSMapView się nie wczytuje.

Jeśli GMSMapView się nie wczytuje:

Sprawdź, czy pakiet NavSDK jest włączony w konsoli Cloud.
Jeśli pakiet Nav SDK jest zainstalowany, ale Twój projekt nie korzysta z interfejsów Nav SDK API, usuń go z pliku binarnego.

Sieć

Jak pakiet Navigation SDK radzi sobie ze słabym połączeniem?: Pakiet Navigation SDK wstępnie zapisuje w pamięci podręcznej trasę każdej podróży. Wstępnie zapisane w pamięci podręcznej informacje obejmują dane o trasie na 15–20 minut i alternatywne trasy na wypadek, gdyby kierowca zjechał z trasy. Pakiet Navigation SDK przybliża pozycję za pomocą GPS-a i czujników urządzenia.
Czy jest dostępny tryb offline?: Nie, pakiet Navigation SDK nie oferuje obecnie trybu offline. Zapewnia jednak wstępnie zapisane w pamięci podręcznej informacje o podróży.

Dane

Czy przed rozpoczęciem trasy mogę pobrać wszystkie przystanki lub miejsca docelowe w podróży?

Tak. Aby pobrać wskazówki dojazdu na trasie w Androidzie, wywołaj funkcję Navigator.getRouteSegments().

W iOS wywołaj funkcję GMSNavigator.routeLegs(read).

Czy na początku trasy dostępne są szczegółowe wskazówki dojazdu?

Tak. Navigation SDK udostępnia listę segmentów trasy. Kierowca może też przesuwać palcem po karcie z wskazówkami w nagłówku, aby zobaczyć każdy manewr.

Jak szacowany czas dotarcia jest przekazywany użytkownikom aplikacji?

Aby podać użytkownikom aplikacji informacje o szacowanym czasie dotarcia na urządzeniach z Androidem:

Pobierz czas i odległość dla wszystkich punktów pośrednich za pomocą funkcji Navigator.getTimeAndDistanceList().
Przekaż te informacje do aplikacji klienckiej, tak jak w przypadku szacowanego czasu dotarcia na miejsce kierowcy.

Aby udostępnić użytkownikom aplikacji informacje o szacowanym czasie dotarcia na urządzeniach z iOS, wykonaj te czynności:

Pobierz odcinki trasy za pomocą funkcji Navigator.getRouteSegments().
Zadzwoń pod numer GMSNavigator.timeToNextDestination na każdym etapie podróży.
Przekaż informacje o czasie do aplikacji klienta, tak jak w przypadku szacowanego czasu przyjazdu kierowcy.

Czy za pomocą RoadSnappedLocationProvider można uzyskać aktualną lokalizację kierowcy, jeśli nawigacja nie jest na pierwszym planie?

Tak. Na Androidzie RoadSnappedLocationProvider domyślnie działa w tle.

Aby w iOS nawigacja działała w tle, zaimplementuj odbiornik GMSRoadSnappedLocationProviderListener i ustaw właściwość allowsBackgroundLocationUpdates na TRUE.

Czy pakiet Navigation SDK obsługuje geofencing?

Nie. W kontekście nawigacji remainingTimeOrdistanceChangeListener ma przewagę nad geofencingiem. Geofence może nie uwzględniać geometrii drogi i może nie być wyśrodkowany w dokładnym punkcie, do którego kierowca nawiguje.

Możesz przybliżyć tę funkcję za pomocą remainingTimeOrdistanceChangeListener.

Ustaw próg, aby określić częstotliwość wywołań zwrotnych.
Sprawdź pozostałą odległość do celu.

Jeśli na przykład ustawisz próg na 100 m, otrzymasz wywołanie zwrotne, gdy odległość od miejsca docelowego zmieni się o 100 m. W miarę zmniejszania się odległości możesz zmniejszać ten próg, aby częściej otrzymywać wywołania zwrotne. Następnie sprawdź pozostałą odległość, aby określić, czy jesteś wystarczająco blisko miejsca odbioru lub dostawy.

W iOS zaimplementuj odbiornik GMSNavigatorListener.didUpdateRemainingDistance, aby zarządzać odległością między powiadomieniami.

Czy mogę wyłączyć powiadomienia, gdy aplikacja Nawigacja działa w tle?

Tak. Na Androidzie używaj ikony Navigator.setHeadsUpNotificationEnabled, aby zarządzać powiadomieniami. Ta metoda ma argument logiczny. FALSEwyłącza powiadomienia, TRUE włącza powiadomienia.

W systemie iOS wyłącz powiadomienia w tle dotyczące lokalizacji przyciągniętych do drogi, ustawiając wartość GMSRoadSnappedLocationProvider.allowsBackgroundLocationUpdates na NO.

Aby wyłączyć przetwarzanie w tle w przypadku innych powiadomień związanych z lokalizacją, wywołaj funkcję GMSNavigator.sendsBackgroundNotifications(NO).

Dostosowywanie interfejsu

Czy mogę oznaczyć kolorami najlepszą opcję trasy?

Nie. Kolorowanie konkretnej opcji trasy nie jest obecnie obsługiwane.

Czy pakiet Navigation SDK może wyświetlać szacowany czas dotarcia do miejsca docelowego?

Tak. W Androidzie użyj tych metod:

Pobierz czas i odległość dla wszystkich punktów pośrednich za pomocą funkcji Navigator.getTimeAndDistanceList().
Ukryj szacowany czas dotarcia do bieżącego punktu trasy za pomocą elementu NavigationFragment.setEtaCardEnabled(false).
Wyświetl szacowany czas dotarcia do miejsca docelowego.

W iOS użyj tego kodu:

Zadzwoń do firmy GMSNavigator.routeLegs(read).
Na ostatnim etapie wywołaj funkcję GMSNavigator.timeToNextDestination.
Ukryj szacowany czas dotarcia do bieżącego punktu pośredniego, ustawiając wartość parametru MSMapView.settings.navigationFooterEnabled=NO na FALSE.
Wyświetl szacowany czas dotarcia do miejsca docelowego.

Jak ukryć aktualizacje szacowanego czasu dotarcia?

Karty z szacowanym czasem dotarcia możesz wyłączyć na te sposoby:

Na Androidzie użyj navigationView.setEtaCardEnabled(false).
Na urządzeniach z iOS użyj GMSMapView.settings.navigationFooterEnabled=NO.

Jakie dostosowania interfejsu są dostępne w przypadku kart nagłówka i stopki?

W Androidzie do ustawiania stylu koloru tła używa się StylingOptions. Aby ukryć lub wyświetlić nagłówek i stopkę, użyj funkcji członkowskich setHeaderEnabled i setFooterEnabled elementu NavigationFragment.

W systemie iOS użyj GMSMapView.settings.navigationHeaderPrimaryBackgroundColor, aby ustawić styl koloru tła. Aby ukryć lub wyświetlić nagłówek i stopkę, użyj właściwości navigationFooterEnabled i navigationHeaderEnabled elementu GMSUISettings.

Routing

Czy mogę podać kierowcy konkretną trasę lub usunąć trasy alternatywne?

Nie. Domyślnie podawanych jest kilka tras, a najszybsza z nich ma priorytet. Na trasę domyślną możesz wpływać, dodając do żądania preferencje, np. „unikaj autostrad i dróg płatnych”. Dodanie punktów pośrednich również wpływa na trasę.

Czy mogę wyświetlać użytkownikowi aplikacji inną etykietę miejsca docelowego niż domyślna lokalizacja docelowa?

Tak. Na urządzeniu z Androidem utwórz Marker z niestandardowym tytułem miejsca docelowego oraz szerokością i długością geograficzną. Pakiet SDK Navigation wyświetla niestandardowy tytuł i współrzędne na NavigationMap.

W iOS tworzysz i wyświetlasz GMSMarker dla miejsca docelowego.

Czy mogę używać pakietu Navigation SDK do śledzenia odchyleń od wyznaczonej trasy?

Tak. Na urządzeniach z Androidem użyj Navigator.setRouteChangedListener, aby otrzymywać powiadomienia o zmianach trasy lub o nowych rekomendacjach:

Zarejestruj odbiornik, który sprawdza pozycję urządzenia na trasie za pomocą metody Navigator.setRouteChangedListener.
Dodaj kod do modułu obsługi zdarzeń wywołania zwrotnego, onRouteChanged:
- Wysyłanie do użytkownika aplikacji wiadomości z aktualnymi informacjami o szacowanym czasie dotarcia i odległości.
- śledzić lokalizację urządzenia;
- [opcjonalnie] Dodaj inne funkcje wymagane przez aplikację, aby obsługiwać sytuacje, w których kierowca zjedzie z wyznaczonej trasy.

W iOS użyj GMSNavigator i jego odbiorników, aby otrzymywać powiadomienia o zmianie trasy lub zaleceniu nowej trasy:

W kontrolerze widoku mapy zaimplementuj protokoły GMSNavigatorListener i GMSRoadSnappedLocationProviderListener.
WdrożenieGMSNavigatorListener.navigatorDidChangeRoute
Uzyskaj dostęp do nowej trasy za pomocą właściwości routeLegs i currentRouteLeg elementu GMSNavigator.

Czy kierowca może wyłączyć nawigację bez ukończenia trasy?

Tak. Na Androidzie wywołaj metodę Navigator.stopGuidance(), aby zatrzymać nawigację.

W iOS wywołaj funkcję GMSNavigator.clearDestinations.

Czy pakiet Navigation SDK obsługuje wyznaczanie tras i nawigację dla ciężarówek i dużych pojazdów?

Tak. W przypadku wyznaczania tras dla dużych pojazdów (LVR) możesz przekazywać do pakietu Navigation SDK tokeny trasy dla ciężarówek wygenerowane przez interfejs Routes API lub Route Optimization API. Pakiet SDK zapewnia nawigację krok po kroku z informacjami o trasie (ograniczenia dotyczące wysokości, wagi, materiałów niebezpiecznych i ciężarówek) oraz zachowuje fizyczny profil pojazdu podczas dynamicznego wyznaczania nowej trasy. Więcej informacji znajdziesz w artykule Wyznaczanie tras dla dużych pojazdów.

Symulator

Czy symulator obsługuje zmiany trasy?

Tak. Na Androidzie wywołaj funkcję simulateLocationsAlongNewRoute, aby zasymulować podróż, która obejmuje zmianę trasy. Metoda simulateLocationsAlongExistingRoute ignoruje zmiany w istniejącej trasie.

W iOS użyj GMSLocationSimulator.simulateAlongNewRouteToDestinations, aby zasymulować podróż, która obejmuje zmianę trasy. Jeśli nie przewidujesz żadnych zmian trasy, możesz użyć GMSLocationSimulator.simulateLocationsAlongExistingRoute lub GMSLocationSimulator.simulateAlongNewRouteToDestinations.

Przepływy pracy

Jak odrzucić powiadomienie po zamknięciu aktywności zawierającej fragment nawigacji?

Powiadomienie o nawigacji pozostaje widoczne podczas nawigacji, gdy aktywność jest zamknięta. Gdy pojazd dotrze do celu, nawigacja się zatrzyma, a powiadomienie zniknie.

Aby obsługiwać kliknięcia powiadomienia, użyj Navigator.startGuidance(intent resumeIntent). resume intent jest wywoływane, gdy użytkownik aplikacji kliknie powiadomienie. Zwykle funkcja Navigator.startguidance(getIntent()) jest wywoływana z głównego działania, które jest ponownie wywoływane, gdy użytkownik aplikacji kliknie powiadomienie.

Usługi mobilne

Czym różni się korzystanie z pakietu Navigation SDK w przypadku klientów usług mobilności?

Usługi mobilne Google Maps Platform to zbiór interfejsów API i pakietów SDK, które pomagają zaspokajać potrzeby przedsiębiorstw z branży transportowej i logistycznej. Klienci korzystający z usług mobilnych używają zwykle pakietu Navigation SDK w połączeniu z powiązanymi usługami do optymalizacji tras, wysyłania zleceń, śledzenia zadań, analizy floty i innych celów. W przypadku klientów korzystających z usług mobilnych pakiet SDK do nawigacji jest też rozliczany inaczej. Więcej informacji znajdziesz w dokumentacji usług mobilnych.

Produkty związane z mobilnością są dostępne tylko dla wybranych klientów. Aby uzyskać więcej informacji, skontaktuj się z przedstawicielem handlowym.

Skąd mam wiedzieć, czy jestem klientem usług mobilnych?

Jeśli nie masz pewności, czy wdrażasz Navigation SDK jako klient Mobility Services, poszukaj w kodzie wywołania ReportBillableEvent. Tylko klienci usług mobilnych powinni wywoływać metodę ReportBillableEvent.

Jak rozliczany jest pakiet Navigation SDK w przypadku klientów korzystających z usług mobilności?

W przypadku klientów korzystających z usług mobilności rozliczenia i ceny pakietu Navigation SDK zależą od umowy o świadczenie usług zawartej z Google Maps Platform. Informacje o tym, jak sprawdzić, czy za implementację usług mobilnych naliczane są prawidłowe opłaty, znajdziesz w sekcji Weryfikacja rozliczeń. Aby uzyskać więcej informacji o płatnościach za usługi mobilne, skontaktuj się z przedstawicielem handlowym.

Których interfejsów API pakietu Navigation SDK powinni używać tylko klienci usług mobilności?

W pakiecie Navigation SDK jest kilka interfejsów API, które są przeznaczone wyłącznie dla klientów usług mobilności, którzy są rozliczani przez Google za każdą transakcję. Jeśli nie jesteś klientem usług mobilności, następujące metody są środowiskiem bezobsługowym:

Czy jako klient Usług mobilności mogę też używać implementacji pakietu Navigation SDK, która nie jest związana z Usługami mobilności?

Tak, klienci Mobility Services mogą korzystać zarówno z implementacji pakietu Navigation SDK w ramach Mobility Services, jak i z implementacji tego pakietu poza Mobility Services. W aplikacji możesz jednak używać tylko jednego typu implementacji naraz. Musisz też utworzyć nowy projekt w chmurze Google Cloud, konto rozliczeniowe i klucz interfejsu API, które będą oddzielone od tych, których używasz w implementacji usług mobilności. Więcej informacji znajdziesz w przeglądzie konfiguracji pakietu Navigation SDK.

Aby dowiedzieć się więcej o korzystaniu z implementacji pakietu Navigation SDK innej niż Usługi mobilne, w tym o migrowaniu aplikacji z jednego typu implementacji na inny, skontaktuj się z opiekunem klienta w Google.

Uwaga: jeśli nie jesteś klientem usług mobilnych i chcesz dowiedzieć się więcej o kolekcji interfejsów API i pakietów SDK usług mobilnych, skontaktuj się z zespołem sprzedaży Google Maps Platform.