Penyiapan

Halaman ini menjelaskan hal yang perlu Anda lakukan untuk menyiapkan build dengan Maps 3D SDK untuk Android. Proses penyiapan melibatkan konfigurasi project dan API Google Cloud untuk digunakan dengan SDK, lalu menyiapkan project Android Studio. Selesaikan langkah-langkah ini sebelum menambahkan peta 3D pertama ke aplikasi Anda.

Menyiapkan project Google Cloud dan kunci API

Sebelum dapat mulai mem-build dengan Maps 3D SDK for Android, Anda harus menyiapkan project Google Cloud dan kunci API untuk digunakan dengan Maps 3D SDK for Android dengan menyelesaikan langkah-langkah berikut:

Langkah 1

Konsol

  1. Di konsol Google Cloud, pada halaman pemilih project, klik Create Project untuk mulai membuat project Cloud baru.

    Buka halaman pemilih project

  2. Pastikan penagihan diaktifkan untuk project Cloud Anda. Konfirmasi bahwa penagihan diaktifkan untuk project Anda.

    Google Cloud menawarkan uji coba tanpa biaya. Masa uji coba berakhir setelah 90 hari atau setelah akumulasi tagihan akun mencapai $300, mana saja yang lebih dulu. Batalkan kapan saja. Untuk informasi selengkapnya, lihat Kredit akun penagihan dan Penagihan.

Cloud SDK

gcloud projects create "PROJECT"

Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

Langkah 2

Untuk menggunakan Google Maps Platform, Anda harus mengaktifkan API atau SDK yang akan digunakan dengan project.

Perhatikan bahwa beberapa integrasi mengharuskan Anda untuk mengaktifkan beberapa API/SDK. Jika Anda tidak yakin API atau SDK mana yang harus diaktifkan, coba gunakan Alat Pilih API, atau baca dokumentasi untuk API/SDK yang ingin Anda gunakan.

Untuk mengaktifkan satu atau beberapa API atau SDK:

Konsol

  1. Lihat API dan SDK Google Maps Platform yang dapat Anda aktifkan dengan membuka halaman Library Maps API di Konsol Cloud:

    Buka halaman Library Maps API

  2. Klik API atau SDK yang ingin Anda aktifkan.
    • Jika tombolnya bertuliskan ENABLE, klik tombol tersebut untuk mengaktifkan API atau SDK.
    • Jika tombolnya bertuliskan MANAGE, berarti API atau SDK sudah diaktifkan dan Anda tidak perlu melakukan tindakan apa pun.
    • Mengklik salah satu tombol akan menampilkan dasbor untuk API atau SDK. (Klik tombol DISABLE untuk menghapus API atau SDK dari project ini.)

Cloud SDK

Perintah berikut mengaktifkan semua Maps, Routes, dan Places API:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

Gunakan perintah ini untuk mengaktifkan Environment API:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com"

Langkah 3

Langkah ini hanya ada di proses pembuatan Kunci API. Jika Anda menggunakan Kunci API dalam produksi, kami sangat menyarankan agar Anda membatasi kunci API. Anda dapat menemukan informasi selengkapnya di halaman Menggunakan Kunci API spesifik per produk.

Kunci API adalah ID unik yang mengautentikasi permintaan terkait project untuk tujuan penggunaan dan penagihan. Anda harus memiliki setidaknya satu kunci API terkait project.

Untuk membuat kunci API:

Konsol

  1. Buka halaman Google Maps Platform > Credentials.

    Buka halaman Credentials

  2. Pada halaman Credentials, klik Create credentials > API key.
    Dialog API key created akan menampilkan kunci API yang baru dibuat.
  3. Klik Close.
    Kunci API baru dicantumkan pada halaman Credentials di bawah API keys.
    (Jangan lupa untuk membatasi kunci API sebelum menggunakannya dalam produksi.)

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

Untuk mengaktifkan SDK, lihat halaman Maps 3D SDK for Android di Google Cloud Console. Untuk informasi selengkapnya tentang cara menyelesaikan langkah-langkah ini, lihat Memulai Google Maps Platform.

