Menggunakan ID Peta

ID peta adalah ID yang Anda buat di Google Cloud Console, yang dikaitkan dengan gaya, lalu dimasukkan ke kode aplikasi Anda untuk menerapkan gaya tersebut ke peta Anda.

Setelah dibuat, ID Peta dikaitkan dengan sebuah project, dan juga dibatasi untuk satu platform (Android, iOS, JavaScript) atau untuk Maps Static API.

Untuk membuat atau mengelola ID Peta di Cloud Console, Anda harus memiliki peran IAM Pemilik Project atau Editor Project.

Membuat ID Peta

ID Peta adalah ID unik yang mewakili satu instance Peta Google. Anda dapat membuat ID Peta dan memperbarui gaya yang dikaitkan dengan sebuah ID Peta kapan saja di Cloud Console.

Untuk membuat ID Peta:

  1. Di Cloud Console, buka halaman Pengelolaan Peta.
  2. Pilih Buat ID Peta Baru untuk menampilkan formulir Buat ID Peta Baru.
    Buat ID Peta Baru

    Dalam formulir, lakukan hal berikut:

    • Tentukan nama peta.
    • Tentukan jenis atau platform peta.
    • Untuk peta JavaScript, pilih jenis peta raster atau vektor.
    • Masukkan deskripsi peta.
    • Pilih Berikutnya untuk menampilkan ID Peta baru.

Mengaitkan ID Peta ke gaya peta

Petunjuk ini mengasumsikan bahwa setidaknya ada satu gaya peta yang sudah ada dalam project Anda.

  1. Di Cloud Console, buka halaman Pengelolaan Peta.
  2. Pada halaman ini, pilih ID Peta yang sudah ada dari kolom Nama peta.
  3. Di bagian bawah formulir ini, pilih gaya peta dari menu drop-down Gaya peta yang terkait dengan ID Peta ini.
  4. Pilih Simpan.
    Screenshot yang menampilkan halaman detail untuk satu ID Peta, termasuk kolom drop-down yang memungkinkan pengguna mengaitkan gaya peta dengan ID Peta ini.

Menambahkan ID Peta ke aplikasi Anda

Tambahkan ID Peta melalui elemen <fragment> dalam file tata letak aktivitas, dengan menggunakan class MapView, atau secara terprogram menggunakan class GoogleMapOptions.

Misalnya, Anda membuat ID Peta yang disimpan sebagai nilai string dengan nama map_id di res/values/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">YOUR_MAP_ID</string>
</resources>

Untuk peta yang ditambahkan melalui elemen <fragment> dalam file tata letak aktivitas, semua fragmen peta yang perlu memiliki gaya kustom harus menentukan ID Peta di atribut map:mapId:

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    class="com.google.android.gms.maps.SupportMapFragment"
    …
    map:mapId="@string/map_id" />

Anda juga dapat menggunakan atribut map:mapId dari class MapView untuk menentukan ID Peta:

<com.google.android.gms.maps.MapView
    xmlns:android="http://schemas.android.com/apk/res/android"
    ....
    map:mapId="@string/map_id" />

Untuk menentukan ID Peta secara terprogram, teruskan ke instance MapFragment menggunakan class GoogleMapOptions:

Java

  MapFragment mapFragment = MapFragment.newInstance(
      new GoogleMapOptions()
          .mapId(getResources().getString(R.string.map_id)));

Kotlin

  val mapFragment = MapFragment.newInstance(
      GoogleMapOptions()
          .mapId(resources.getString(R.string.map_id))
  )

Di Android Studio, build dan jalankan aplikasi seperti biasanya. Gaya kustom, seperti yang telah dikonfigurasi pada langkah pertama, akan diterapkan ke semua peta yang memiliki ID.