ID peta adalah ID unik yang mewakili gaya visual dan setelan konfigurasi Google Maps yang disimpan di Google Cloud. Anda menggunakan ID peta untuk mengaktifkan fitur atau mengelola atau menata peta di situs dan aplikasi Anda. Anda dapat membuat ID peta untuk setiap platform yang Anda butuhkan--JavaScript, Android, iOS, atau Peta statis--di project Konsol Google Cloud Anda pada 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. Untuk mengetahui detailnya, lihat Referensi peran dasar dan bawaan IAM.
Membuat ID peta
Buat ID peta di Konsol Cloud dengan mengikuti langkah-langkah berikut:
Di halaman Buat ID peta baru, lakukan hal berikut:
Untuk Name, beri nama ID peta.
Opsional: Untuk Deskripsi, jelaskan untuk apa ID peta digunakan.
Untuk Map type, pilih platform tempat Anda berencana menggunakan ID peta. Jika Anda memilih JavaScript, pilih juga jenis peta Raster (default) atau Vektor. Untuk mengetahui informasi selengkapnya tentang peta vektor, lihat Peta Vektor.
Klik Simpan untuk menampilkan ID peta baru Anda.
Mengaitkan ID peta ke gaya peta
Jika Anda menggunakan gaya visual peta berbasis cloud, Anda mengaitkan gaya peta dengan ID peta Anda. Untuk mengetahui detailnya, lihat bagian Mengaitkan gaya Anda ke ID peta.
Menambahkan ID peta ke aplikasi Anda
Android
Tambahkan ID peta melalui elemen <fragment> dalam file tata letak aktivitas, 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:
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:
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:
Buat GMSMapID dengan string ID peta dari Konsol Cloud.
Buat GMSMapView yang menentukan ID peta yang baru saja Anda buat.
Jika menggunakan ID peta Anda sendiri, Anda dapat menetapkan ID peta di Konsol Cloud untuk memiliki gaya baru kapan saja, dan gaya tersebut akan ditampilkan di tampilan peta Anda secara otomatis untuk Anda dan pengguna dalam waktu sekitar enam jam.
Jika ingin melihat perubahan secara langsung, Anda dapat menutup dan memulai ulang aplikasi dengan keluar dari aplikasi, menghentikan aplikasi secara paksa dari daftar aplikasi yang baru digunakan, lalu membukanya kembali. Peta yang diperbarui akan terlihat.
JavaScript
Untuk membuat peta dengan ID peta dalam kode aplikasi Anda:
Jika Anda sudah menyesuaikan peta dengan kode JSON tersemat, hapus properti styles dari objek MapOptions; jika tidak, lewati langkah ini.
Tambahkan ID peta ke peta menggunakan properti mapId. Contoh:
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 cara menambahkan ID peta ke peta menggunakan Maps Static API.
Jika Anda 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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-17 UTC."],[[["\u003cp\u003eA map ID is a unique identifier that represents a single Google Map instance, used to manage, style, or enable features on maps across various platforms (JavaScript, Android, iOS, Static Maps).\u003c/p\u003e\n"],["\u003cp\u003eMap IDs are created within the Google Cloud console on the Map Management page, requiring Editor or Owner permissions.\u003c/p\u003e\n"],["\u003cp\u003eTo use a map ID, you need to integrate it into your application code based on the specific platform (JavaScript, Android, iOS, or Static Maps) you're working with, following the provided instructions.\u003c/p\u003e\n"],["\u003cp\u003eCloud-based map styling allows you to associate a style with your map ID, impacting its visual appearance on the map.\u003c/p\u003e\n"],["\u003cp\u003eMap IDs can be added to the Maps Static API by appending the 'map_id' URL parameter, and a new digital signature might be required for existing URLs.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/maps/documentation/android-sdk/map-ids/get-map-id \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/map-ids/get-map-id \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/map-ids/get-map-id \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/maps-static/map-ids/get-map-id \"View this page for the Web Service platform docs.\")\n\n\u003cbr /\u003e\n\n| **Paid feature:**\n| Features accessed by adding a [map ID](/maps/documentation/get-map-id) triggers a map\n| load charged against the Dynamic Maps SKU for Android and iOS. See\n| [Google Maps Billing](/maps/billing-and-pricing/sku-details#dynamic-maps-ess-sku) for more information.\n\nA map ID is a unique identifier that represents Google Map styling and configuration settings that are stored in Google Cloud. You use map IDs to enable features or manage or style maps on your websites and in your applications. You can create map IDs for each platform you need--JavaScript, Android, iOS, or Static maps--in your Google Cloud console project on the **Map Management** page.\n\nFor more details and features that use map IDs,\nsee [Map ID overview](/maps/documentation/javascript/map-ids/mapid-over).\n\nRequired permissions\n\nTo create or manage any map IDs in your project, you\nmust use a principal with the appropriate role-level permissions, Editor or\nOwner, on the Cloud console IAM page for the project. For\ndetails, see\n[IAM basic and predefined roles reference](https://cloud.google.com/iam/docs/understanding-roles#role_types).\n\nCreate map IDs\n\nCreate map IDs in the Cloud console following\nthese steps:\n\n1. Sign in to and open a Cloud console project with the\n [required permissions](#permissions).\n\n2. In the Cloud console, go to the\n [Maps Management page](https://console.cloud.google.com/google/maps-apis/studio/maps).\n\n3. Click **Create map ID**.\n\n4. On the **Create new map ID** page, do the following:\n\n 1. For **Name**, give the map ID a name.\n 2. *Optional* : For **Description**, describe what the map ID is used for.\n 3. For **Map type** , select the platform on which you plan to use the map ID. If you choose JavaScript, also choose a **Raster** (the default) or **Vector** map type. For more information on vector maps, see [Vector Maps](/maps/documentation/javascript/vector-map).\n 4. Click **Save** to show your new map ID.\n\nAssociate a map ID to a map style\n\nIf you are using cloud-based maps styling, you associate a map style with your\nmap ID. For details, see [Associate your style to a map ID](../cloud-customization/map-styles-leg#associate-style-with-map-id).\n\nAdd the map ID to your app \n\nAndroid\n\nAdd your map ID through a `\u003cfragment\u003e` element in the\nactivity's layout file, by using the `MapView` class, or programmatically\nusing the `GoogleMapOptions` class.\n\nFor example, assume you created a map ID that is stored as a\nstring value named `map_id` in `res/values/strings.xml`: \n\n \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n \u003cresources\u003e\n \u003cstring name=\"map_id\"\u003e\u003cvar label=\"map_id\" translate=\"no\"\u003eMAP_ID\u003c/var\u003e\u003c/string\u003e\n \u003c/resources\u003e\n\nFor maps added through a `\u003cfragment\u003e` element in the activity's layout file,\nall map fragments that should have the custom style must specify the\nmap ID in the `map:mapId` attribute: \n\n \u003cfragment xmlns:map=\"http://schemas.android.com/apk/res-auto\"\n map:name=\"com.google.android.gms.maps.SupportMapFragment\"\n ...\n map:mapId=\"@string/map_id\" /\u003e\n\nYou can also use the `map:mapId` attribute of the `MapView` class to specify\na map ID: \n\n \u003ccom.google.android.gms.maps.MapView\n xmlns:map=\"http://schemas.android.com/apk/res-auto\"\n ....\n map:mapId=\"@string/map_id\" /\u003e\n\nTo specify a map ID programmatically, pass it to a\n`MapFragment` instance using the `GoogleMapOptions` class: \n\nJava \n\n MapFragment mapFragment = MapFragment.newInstance(\n new GoogleMapOptions()\n .mapId(getResources().getString(R.string.map_id)));\n\nKotlin \n\n val mapFragment = MapFragment.newInstance(\n GoogleMapOptions()\n .mapId(resources.getString(R.string.map_id))\n )\n\nIn Android Studio, build and run your app as you normally would. Custom\nstyles configured in the first step are applied to all maps with\nthe specified map ID.\n\niOS\n\nTo instantiate a map using a map ID, do the following:\n\n1. Create a `GMSMapID` with the map ID string from Cloud console.\n2. Create a `GMSMapView` specifying the map ID you just created.\n\nSwift \n\n let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)\n let mapID = GMSMapID(identifier: \"\u003cvar label=\"map_id\" translate=\"no\"\u003eMAP_ID\u003c/var\u003e\")\n let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)\n self.view = mapView\n\nObjective-C \n\n GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169\n longitude:-122.336471\n zoom:12];\n GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@\"\u003cvar label=\"map_id\" translate=\"no\"\u003eMAP_ID\u003c/var\u003e\"];\n GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];\n self.view = mapView;\n\nIf you are using your own map ID, you can set your\nmap ID in the Cloud console to have a new style\nat any time, and that style will be reflected on your map view automatically\nfor you and users within about six hours.\n\nIf you want to see the changes immediately, you can close out and restart\nyour app by exiting the app, forcing a quit of the app from the recently-used\napps list, and then reopening it. The updated map will then be visible.\n\nJavaScript\n\nTo create a map with a map ID in your application code:\n\n1. If you are already customizing your map with embedded JSON code, remove\n the\n [`styles` property](/maps/documentation/javascript/reference/map#MapOptions.styles)\n from your `MapOptions` object; otherwise, skip this step.\n\n2. Add a map ID to the map using the `mapId` property. For example:\n\n```javascript\nmap = new google.maps.Map(document.getElementById('map'), {\ncenter: {lat: -34.397, lng: 150.644},\nzoom: 8,\nmapId: '\u003cvar translate=\"no\"\u003eMAP_ID\u003c/var\u003e'\n});\n```\n\nMaps Static\n\nTo add a map ID to a new or existing map that uses one of our\nweb-service APIs, append the `map_id` URL parameter and set it to your\nmap ID. This example shows adding a map ID to\na map using Maps Static API. \n\n \u003cimg 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=\u003cvar label=\"map_id\" translate=\"no\"\u003eMAP_ID\u003c/var\u003e&signature=YOUR_SIGNATURE\" /\u003e\n\nIf you have a digital signature in your Maps Static URL before adding your map ID, you will need to [create\nand add a new digital signature](/maps/documentation/maps-static/digital-signature) after adding your map ID. When generating your new URL signing secret, remember to remove your previous digital signature from the URL."]]