Menyiapkan project Android Studio

Bagian ini menjelaskan cara membuat dan mengonfigurasi project Android Studio untuk digunakan dengan Maps 3D SDK for Android.

Bagian 1: Menyiapkan project dan konfigurasi Gradle

  1. Buat project Android Studio baru menggunakan template Empty Views Activity.

  2. Jika Anda menggunakan Git untuk kontrol sumber, ubah file .gitignore project untuk mencegah file secret Anda di-commit ke kontrol versi:

    • Di direktori root project, buka file .gitignore.
    • Tambahkan baris berikut:
    secrets.properties

  3. Perbarui file build.gradle.kts level project:

    • Di direktori root project, buka file build.gradle.kts.
    • Di blok plugins, tambahkan plugin Secrets Gradle:
    plugins {
  alias(libs.plugins.android.application) apply false
  alias(libs.plugins.kotlin.android) apply false
  alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
}

  4. Perbarui file gradle/libs.versions.toml: - Buka file gradle/libs.versions.toml, yang biasanya terletak di direktori gradle dalam direktori utama project. - Di bagian versi, tambahkan versi untuk plugin Gradle SDK dan Secrets:

    maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
secretsGradlePlugin = "2.0.1"

    -   In the library section, add the SDK library:

    play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }

    -   In the plugin section, add the Secrets Gradle plugin:

    secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }

  5. Perbarui file app/build.gradle.kts level modul: - Buka file build.gradle.kts level modul, yang biasanya terletak dalam direktori app. - Di bagian atas file, tambahkan plugin Secrets Gradle ke blok plugins:

    plugins {
  alias(libs.plugins.android.application)
  alias(libs.plugins.kotlin.android)
  alias(libs.plugins.secrets.gradle.plugin) // Add this line
}

    -   In the `dependencies` block, add the SDK:

    dependencies {
  // ... other dependencies
  implementation(libs.play.services.maps3d) // Add this line
}

    -   At the end of the file, outside of the `android` and `dependencies`
    blocks, add the secrets configuration:

    secrets {
  // Optionally specify a different filename containing your secrets.
  // The plugin defaults to "local.properties"
  propertiesFileName = "secrets.properties"

  // A properties file containing default secret values. This file can be
  // checked in version control.
  defaultPropertiesFileName = "local.defaults.properties"
}

Bagian 2: Menambahkan kunci API ke project

  1. Buat file secrets.properties:

    • Di direktori root modul aplikasi (biasanya direktori app), buat file baru bernama secrets.properties.
    • Tambahkan kunci API Anda ke file:
    MAPS3D_API_KEY=YOUR_API_KEY_HERE
``` Note: Make sure you
    replace `YOUR_API_KEY_HERE` with the API key that you configured for use
with the Maps 3D SDK for Android.

  2. Buat file local.defaults.properties: - Di direktori utama modul aplikasi, buat file baru bernama secrets.properties. - Tambahkan kunci API default atau placeholder ke file. File ini dapat di-check in ke kontrol versi:

    MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER

Bagian 3: Memperbarui file AndroidManifest.xml

  1. Buka file app/src/main/AndroidManifest.xml.

  2. Di dalam tag <application>, sebelum tag <activity>, tambahkan elemen <meta-data> berikut untuk mendeklarasikan kunci API Anda:

    <application
  ...>

  <meta-data
      android:name="com.google.android.geo.maps3d.API_KEY"
      android:value="${MAPS3D_API_KEY}" />

  <activity
      ...>
  </activity>
</application>

    Selama proses build, Plugin Secrets Gradle akan mengganti placeholder ${MAPS3D_API_KEY} dengan kunci dari file secrets.properties Anda.

Langkah berikutnya

Setelah memiliki project Google Cloud, kunci API, dan project Android Studio yang disiapkan untuk digunakan dengan Maps 3D SDK untuk Android, Anda dapat Menambahkan peta 3D ke aplikasi Anda.