Konfiguracja pakietu Maps SDK na Androida

Wybierz platformę: Android iOS

Na tej stronie dowiesz się, jak skonfigurować Maps SDK na Androida biblioteki narzędzi i uruchomić znajdującą się w bibliotece aplikację w wersji demonstracyjnej.

Wymagania wstępne i uwagi

Biblioteka narzędzi Maps SDK na Androida obsługuje Androida Interfejs API na poziomie15 i wyższym. Podczas ustawiania celu kompilacji projektu użyj najnowszej Poziom interfejsu API Androida.

odwołanie dokumentacja jest dostępna na GitHubie.

Krok 1. Zainstaluj bibliotekę narzędzi Maps SDK na Androida

Dodaj tę zależność do pliku build.gradle.kts 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.2")
}

Skorzystać z jednego z narzędzi z biblioteki, np. znacznik grupowanie, mapy termiczne lub inne i usług komunalnych.

Krok 2. (Opcjonalnie) Zainstaluj bibliotekę KTX narzędzia Maps SDK for Android

Biblioteka narzędzi Maps SDK na Androida ma odpowiednie rozszerzenia Kotlin (KTX). Ta biblioteka udostępnia funkcje w języku Kotlin, takie jak funkcje rozszerzeń i domyślnych argumentów, aby umożliwić Ci zwięzłe, idiomatyczne teksty w kotlinie. Jeśli nie jesteś programowania w Kotlin, możesz pominąć ten krok.

Aby używać tej biblioteki, oprócz android-maps-utils do pliku build.gradle.kts aplikacji:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation("com.google.maps.android:maps-utils-ktx:5.1.1")
}

Zobacz stronę Map Google KTX GitHub dodatkowe informacje o tej bibliotece.

Krok 3. Wyświetl kod źródłowy biblioteki narzędziowej pakietu Maps SDK na Androida

Ponieważ biblioteka narzędzi to oprogramowanie typu open source, możesz pobrać android-maps-utils do własnych preferencji, wyświetl aplikację w wersji demonstracyjnej co biblioteka. Możesz to zrobić w następujący sposób: klonowanie repozytorium (zalecane, , aby otrzymywać automatyczne aktualizacje) lub pobieram plik ZIP. Jeśli chcesz dostosować bibliotekę, utworzyć 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órców i plik Readme.
  • Konfiguracja kompilacji Gradle do użytku w Android Studio.

Uruchom aplikację demonstracyjną

Repozytorium GitHuba z biblioteką narzędziową zawiera aplikację w wersji demonstracyjnej, która zawiera o implementację poszczególnych narzędzi. Wykonaj te czynności, aby uruchomić aplikację w wersji demonstracyjnej na urządzeniu z Androidem.

  1. Pobierz repozytorium, korzystając z jednej z opcji opisanych powyżej.
  2. W Android Studio wybierz kolejno Plik -> Nowe -> Importuj projekt.
  3. Wskaż i wybierz (dwukrotnie kliknij) katalogu android-maps-utils, który został utworzony podczas sklonowano bibliotekę narzędzia. Teraz Android Studio skompiluje projekt.
  4. Jeśli zamiast emulatora używasz urządzenia z Androidem, upewnij się, włączyć tryb programisty. Następnie podłącz urządzenie z Androidem do komputera.
  5. Dodaj do pliku local.properties jeden wiersz podobny do tego:

    MAPS_API_KEY=YOUR_API_KEY

    Gdzie YOUR_API_KEY to klucz interfejsu API uzyskany w sposób opisany w Korzystanie z kluczy interfejsu API.

  6. Utwórz i uruchom wersję demonstracyjną aplikacji.

Aplikacja powinna otworzyć się na urządzeniu z Androidem z wyświetloną listą narzędzi w tym grupowania, poyutil, mapy termicznej i innych. Aplikację możesz też znaleźć w listę aplikacji pod nazwą Maps Utils Demo (Wersja demonstracyjna Map Google).