Konfiguracja pakietu Maps SDK na Androida

Wybierz platformę: Android iOS

Na tej stronie dowiesz się, jak skonfigurować bibliotekę narzędziową pakietu SDK Map Google na Androida i uruchomić aplikację demonstracyjną znajdującą się w bibliotece.

Wymagania wstępne i uwagi

Biblioteka narzędzi pakietu Maps SDK na Androida obsługuje poziom interfejsu API Androida 15 i nowszego. Ustawiając cel kompilacji projektu, upewnij się, że używasz najnowszego poziomu interfejsu Android API.

Dokumentacja referencyjna jest dostępna na GitHubie.

Krok 1. Zainstaluj bibliotekę narzędziową Maps SDK na Androida

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

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.8.0'
}

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

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

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

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

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.0.0'
}

Dodatkowe informacje o tej bibliotece znajdziesz na stronie Map KTX na GitHubie.

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

Biblioteka narzędziowa jest oprogramowaniem typu open source, więc możesz pobrać bibliotekę android-maps-utils na swój komputer, aby ją dostosować, wyświetlić aplikację demonstracyjną lub po prostu dowiedzieć się, jak działa biblioteka. Możesz to zrobić, klonując repozytorium (zalecane, aby otrzymywać automatyczne aktualizacje) lub pobierając plik ZIP. Jeśli chcesz dostosować bibliotekę, rozwiń 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 demonstracyjnej aplikacji narzędziowej

W repozytorium GitHub na potrzeby biblioteki narzędzi znajduje się aplikacja demonstracyjna, która zawiera przykładowe implementacje każdego narzędzia. Aby uruchomić aplikację demonstracyjną na swoim urządzeniu z Androidem, wykonaj te czynności.

  1. Pobierz repozytorium za pomocą jednej z opcji opisanych powyżej.
  2. W Android Studio wybierz Plik -> Nowy -> Importuj projekt.
  3. Przejdź do katalogu android-maps-utils, który został utworzony podczas kopiowania biblioteki narzędziowej, i wybierz go. Android Studio skompiluje teraz projekt.
  4. Jeśli zamiast emulatora używasz urządzenia z Androidem, włącz tryb programisty. Następnie podłącz do komputera urządzenie z Androidem.

  5. Dodaj do elementu local.properties pojedynczy wiersz, który wygląda tak:

    MAPS_API_KEY=YOUR_API_KEY

    Gdzie YOUR_API_KEY to klucz interfejsu API uzyskany zgodnie z opisem w sekcji Używanie kluczy interfejsu API.

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

Aplikacja powinna się otworzyć na urządzeniu z Androidem i wyświetlić listę narzędzi, takich jak klastrowanie, poyutil, mapa termiczna i inne. Możesz też ją znaleźć na liście aplikacji pod nazwą Wersja demonstracyjna interfejsu Map Google.