Dzięki integracji pakietu SDK nawigacji na Androida Twoja aplikacja może wykraczać poza zewnętrzny widok mapy. Dzięki nawigacji w Mapach Google aplikacja może oferować dynamiczne pobieranie i raportowanie danych o podróży kierowcy. Z tego przewodnika dowiesz się, jak uruchamiać aplikacje demonstracyjne nawigacji, które są dostępne na GitHubie.
Przygotuj się
Aby rozpocząć korzystanie z pakietu Navigation SDK, przygotuj te elementy.
przedstawiciel Google Maps Platform, który zapewnia dostęp do tych usług:
- Klucz interfejsu API udostępniony do użytku z pakietem SDK nawigacji. Musisz podać swój identyfikator projektu, który znajdziesz pod nazwą projektu w panelu głównym Google Cloud Console.
- Artefakt pakietu SDK. Upewnij się, że w Twoim projekcie jest używany pakiet Maven na potrzeby pakietu SDK nawigacji.
- Dla projektów korzystających z wersji 4.99.0 lub starszej. Jeśli nie możesz używać narzędzia Maven, możesz pobrać skompresowany artefakt z udostępnianego Dysku Google. Plik biblioteki statycznej to plik .aar w katalogu
libs/
zawierającym pakiet SDK nawigacji jako pakiet AAR. - Co najmniej jedna z aplikacji demonstracyjnych.
- Android Studio – zalecane środowisko programistyczne do tworzenia aplikacji za pomocą pakietu SDK nawigacji.
Ta dokumentacja jest przeznaczona dla osób, które znają pojęcia związane z programowaniem na Androida i programowaniem zorientowanym na obiekty. Musisz też spojrzeć na Mapy Google z perspektywy użytkownika.
Pobierz aplikacje w wersji demonstracyjnej
Google udostępnia 2 aplikacje, które w zależności od Twojego poziomu doświadczenia pomogą Ci zrozumieć, co oprócz interfejsów API Map Google oferuje pakiet Navigation SDK. Programiści, którzy znają interfejsy API Map Google, mogą skupić się na prezentacji funkcji Nawigacji Google. Z pewnością spodobają się one deweloperom obu projektów.
Od pakietu Navigation SDK na Androida w wersji 4.1 poniższe aplikacje demonstracyjne są dostępne do pobrania z GitHub.
Prezentacja nawigacji Google: prezentacja integracji zachowań i widoków interfejsu API w zależności od wrażeń użytkownika podczas sesji nawigacji z przewodnikiem.
Prezentacja Map Google: pokazuje indywidualne zachowania interfejsu
GoogleMap
, dzięki czemu możesz dostosować charakter i sposób wyświetlania map.
Uwaga na temat korzystania z narzędzia Maven
Aplikacje demonstracyjne są skonfigurowane tak, aby pobierały artefakt pakietu SDK ze zdalnego repozytorium Maven przy użyciu wtyczki Artifact Registry w Gradle. Aby uzyskać dostęp do pakietu SDK, postępuj zgodnie z instrukcjami konfigurowania projektu.
Prezentacja nawigacji Google
Najnowsza wersja demonstracyjna nawigacji Google jest dostępna w serwisie GitHub.
Tworzę
W Android Studio zaimportuj aplikację demonstracyjną i zezwól na uruchomienie Gradle.
Otwórz
local.defaults.properties
i zaktualizuj wartość właściwościMAPS_API_KEY
:MAPS_API_KEY=YOUR_API_KEY
Kliknij Utwórz i sprawdź szczegóły implementacji pakietu SDK.
Zwróć uwagę na kod implementacji w klasie Java.
W pliku XML układu zwróć uwagę na projekt układu i tekst.
W pliku
build.gradle
zanotuj pakiet SDK w zależnościach.
Więcej informacji o dodawaniu klucza interfejsu API do pliku manifestu znajdziesz w dokumentacji wtyczki Gradle obiektów tajnych.
Uruchomiono
Podłącz urządzenie z Androidem do komputera lub użyj emulatora.
- Urządzenie z Androidem – zapoznaj się z instructions, aby włączyć opcje programisty na urządzeniu z Androidem i skonfigurować system w taki sposób, aby wykrywał urządzenie.
- Emulator – mdash; Menedżer urządzeń wirtualnych (AVD) Android pozwala skonfigurować urządzenie wirtualne. Wybierając emulator, pamiętaj, aby wybrać obraz zawierający interfejsy API Google.
W Android Studio kliknij opcję menu Uruchom (lub ikonę przycisku odtwarzania), a następnie wybierz cel wdrożenia.
Po utworzeniu i uruchomieniu aplikacja wyświetla użytkownikowi stronę docelową z listą opcji.
Opcje NavViewActivity i NavFragmentActivity
Nowi użytkownicy pakietu NavSDK prawdopodobnie uznają te 2 opcje za najskuteczniejsze.
Opcja 1: NavViewActivity
prezentuje zachowania za pomocą elementów NavigationView
w połączeniu z Navigator
.
Opcja 2. Druga opcja o nazwie NavFragmentActivity
przedstawia zachowania przy użyciu symbolu SupportNavigationFragment
obok elementu Navigator
.
Po kliknięciu jednej z tych opcji zobaczysz te informacje:
- interfejs nawigacji
- przycisk „Ustaw miejsce docelowe” w menu aplikacji;
- nakładka, z którą można wchodzić w interakcje, aby dynamicznie wywoływać metody w interfejsie API,
- rozszerzone menu z większą liczbą opcji
Aby rozpocząć, kliknij Ustaw miejsce docelowe i wybierz adres. Następnie aplikacja symuluje trasę z Twojej bieżącej lokalizacji do tego adresu. Dzięki nakładce paneli sterowania możesz sprawdzić, co się dzieje, gdy wywołujesz interfejs API. Możesz na przykład kliknąć View Methods (Wyświetl metody), aby wymusić tryb nocny SDK i sprawdzić, jak to wygląda.
Opcja ReplacepingMapAndNavActivity
SwappingMapAndNavActivity
pokazuje następujące typowe wzorce:
- wyświetlając
MapView
- zamień na
NavigationView
po rozpoczęciu nawigacji - powrót do
MapView
po zakończeniu nawigacji
Prezentacja Map Google
Najnowsza wersja demonstracyjna nawigacji Google jest dostępna w serwisie GitHub.
Tworzę
W Android Studio zaimportuj aplikację demonstracyjną i zezwól na uruchomienie Gradle.
Otwórz
local.defaults.properties
i zaktualizuj wartość właściwościMAPS_API_KEY
:MAPS_API_KEY=YOUR_API_KEY
Kliknij Utwórz i sprawdź szczegóły implementacji pakietu SDK.
Zwróć uwagę na kod implementacji w klasie Java.
W pliku XML układu zwróć uwagę na projekt układu i tekst.
W pliku
build.gradle
zanotuj pakiet SDK w zależnościach.
Więcej informacji o dodawaniu klucza interfejsu API do pliku manifestu znajdziesz w artykule o wtyczkach tajnych gradle.
Uruchomiono
Podłącz urządzenie z Androidem do komputera lub użyj emulatora.
- Urządzenie z Androidem. Zapoznaj się z instructions, aby włączyć opcje programisty na urządzeniu z Androidem i skonfigurować system tak, aby wykrywał urządzenie.
- Emulator Użyj Menedżera urządzeń wirtualnych (AVD) Android, aby skonfigurować urządzenie wirtualne. Wybierając emulator, pamiętaj, aby wybrać obraz zawierający interfejsy API Google.
W Android Studio kliknij opcję menu Uruchom (lub ikonę przycisku odtwarzania), a następnie wybierz cel wdrożenia.
Po utworzeniu i wprowadzeniu na rynek aplikacja wyświetla użytkownikowi stronę docelową z listą wersji demonstracyjnych.
Użytkownicy wersji demonstracyjnych pakietu SDK Map Google powinni znać ten wzorzec prezentacji i odpowiadającą mu strukturę kodu źródłowego. Wynika to z faktu, że wersja demonstracyjna GoogleMap została zaprojektowana tak, aby przypominała aplikację demonstracyjną interfejsu Maps API. Główna różnica polega na tym, że wersja demonstracyjna SDK nawigacji umożliwia użytkownikowi wybór klasy widoku, który chce przetestować: NavigationView
lub MapView
(w stosownych przypadkach).
Google zachęca użytkowników, by używali NavigationView
.
Wersja demonstracyjna pozwala wypróbować różne
działania w obu wersjach w naszej aplikacji demonstracyjnej i wybrać tę, która najbardziej Ci odpowiada. Na przykład użycie elementu MapView
może być konieczne w sytuacjach, gdy używasz biblioteki zewnętrznej, która oczekuje interakcji z tą klasą.