Wypróbuj wersję demonstracyjną

Dzięki integracji pakietu Navigation SDK na Androida aplikacja może wyjść poza łączenie kont. do zewnętrznego widoku mapy. Dzięki Nawigacji w Mapach Google aplikacja może oferować dynamiczne pobierania danych i tworzenia raportów z pojedynczymi informacjami o ścieżce użytkownika. Ten przewodnik jak uruchamiać aplikacje demonstracyjne pakietu Navigation SDK, które są dostępne na GitHubie.

Przygotuj się

Aby rozpocząć korzystanie z pakietu Navigation SDK, musisz mieć tych elementów.

  • Przedstawiciel Google Maps Platform w celu uzyskania dostępu do tych danych:

    • Klucz interfejsu API udostępniony do użycia z Pakiet SDK do nawigacji. Podaj swoje dane kontaktowe identyfikator projektu, który można znaleźć w panelu głównym konsoli Google Cloud; pod nazwą projektu.
    • Artefakt pakietu SDK. Sprawdź, czy projekt jest skonfigurowany. aby używać narzędzia Maven na potrzeby pakietu Navigation SDK.
    • Dla projektów korzystających z wersji 4.99.0 lub starszej. Jeśli nie możesz użyć narzędzia Maven, może pobrać skompresowany artefakt z udostępnianego Dysku Google. Plik biblioteki statycznej to plik .aar w Katalog libs/ zawierający pakiet SDK nawigacji jako Pakiet AAR.
    • co najmniej jedną z aplikacji w wersji demonstracyjnej.
    • Android Studio – zalecane środowisko programistyczne do tworzenia aplikacji. pakiet SDK nawigacji.

Ta dokumentacja jest przeznaczona dla osób znających programowanie na Androida i koncepcjach programowania zorientowanego obiektowo. Musisz też znać Google Mapy z perspektywy użytkownika.

Pobierz aplikacje w wersji demonstracyjnej

Google udostępnia 2 aplikacje, które pomogą Ci zrozumieć Pakiet Navigation SDK oferuje Interfejsy API Map Google w zależności od poziomu doświadczenia użytkownika. Programiści znający interfejsy API Map Google mogą skupić się na prezentacji Nawigacji Google. Deweloperzy, którzy nie mają doświadczenia z obydwoma aplikacjami okaże się, że te aplikacje będą przydatne.

Od pakietu Navigation SDK na Androida w wersji 4.1 te aplikacje w wersji demonstracyjnej są jednocześnie dostępne do pobrania w GitHub.

  • Prezentacja GoogleNavigation: przedstawia integrację działań interfejsu API które pasują do doświadczeń użytkownika podczas nawigacji .

  • Prezentacja GoogleMap: pokazuje indywidualne zachowania użytkowników GoogleMap. interfejsu, aby dostosować wygląd i sposób prezentacji map.

Uwaga na temat korzystania z narzędzia Maven

Aplikacje w wersji demonstracyjnej są skonfigurowane tak, aby pobierały artefakt SDK ze zdalnego narzędzia Maven. przy użyciu wtyczki Artifact Registry w Gradle. Postępuj zgodnie z instrukcjami instrukcje konfigurowania projektu, aby uzyskać dostęp do pakietu SDK.

Demo Nawigacji Google

Najnowsza wersja demonstracyjna Nawigacji Google jest dostępna na GitHub.

Budynek

  1. W Android Studio zaimportuj aplikację w wersji demonstracyjnej i zezwól na uruchomienie Gradle.

  2. Otwórz local.defaults.properties i zaktualizuj wartość MAPS_API_KEY usługa:

      MAPS_API_KEY=YOUR_API_KEY
    
  3. Kliknij Utwórz i sprawdź szczegóły implementacji pakietu SDK.

    • W klasie Java zwróć uwagę na kod implementacji.

    • Zwróć uwagę na projekt i tekst w szablonie XML.

    • W pliku build.gradle zwróć uwagę na pakiet SDK w zależnościach.

Zobacz Gradle obiektów tajnych wtyczka dokumentacji z dodatkowymi informacjami na temat dodawania klucza interfejsu API do pliku manifestu.

