Menyiapkan project Android Studio

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

  1. Perlu Android Studio Arctic Fox atau versi yang lebih baru. Jika belum punya, download dan instal Android Studio versi tersebut.
  2. 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:

  1. Di file settings.gradle tingkat atas, sertakan portal plugin Gradle, repositori Maven Google, dan Maven Central Repository di bagian blok pluginManagement. Blok pluginManagement harus muncul sebelum pernyataan lain dalam skrip.
    pluginManagement {
        repositories {
            gradlePluginPortal()
            google()
            mavenCentral()
        }
    } 
  2. Di file settings.gradle tingkat atas, sertakan repositori Maven Google dan repositori pusat Maven pada blok dependencyResolutionManagement:
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            mavenCentral()
        }
    } 
  3. Di bagian dependencies file build.gradle level modul, tambahkan dependensi ke Places SDK for Android:

    dependencies {
        implementation 'com.google.android.libraries.places:places:3.1.0'
    }
    
  4. Dalam file build.gradle level modul, tetapkan compileSdk dan minSdk 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:

  1. Di Android Studio, buka file build.gradle tingkat project dan tambahkan kode berikut ke elemen dependencies di bagian buildscript.
    plugins {
        // ...
        id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
    }
  2. Selanjutnya, buka file build.gradle tingkat modul dan tambahkan kode berikut ke elemen plugins.
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
        
  3. Simpan file dan sinkronkan project Anda dengan Gradle.
  4. Buka local.properties pada direktori tingkat project, lalu tambahkan kode berikut. Ganti YOUR_API_KEY dengan kunci API Anda.
    MAPS_API_KEY=YOUR_API_KEY
        
  5. Simpan file tersebut.
  6. Dalam file AndroidManifest.xml Anda, buka com.google.android.geo.API_KEY dan perbarui android: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.

Langkah berikutnya

Setelah project dikonfigurasi, Anda dapat mempelajari aplikasi contoh.