Cara membuat ID peta

Pilih platform: Android iOS JavaScript Layanan Web

Fitur berbayar: Fungsi yang diakses dengan menambahkan ID peta akan memicu pemuatan peta yang dikenai biaya berdasarkan SKU Dynamic Maps untuk Android dan iOS. Lihat Penagihan Google Maps untuk informasi selengkapnya.

ID peta adalah ID unik yang digunakan untuk mewakili satu instance Google Maps. Anda menggunakan ID peta untuk mengaktifkan fitur atau mengelola atau menata gaya peta di situs dan aplikasi Anda. Anda dapat membuat ID peta untuk setiap platform yang diperlukan--JavaScript, Android, iOS, atau peta Statis--di project konsol Google Cloud Anda di halaman Pengelolaan Peta.

Untuk mengetahui detail dan fitur selengkapnya yang menggunakan ID peta, lihat Ringkasan ID peta.

Izin yang diperlukan

Untuk membuat atau mengelola ID peta di project, Anda harus menggunakan akun utama dengan izin tingkat peran yang sesuai, Editor atau Pemilik, di halaman IAM konsol Cloud untuk project tersebut. Untuk mengetahui detailnya, lihat Referensi peran dasar dan bawaan IAM.

Membuat ID peta

Buat ID peta di konsol Cloud dengan mengikuti langkah-langkah berikut:

1. Login ke dan buka project Cloud Console dengan izin yang diperlukan.

2. Di Cloud Console, buka halaman Pengelolaan Peta.

3. Klik Buat ID peta.

   

4. Di halaman Create new map ID, lakukan hal berikut:

   1. Untuk Name, beri nama ID peta.
   2. Opsional: Untuk Deskripsi, jelaskan kegunaan ID peta.
   3. Untuk Map type, pilih platform tempat Anda berencana menggunakan ID peta. Jika Anda memilih JavaScript, pilih juga jenis peta Raster (default) atau Vector. Untuk informasi selengkapnya tentang peta vektor, lihat Peta Vektor.
   4. Klik Simpan untuk menampilkan ID peta baru.

Mengaitkan ID peta ke gaya peta

Jika menggunakan gaya visual peta berbasis cloud, Anda mengaitkan gaya peta dengan ID peta. Untuk mengetahui detailnya, lihat Mengaitkan.

Menambahkan ID peta ke aplikasi Anda

Android

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">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"
    map:name="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 yang dikonfigurasi pada langkah pertama diterapkan ke semua peta dengan ID peta yang ditentukan.

iOS

Untuk membuat instance peta menggunakan ID peta, lakukan hal berikut:

1. Buat GMSMapID dengan string ID peta dari Konsol Cloud.
2. Buat GMSMapView yang menentukan ID peta yang baru saja Anda buat.

Swift

let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "MAP_ID")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
                                                        longitude:-122.336471
                                                             zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;

Jika menggunakan ID peta Anda sendiri, Anda dapat menetapkan ID peta di Konsol Cloud untuk memiliki gaya baru kapan saja, dan gaya tersebut akan otomatis ditampilkan di tampilan peta untuk Anda dan pengguna dalam waktu sekitar enam jam.

Jika ingin segera melihat perubahan, Anda dapat menutup dan memulai ulang aplikasi dengan keluar dari aplikasi, memaksa aplikasi keluar dari daftar aplikasi yang baru digunakan, lalu membukanya kembali. Peta yang diperbarui kemudian akan terlihat.

JavaScript

Untuk membuat peta dengan ID peta dalam kode aplikasi Anda:

1. Jika Anda sudah menyesuaikan peta dengan kode JSON tersemat, hapus properti styles dari objek MapOptions. Jika tidak, lewati langkah ini.

2. Tambahkan ID peta ke peta menggunakan properti mapId. Contoh:

map = new google.maps.Map(document.getElementById('map'), {
center: {lat: -34.397, lng: 150.644},
zoom: 8,
mapId: 'MAP_ID'
});

Maps Static

Untuk menambahkan ID peta ke peta baru atau yang sudah ada yang menggunakan salah satu API layanan web kami, tambahkan parameter URL map_id dan tetapkan ke ID peta Anda. Contoh ini menunjukkan penambahan ID peta ke peta menggunakan Maps Static API.

<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=MAP_ID&signature=YOUR_SIGNATURE" />

Jika memiliki tanda tangan digital di URL Statis Maps sebelum menambahkan ID peta, Anda harus membuat dan menambahkan tanda tangan digital baru setelah menambahkan ID peta. Saat membuat rahasia penandatanganan URL baru, jangan lupa untuk menghapus tanda tangan digital sebelumnya dari URL.