Menyiapkan Project Android Studio yang Ada

Halaman ini menjelaskan cara mengonfigurasi project Android Studio yang ada untuk menggunakan Maps SDK for Android tanpa menggunakan template Google Maps yang dijelaskan dalam Panduan Memulai.

Template Google Maps akan otomatis mengonfigurasi dan menambahkan peta dasar ke project Android Studio baru. Namun, Anda juga dapat menambahkan peta ke project Android yang menggunakan template Android Studio lain. Untuk melakukannya, Anda harus mengonfigurasi project secara manual, lalu menambahkan peta.

Menyiapkan Android Studio

  1. Anda perlu memiliki Android Studio. Jika belum punya, download dan instal Android Studio.

  2. Tambahkan SDK layanan Google Play ke Android Studio. Maps SDK for Android didistribusikan sebagai bagian dari SDK layanan Google Play, yang dapat Anda tambahkan melalui SDK Manager.

Menyiapkan project Cloud dan kunci API

Untuk menyiapkan project Cloud dan kunci API:

Memperbarui manifes aplikasi

Bagian ini menjelaskan setelan yang akan ditambahkan ke file AndroidManifest.xml.


Nomor versi layanan Google Play

Tambahkan deklarasi berikut dalam elemen application. Tindakan tersebut akan menyematkan versi layanan Google Play yang digunakan untuk mengompilasi aplikasi.

<meta-data
    android:name="com.google.android.gms.version"
    android:value="@integer/google_play_services_version" />

Izin akses lokasi

Jika aplikasi perlu mengakses lokasi pengguna, Anda perlu meminta izin akses lokasi di file AndroidManifest.xml. Opsinya adalah ACCESS_FINE_LOCATION, yang memberikan lokasi akurat pengguna, dan ACCESS_COARSE_LOCATION, yang tidak terlalu akurat. Untuk mengetahui detailnya, lihat panduan data lokasi.

Untuk meminta izin ACCESS_FINE_LOCATION, tambahkan kode ini ke elemen manifest:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

Izin penyimpanan eksternal

Jika menargetkan SDK layanan Google Play versi 8.3 atau yang lebih baru, Anda tidak memerlukan izin WRITE_EXTERNAL_STORAGE. Jika menargetkan SDK layanan Google Play versi sebelumnya, Anda harus meminta izin WRITE_EXTERNAL_STORAGE, di elemen manifest.

<uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Library Apache HTTP Legacy

Jika Anda menggunakan com.google.android.gms:play-services-maps:16.0.0 atau yang lebih lama dan aplikasi Anda menargetkan API level 28 (Android 9.0) atau yang lebih tinggi, Anda harus menyertakan deklarasi berikut dalam elemen <application> dari AndroidManifest.xml. Jika tidak, lewati deklarasi ini.

<uses-library
    android:name="org.apache.http.legacy"
    android:required="false" />

Menambahkan dependensi Maps

Di file build.gradle tingkat aplikasi, tambahkan dependensi Maps. Untuk mengetahui detailnya, lihat panduan pembuatan versi.

dependencies {
    implementation 'com.google.android.gms:play-services-maps:17.0.1'
    // ...
}

Langkah berikutnya

Setelah project dikonfigurasi, Anda dapat menambahkan peta.