Ta strona została przetłumaczona przez Cloud Translation API.

Konfigurowanie projektu w Android Studio

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 w repozytorium 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 bloku pluginManagement. Blok pluginManagement musi być widoczny przed innymi wypowiedziami w skrypcie.
```
pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
} 
```

W pliku settings.gradle najwyższego poziomu umieść w repozytorium dependencyResolutionManagement repozytorium Google Maven i centralne repozytorium Maven:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

W sekcji dependencies pliku build.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 ustaw compileSdk i minSdk na te wartości:
Uwaga: sprawdź, czy compileSdk ma wartość 31 lub wyższą, a minSdk ma wartość 21 lub większą.
```
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 elementu dependencies w sekcji buildscript.

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 elementu plugins.
```
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ąp YOUR_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 zaktualizuj android: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.
Uwaga: jeśli chcesz skorzystać z emulatora Androida, wybierz urządzenie z ikoną Google Play w kolumnie Sklep Play. Ta ikona oznacza, że te profile są w pełni zgodne z CTS i mogą zawierać obrazy systemowe zawierające aplikację Sklep Play:

Dalsze kroki

Po skonfigurowaniu projektu możesz zapoznać się z przykładowymi aplikacjami.