Konfiguracja pakietu Maps SDK na Androida

Z tego artykułu dowiesz się, jak skonfigurować bibliotekę pakietu SDK Map na Androida oraz uruchomić aplikację demonstracyjną należącą do biblioteki.

Wymagania wstępne i informacje

Biblioteka narzędzi Maps SDK na Androida obsługuje poziom interfejsu API Androida 15 i nowsze. Podczas ustawiania celu kompilacji projektu użyj najnowszego poziomu interfejsu API Androida.

Dokumentacja referencyjna jest dostępna na GitHubie.

Krok 1. Instalowanie biblioteki narzędzi Maps SDK na Androida

Dodaj tę zależność do pliku build.gradle aplikacji:

dependencies {
    implementation 'com.google.maps.android:android-maps-utils:2.3.0'

}

Użyj jednego z narzędzi bibliotek, takich jak grupowanie znaczników, mapy witryny lub inne narzędzia.

Krok 2. (Opcjonalnie) Instalowanie biblioteki KTX Maps SDK na Androida

Biblioteka narzędzi Maps SDK na Androida zawiera bibliotekę rozszerzeń Kotlin (KTX). Ta biblioteka udostępnia funkcje językowe Kotliny, takie jak funkcje rozszerzeń i ich nazwy, a także argumenty domyślne, dzięki czemu możesz pisać zwięzłe i idiomatyczne treści. Jeśli nie tworzysz aplikacji w Kotlinie, możesz pominąć ten krok.

Aby korzystać z tej biblioteki, oprócz zależności android-maps-utils do klucza build.gradle dodaj też tę zależność:

dependencies {
    implementation 'com.google.maps.android:maps-utils-ktx:3.4.0'
}

Więcej informacji o tej bibliotece znajdziesz na stronie Map KTX GitHub.

Krok 3. Wyświetl kod źródłowy pakietu Maps SDK na Androida,

Biblioteka narzędzi jest oprogramowaniem open source, więc możesz pobrać bibliotekę android-maps-utils na komputer, aby ją dostosować, wyświetlić aplikację w wersji demonstracyjnej lub dowiedzieć się, jak działa ta biblioteka. W tym celu kopiuj repozytorium (zalecane, aby otrzymywać aktualizacje automatyczne) lub pobierz plik ZIP. Jeśli chcesz dostosować bibliotekę, musisz utworzyć rozwidlenie repozytorium.

Repozytorium zawiera:

• Aplikacja demonstracyjna w katalogu demo.
• Biblioteka narzędzi w katalogu library.
• Biblioteka narzędzi Maps SDK for v3 BETA w katalogu library-v3.
• Różne pliki zawierające licencje, współtwórców i informacje o gotowości.
• Konfiguracja kompilacji Gradle do użycia w Android Studio.

Uruchom aplikację demonstracyjną

Repozytorium GitHub dla biblioteki narzędzi zawiera aplikację demonstracyjną, która zawiera przykładowe implementacje każdego narzędzia. Aby uruchomić aplikację demonstracyjną na urządzeniu z Androidem, wykonaj te czynności.

1. Pobierz repozytorium, korzystając z jednej z powyższych opcji.
2. W Android Studio wybierz File -> New -> Import Project.
3. Przejrzyj i wybierz (kliknij dwukrotnie) katalog android-maps-utils utworzony podczas kopiowania biblioteki narzędzi. Android Studio skompiluje projekt.
4. Jeśli zamiast emulatora używasz urządzenia z Androidem, włącz tryb programisty. Następnie podłącz urządzenie z Androidem do komputera.

5. Dodaj do wiersza local.properties pojedynczy wiersz:

   MAPS_API_KEY=YOUR_API_KEY

   Gdzie YOUR_API_KEY to klucz interfejsu API uzyskany zgodnie z opisem w artykule Korzystanie z kluczy interfejsu API.

6. Utwórz i uruchom aplikację demonstracyjną.

Aplikacja powinna otworzyć się na urządzeniu z Androidem, aby wyświetlić listę narzędzi, takich jak klastry, poyutil, mapa termiczna i inne. Tę aplikację znajdziesz też na liście aplikacji pod nazwą Mapy demonstracyjne Narzędzia.