Aby skonfigurować aplikację pod kątem korzystania z pakietu SDK Miejsc na Androida, wykonaj te czynności. Są one wymagane w przypadku wszystkich aplikacji używających pakietu SDK Miejsc na Androida.
Krok 1. Skonfiguruj Android Studio
- Wymagany jest Android Studio Arctic Fox lub nowszy. Pobierz i zainstaluj, jeśli jeszcze jej nie masz.
- Upewnij się, że używasz wtyczki Android Gradle w wersji 7.0 lub nowszej w Android Studio.
Krok 2. Skonfiguruj pakiet SDK
Biblioteka SDK Miejsc na Androida jest dostępna wrepozytorium Google Maven. Aby dodać pakiet SDK do aplikacji, wykonaj te czynności:
- W pliku
settings.gradle
najwyższego poziomu uwzględnij portal wtyczki Gradle, repozytorium Google Maven i centralne repozytorium Maven w blokupluginManagement
. BlokpluginManagement
musi być widoczny przed innymi wypowiedziami w skrypcie.pluginManagement { repositories { gradlePluginPortal() google() mavenCentral() } }
- W pliku
settings.gradle
najwyższego poziomu umieść w repozytoriumdependencyResolutionManagement
repozytorium Google Maven i centralne repozytorium Maven:dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
-
W sekcji
dependencies
plikubuild.gradle
modułu na poziomie modułu dodaj zależność od pakietu SDK Miejsc na Androida:dependencies { implementation 'com.google.android.libraries.places:places:3.0.0' }
- W pliku
build.gradle
na poziomie modułu ustawcompileSdk
iminSdk
na te wartości:android { compileSdk 31 defaultConfig { minSdk 21 // ... }
Krok 3. Dodaj klucz interfejsu API do projektu
W tej sekcji dowiesz się, jak przechowywać klucz interfejsu API, aby można było bezpiecznie odwoływać się do niego przez aplikację. Zalecamy niesprawdzanie klucza interfejsu API w systemie kontroli wersji, dlatego zalecamy przechowywanie go w pliku local.properties
, który znajduje się w katalogu głównym projektu. Więcej informacji o pliku local.properties
znajdziesz w artykule Pliki właściwości Gradle.
Aby uprościć to zadanie, zalecamy użycie wtyczki Gradle obiektów tajnych na Androida. Aby zainstalować wtyczkę i zapisać klucz interfejsu API:
- W Android Studio otwórz plik
build.gradle
na poziomie projektu i dodaj ten kod do elementudependencies
w sekcjibuildscript
.plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false }
- Następnie otwórz plik
build.gradle
na poziomie modułu i dodaj ten kod do elementuplugins
.id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
- Zapisz plik i zsynchronizuj projekt z Gradle.
- Otwórz
local.properties
w katalogu na poziomie projektu i dodaj ten kod. ZastąpYOUR_API_KEY
kluczem interfejsu API.MAPS_API_KEY=YOUR_API_KEY
- Zapisz plik.
- W pliku
AndroidManifest.xml
otwórz stronęcom.google.android.geo.API_KEY
i zaktualizujandroid:value attribute
w ten sposób:<meta-data android:name="com.google.android.geo.API_KEY" android:value="${MAPS_API_KEY}" />
Uwaga: jak pokazano powyżej, com.google.android.geo.API_KEY
to zalecana nazwa metadanych klucza interfejsu API. Klucz o tej nazwie może być używany do uwierzytelniania na wielu interfejsach API opartych na Mapach Google na platformie Android, w tym w pakiecie Places SDK dla Androida. Aby zapewnić zgodność wsteczną, interfejs API obsługuje też nazwę com.google.android.maps.v2.API_KEY
. Ta nazwa starszego typu umożliwia uwierzytelnianie tylko dla interfejsu Android Maps API v2. Aplikacja może określać tylko jedną z nazw metadanych klucza interfejsu API. Jeśli podasz obie opcje, interfejs API zwróci wyjątek.
Krok 4. Inicjowanie klienta interfejsu Places API
Zainicjuj pakiet SDK Miejsc na Androida w ramach aktywności lub fragmentu, jak pokazano w przykładzie poniżej (pamiętaj, że podczas wywoływania Places.initialize()
przekazujesz klucz interfejsu API):
Java
// Initialize the SDK Places.initialize(getApplicationContext(), apiKey); // Create a new PlacesClient instance PlacesClient placesClient = Places.createClient(this);
Kotlin
// Initialize the SDK Places.initialize(applicationContext, apiKey) // Create a new PlacesClient instance val placesClient = Places.createClient(this)
Teraz możesz już zacząć korzystać z pakietu SDK Miejsc na Androida.
Krok 5. Skonfiguruj urządzenie z Androidem
Aby uruchomić aplikację, która korzysta z pakietu SDK Miejsc na Androida, musisz ją wdrożyć na urządzeniu z Androidem lub w emulatorze Androida opartym na Androidzie 4.0 lub nowszym i interfejsach API Google.
- Aby korzystać z urządzenia z Androidem, wykonaj czynności opisane w artykule Uruchamianie aplikacji na urządzeniu.
- Aby użyć emulatora Androida, możesz utworzyć urządzenie wirtualne i zainstalować emulator za pomocą Menedżera urządzeń wirtualnych Android dostępnego w Android Studio.