Untuk mengonfigurasi aplikasi agar menggunakan Places SDK for Android, ikuti langkah-langkah berikut. ID tersebut diwajibkan untuk semua aplikasi yang menggunakan Places SDK for Android.
Langkah 1: Siapkan Android Studio
- Perlu Android Studio Arctic Fox atau versi yang lebih baru. Jika belum punya, download dan instal Android Studio versi tersebut.
- Pastikan Anda menggunakan plugin Android Gradle versi 7.0 atau yang lebih baru di Android Studio.
Langkah 2: Siapkan SDK
Library Places SDK for Android tersedia melalui repositori Maven Google. Untuk menambahkan SDK ke aplikasi Anda, lakukan hal berikut:
- Di file
settings.gradle
tingkat atas, sertakan portal plugin Gradle, repositori Maven Google, dan Maven Central Repository di bagian blokpluginManagement
. BlokpluginManagement
harus muncul sebelum pernyataan lain dalam skrip.pluginManagement { repositories { gradlePluginPortal() google() mavenCentral() } }
- Di file
settings.gradle
tingkat atas, sertakan repositori Maven Google dan repositori pusat Maven pada blokdependencyResolutionManagement
:dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } }
-
Di bagian
dependencies
filebuild.gradle
level modul, tambahkan dependensi ke Places SDK for Android:dependencies { implementation 'com.google.android.libraries.places:places:3.1.0' }
- Dalam file
build.gradle
level modul, tetapkancompileSdk
danminSdk
ke nilai berikut:android { compileSdk 31 defaultConfig { minSdk 21 // ... }
Langkah 3: Tambahkan kunci API Anda ke project
Bagian ini menjelaskan cara menyimpan kunci API sehingga dapat dirujuk dengan aman oleh
aplikasi Anda. Anda tidak boleh memasukkan kunci API ke dalam sistem kontrol versi Anda, jadi sebaiknya
simpan kunci tersebut dalam file local.properties
, yang terletak di direktori utama project
Anda. Untuk informasi selengkapnya tentang file local.properties
, lihat
file properti Gradle.
Untuk menyederhanakan tugas ini, sebaiknya Anda menggunakan Plugin Gradle Secret untuk Android. Untuk menginstal plugin dan menyimpan kunci API Anda:
- Di Android Studio, buka file
build.gradle
tingkat project dan tambahkan kode berikut ke elemendependencies
di bagianbuildscript
.plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false }
- Selanjutnya, buka file
build.gradle
tingkat modul dan tambahkan kode berikut ke elemenplugins
.id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
- Simpan file dan sinkronkan project Anda dengan Gradle.
- Buka
local.properties
pada direktori tingkat project, lalu tambahkan kode berikut. GantiYOUR_API_KEY
dengan kunci API Anda.MAPS_API_KEY=YOUR_API_KEY
- Simpan file tersebut.
- Dalam file
AndroidManifest.xml
Anda, bukacom.google.android.geo.API_KEY
dan perbaruiandroid:value attribute
seperti berikut:<meta-data android:name="com.google.android.geo.API_KEY" android:value="${MAPS_API_KEY}" />
Catatan: Seperti yang ditunjukkan di atas,
com.google.android.geo.API_KEY
adalah nama metadata yang disarankan
untuk kunci API. Kunci dengan nama ini dapat digunakan untuk mengautentikasi beberapa API berbasis Google Maps sekaligus di platform Android, termasuk Places SDK for Android. Untuk kompatibilitas mundur, API tersebut juga mendukung nama com.google.android.maps.v2.API_KEY
. Nama lama ini hanya memungkinkan autentikasi untuk Android Maps API v2. Aplikasi hanya dapat menetapkan salah satu nama metadata kunci API. Jika keduanya ditetapkan, API
akan memberikan pengecualian.
Langkah 4. Melakukan inisialisasi klien Places API
Lakukan inisialisasi Places SDK for Android dalam aktivitas atau fragmen seperti yang ditunjukkan dalam contoh berikut
(perhatikan bahwa Anda meneruskan kunci API saat memanggil
Places.initialize()
):
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)
Sekarang Anda siap untuk mulai menggunakan Places SDK for Android!
Langkah 5: Siapkan perangkat Android
Untuk menjalankan aplikasi yang menggunakan Places SDK for Android, Anda harus men-deploy aplikasi tersebut ke perangkat Android atau emulator Android yang didasarkan pada Android 4.0 atau yang lebih tinggi dan menyertakan Google API.
- Untuk menggunakan perangkat Android, ikuti petunjuk pada halaman Menjalankan aplikasi di perangkat hardware.
- Untuk menggunakan emulator Android, Anda dapat membuat perangkat virtual dan menginstal emulator dengan menggunakan AVD (Perangkat Virtual Android) Manager yang disertakan bersama Android Studio.