Repozytorium pakietu Maps SDK na Androida na GitHub zawiera przykłady ilustrujące użycie tego pakietu w aplikacji na Androida.
Repozytorium zawiera aplikację ApiDemos, czyli przykładową aplikację, która umożliwia kompilowanie i uruchamianie przykładów z jednej aplikacji na Androida. Zaimportuj i skompiluj aplikację, dodaj klucz interfejsu API, obejrzyj wersję demonstracyjną i skorzystaj z przykładowego kodu jako punktu wyjścia do tworzenia aplikacji.
Po uruchomieniu przykładowej aplikacji wyświetli się lista dostępnych przykładów, które możesz uruchomić na swoim urządzeniu. Wybierz jedną z opcji. Na przykład kliknij Mapa podstawowa.
Rozwiązywanie problemów: jeśli przykładowa aplikacja działa prawidłowo, ale nie widzisz mapy, sprawdź, czy klucz interfejsu API został dodany do pliku manifestu aplikacji zgodnie z opisem w artykule Korzystanie z kluczy interfejsu API.
Lista przykładowych aplikacji korzystających z Maps SDK na Androida
Poniżej znajdziesz listę najważniejszych przykładowych aktywności zawartych w pakiecie SDK Map Google na Androida ApiDemos. Są one też dostępne na stronach, do których prowadzą linki, aby można było do nich szybko wrócić. Pełną listę dostępnych przykładów znajdziesz w folderze Kotlin lub Java.
Klonowanie i uruchamianie przykładów
Aby uruchomić ten przykład lokalnie, musisz mieć zainstalowany Git. Poniższe polecenie sklonuje repozytorium przykładowej aplikacji.
git clone git@github.com:googlemaps-samples/android-samples.git
Zaimportuj przykładowy projekt do Android Studio:
- W Android Studio kliknij kolejno Plik > Nowy > Importuj projekt.
Przejdź do lokalizacji, w której zostało zapisane repozytorium, i wybierz katalog projektu Kotlin lub Java:
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin
- Java:
PATH-REPO/android-samples/ApiDemos/java
- Kotlin:
- Wybierz Otwórz. Android Studio kompiluje projekt za pomocą narzędzia kompilacji Gradle.
- Utwórz pusty plik
secrets.properties
w tym samym katalogu, w którym znajduje się pliklocal.properties
projektu. Więcej informacji znajdziesz w artykule Dodawanie klucza interfejsu API do projektu. Dodaj ten ciąg do pliku
secrets.properties
, zastępując YOUR_API_KEY wartością klucza API:MAPS_API_KEY=YOUR_API_KEY
- Uruchom aplikację.
Przykładowa aplikacja do map na Wear OS
Przykładowa aplikacja z pakietu Maps SDK na Androida na Wear OS jest dostępna w GitHub. Możesz z niej korzystać jako punkt wyjścia podczas tworzenia aplikacji do noszenia. Przykład pokazuje, jak skonfigurować podstawową mapę Google na Wear OS.