Konfiguracja pakietu Maps SDK na Androida

Wybierz platformę: Android iOS

Na tej stronie opisujemy, jak skonfigurować bibliotekę narzędzi pakietu Maps SDK na Androida i uruchomić aplikację w wersji demonstracyjnej dołączoną do biblioteki.

Wymagania wstępne i uwagi

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

Dokumentacja jest dostępna na GitHubie.

Krok 1. Instalowanie biblioteki narzędziowej pakietu Maps SDK na Androida

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

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation("com.google.maps.android:android-maps-utils:3.19.0")
}

Użyj jednego z narzędzi z biblioteki, np. klastrowania znaczników, map cieplnych lub innych narzędzi.

Krok 2. (Opcjonalnie) Zainstaluj bibliotekę narzędziową KTX pakietu Maps SDK na Androida

Biblioteka narzędziowa pakietu Maps SDK na Androida zawiera odpowiednią bibliotekę rozszerzeń Kotlin (KTX). Ta biblioteka udostępnia funkcje języka Kotlin, takie jak funkcje rozszerzające, nazwane i domyślne argumenty, które umożliwiają pisanie zwięzłego i idiomatycznego kodu w Kotlinie. Jeśli nie tworzysz aplikacji w języku Kotlin, możesz pominąć ten krok.

Aby używać tej biblioteki, dodaj do pliku build.gradle.kts aplikacji tę zależność oprócz zależności android-maps-utils:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation(libs.maps.utils.ktx)
}

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

Krok 3. Wyświetlanie kodu źródłowego biblioteki narzędziowej pakietu Maps SDK na Androida

Biblioteka narzędziowa jest dostępna na licencji open source, więc możesz pobrać bibliotekę android-maps-utils na swój komputer, aby ją dostosować, wyświetlić aplikację w wersji demonstracyjnej lub po prostu zrozumieć, jak działa. Możesz to zrobić, klonując repozytorium (zalecane, aby otrzymywać automatyczne aktualizacje) lub pobierając plik ZIP. Jeśli chcesz dostosować bibliotekę, utwórz rozwidlenie repozytorium.

Repozytorium zawiera:

  • Aplikacja demonstracyjna w katalogu demo.
  • Biblioteka narzędzi w katalogu library.
  • Różne pliki zawierające informacje o licencji, współtwórcach i pliku README.
  • Konfiguracja kompilacji Gradle do użycia w Android Studio.

Uruchamianie aplikacji w wersji demonstracyjnej narzędzia

Repozytorium GitHub biblioteki narzędziowej zawiera aplikację w wersji demonstracyjnej z przykładowymi implementacjami każdego narzędzia. Aby uruchomić aplikację w wersji demonstracyjnej na urządzeniu z Androidem, wykonaj te czynności.

  1. Pobierz repozytorium, korzystając z jednej z opcji wymienionych powyżej.
  2. W Android Studio wybierz File –> New –> Import Project (Plik –> Nowy –> Importuj projekt).
  3. Przejdź do katalogu android-maps-utils utworzonego podczas klonowania biblioteki narzędziowej i wybierz go (kliknij dwukrotnie). Android Studio utworzy teraz projekt.
  4. Jeśli zamiast emulatora używasz urządzenia z Androidem, włącz tryb deweloperski. Następnie podłącz urządzenie z Androidem do komputera.

  5. Dodaj do elementu local.properties wiersz podobny do tego:

    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. Skompiluj i uruchom aplikację demo.

Aplikacja powinna otworzyć się na urządzeniu z Androidem i wyświetlić listę narzędzi, w tym klastrowania, polyutil, mapy termicznej i innych. Aplikację znajdziesz też na liście aplikacji pod nazwą Maps Utils Demo.