Stay organized with collections Save and categorize content based on your preferences.
Paid feature: Features accessed by adding a map ID triggers a map load charged against the Dynamic Maps SKU for Android and iOS. See Google Maps Billing for more information.
A 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.
For more details and features that use map IDs, see Map ID overview.
Required permissionsTo create or manage any map IDs in your project, you must use a principal with the appropriate role-level permissions, Editor or Owner, on the Cloud console IAM page for the project. For details, see IAM basic and predefined roles reference.
Create map IDsCreate map IDs in the Cloud console following these steps:
Sign in to and open a Cloud console project with the required permissions.
In the Cloud console, go to the Maps Management page.
Click Create map ID.
On the Create new map ID page, do the following:
If you are using cloud-based maps styling, you associate a map style with your map ID. For details, see Associate your style to a map ID.
Add the map ID to your app AndroidAdd your map ID through a <fragment>
element in the activity's layout file, by using the MapView
class, or programmatically using the GoogleMapOptions
class.
For example, assume you created a map ID that is stored as a string value named map_id
in res/values/strings.xml
:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">MAP_ID</string>
</resources>
For maps added through a <fragment>
element in the activity's layout file, all map fragments that should have the custom style must specify the map ID in the map:mapId
attribute:
<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
map:name="com.google.android.gms.maps.SupportMapFragment"
…
map:mapId="@string/map_id" />
You can also use the map:mapId
attribute of the MapView
class to specify a map ID:
<com.google.android.gms.maps.MapView
xmlns:map="http://schemas.android.com/apk/res-auto"
....
map:mapId="@string/map_id" />
To specify a map ID programmatically, pass it to a MapFragment
instance using the GoogleMapOptions
class:
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))
)
In Android Studio, build and run your app as you normally would. Custom styles configured in the first step are applied to all maps with the specified map ID.
iOSTo instantiate a map using a map ID, do the following:
GMSMapID
with the map ID string from Cloud console.GMSMapView
specifying the map ID you just created.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;
If you are using your own map ID, you can set your map ID in the Cloud console to have a new style at any time, and that style will be reflected on your map view automatically for you and users within about six hours.
If you want to see the changes immediately, you can close out and restart your app by exiting the app, forcing a quit of the app from the recently-used apps list, and then reopening it. The updated map will then be visible.
JavaScriptTo create a map with a map ID in your application code:
If you are already customizing your map with embedded JSON code, remove the styles
property from your MapOptions
object; otherwise, skip this step.
Add a map ID to the map using the mapId
property. For example:
map = new google.maps.Map(document.getElementById('map'), { center: {lat: -34.397, lng: 150.644}, zoom: 8, mapId: 'MAP_ID' });Maps Static
To add a map ID to a new or existing map that uses one of our web-service APIs, append the map_id
URL parameter and set it to your map ID. This example shows adding a map ID to a map using 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" />
If you have a digital signature in your Maps Static URL before adding your map ID, you will need to
create and add a new digital signatureafter adding your map ID. When generating your new URL signing secret, remember to remove your previous digital signature from the URL.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-23 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-23 UTC."],[[["A map ID is a unique identifier used to represent Google Map styling and configuration settings stored in Google Cloud, allowing you to manage and style maps on websites and in applications."],["You can create map IDs for JavaScript, Android, iOS, or Static maps within your Google Cloud console project on the Map Management page, and they require appropriate permissions (Editor or Owner) to manage."],["Associating a map ID with a map style, particularly for cloud-based maps, allows for custom styling, and these changes can take up to six hours to be reflected on the map, or can be forced by restarting the app."],["To add a map ID to your application, you can use various methods, including through `\u003cfragment\u003e` elements, the `MapView` class, or programmatically via the `GoogleMapOptions` class for Android, or by creating a `GMSMapID` for iOS, or by using the `mapId` property in JavaScript."],["Adding a map ID to web-service APIs, like Maps Static, involves appending the `map_id` URL parameter, which may necessitate creating a new digital signature for the URL if one was previously present."]]],["Map IDs are unique identifiers for Google Map styling and configurations. To create one, sign in to the Google Cloud console, navigate to the Maps Management page, and click \"Create map ID.\" Name it, optionally add a description, and select the platform (JavaScript, Android, iOS, or Static maps). Add the map ID to your app through platform-specific methods: `\u003cfragment\u003e` or `MapView` class in Android, `GMSMapView` in iOS, `mapId` property in JavaScript, and `map_id` URL parameter in Maps Static.\n"]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4