Uruchomiono

  1. Podłącz urządzenie z Androidem do komputera lub użyj emulatora.

    • Urządzenie z Androidem – zapoznaj się z instrukcje, włącz opcje programisty na urządzeniu z Androidem i skonfiguruj system w celu wykrycia urządzenia.
    • Emulatormdash; używaj urządzenia wirtualnego z Androidem (AVD) Menedżer – skonfigurować urządzenie wirtualne. Przy wyborze emulatora upewnij się, wybierz obraz, który zawiera interfejsy API Google.
  2. W Android Studio kliknij menu Uruchom (lub przycisk odtwarzania). icon); a następnie wybierz cel wdrożenia.

Po utworzeniu i uruchomieniu aplikacji wyświetla się użytkownikowi strona docelowa w postaci listy dostępnych opcji.

Nowi użytkownicy NavSDK prawdopodobnie uznają te 2 opcje za najefektywniejsze jest przydatna.

Opcja 1. NavViewActivity prezentuje zachowania przy użyciu NavigationView w połączeniu z Navigator.

Opcja 2. Druga opcja o nazwie NavFragmentActivity to reklamy z prezentacją za pomocą funkcji SupportNavigationFragment wraz z Navigator.

Po kliknięciu jednej z tych opcji zostaną wyświetlone następujące opcje:

  • interfejs nawigacji
  • „Ustaw miejsce docelowe”. przycisk w menu aplikacji
  • Nakładki pozwalające na dynamiczne wywoływanie metod API
  • rozszerzone menu z większą liczbą opcji

Aby rozpocząć, kliknij Ustaw miejsce docelowe i wybierz adres. Następnie aplikacja symuluje podróż z bieżącej lokalizacji do tego adresu. Użyj elementu sterującego nakłada się, aby zobaczyć, co się dzieje po wywołaniu interfejsu API. Możesz na przykład: kliknij Wyświetl metody, by przełączyć pakiet SDK w tryb nocny i spróbować jak on wygląda.

Opcja switchpingMapAndNavActivity

SwappingMapAndNavActivity obejmuje te typowe wzorce:

Wersja demonstracyjna Map Google

Najnowsza wersja demonstracyjna Nawigacji Google jest dostępna na GitHub.

Budynek

  1. W Android Studio zaimportuj aplikację w wersji demonstracyjnej i zezwól na uruchomienie Gradle.

  2. Otwórz local.defaults.properties i zaktualizuj wartość MAPS_API_KEY usługa:

      MAPS_API_KEY=YOUR_API_KEY
    
  3. Kliknij Utwórz i sprawdź szczegóły implementacji pakietu SDK.

    • W klasie Java zwróć uwagę na kod implementacji.

    • Zwróć uwagę na projekt i tekst w szablonie XML.

    • W pliku build.gradle zwróć uwagę na pakiet SDK w zależnościach.

Zobacz narzędzia do obiektów tajnych – Gradle wtyczka .

Uruchomiono

  1. Podłącz urządzenie z Androidem do komputera lub użyj emulatora.

    • Urządzenie z Androidem – zapoznaj się z instrukcje, aby włączyć opcje programisty na urządzeniu z Androidem i skonfigurować system wykrywający urządzenie.
    • Emulator używa urządzenia wirtualnego z Androidem (AVD). Menedżer aby skonfigurować urządzenie wirtualne. Przy wyborze emulatora upewnij się, wybierz obraz, który zawiera interfejsy API Google.
  2. W Android Studio kliknij menu Uruchom (lub przycisk odtwarzania). icon); a następnie wybierz cel wdrożenia.

Po utworzeniu i uruchomieniu aplikacji wyświetla się użytkownikowi strona docelowa w postaci listy w wersji demonstracyjnej.

Ten wzorzec prezentacji i odpowiadająca mu struktura kodu źródłowego powinien być znany użytkownikom wersji demonstracyjnej pakietu SDK Map Google. To dlatego, że Wersja demonstracyjna GoogleMap została zaprojektowana tak, aby przypominać wersję demonstracyjną interfejsu API Map Google. Podstawowy różnica polega na tym, że wersja demonstracyjna pakietu Navigation SDK umożliwia użytkownikowi wybór klasy widoku. klient chce przetestować wersję demonstracyjną: NavigationView lub MapView, w odpowiednich przypadkach.

Google zwykle zachęca użytkowników do stosowania NavigationView Wersja demonstracyjna pozwala testować te zachowania w obu wersjach w aplikacji demonstracyjnej i wybierz opcję, która najbardziej Ci odpowiada. Na przykład w dalszym ciągu niezbędne, aby używać MapView w sytuacjach, gdy korzystasz z usług innych firm która oczekuje interakcji z tymi zajęciami.