Map ID overview

  • Map IDs are unique identifiers used to represent a single Google Map instance, enabling features like cloud-based styling and advanced markers.

  • You can create map IDs for various platforms (JavaScript, Android, iOS, Static Maps) through the Google Cloud Console.

  • Cloud-based map styling allows you to customize and manage map styles centrally, with automatic updates across platforms.

  • A variety of features and APIs utilize map IDs, including Advanced markers, Data-driven styling, and the Maps Embed API.

  • Using a map ID with Maps SDK for Android or iOS will result in charges against the Dynamic Maps SKU.

Paid feature: Features accessed by adding amap ID triggers a map load charged against the Dynamic Maps SKU for Android and iOS. SeeGoogle 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 theMap Management page.

For how to create map IDs, seeHow to create map IDs.

What you can do with map IDs

Use map IDs to enable features and styling. Here are some examples of how touse map IDs. For a full list, seeFeatures that use map IDs:

  • Cloud-based maps styling: Associate a map ID with a map style tostyle, customize, and manage your maps using the Google Cloud console.Available on all platforms:Android,iOS,JavaScript,andMaps Static API.

  • Vector maps: Use a map ID to use a map composed of vector-based tilesthat are drawn at load time on the client side using WebGL.Available onJavaScript.

  • Advanced markers: Use a map ID to enable Advanced markers. Available onAndroid,iOS, andJavaScript.

Example for cloud-based maps styling

To use cloud-based maps styling to style maps on your website and Android apps,follow these steps:

  1. Create map IDs for each platform you are using. For example, create aJavaScript and an Android map ID. For details, seeCreate map IDs.

  2. Configure a map style on the Google Cloud console. For details, seecloud-based maps styling.

  3. Associate both of your map IDs with the map style in the Google Cloud console.For details, seeAssociate map IDs with your style.

  4. Reference the map ID in your website JavaScript and your Android app code.For details, seeAdd a map ID to your app.

The map style associated with your map IDs is then displayed on your website andin your Android app. You can make updates to your map style in theCloud console, and changes appear in both places automatically,without the need for any app updates by your customers.

Features that use map IDs

The following table shows the Google Maps Platform features and APIs that usemap IDs:

Feature or APIUses map IDs to accomplish these goals
Advanced markersEnable advanced markers. You don't need to create a map ID, and can instead use the demo map IDDEMO_MAP_ID.
Data-driven styling for boundariesAssociate the map ID with a set of boundaries and styling to style the map according to the boundaries.
Data-driven styling for datasetsAssociate the map ID with a set of data and styling to style the map according to the dataset.
FlutterStyle the Google maps used in your Flutter apps.
Maps Embed APISpecify and style the map to be embedded on a web page.
Maps JavaScript APIStyle the map to be displayed on a web page.
Maps SDK for AndroidStyle the map to be displayed in an Android application.1
Maps SDK for iOSStyle the map to be displayed in an iOS application.1
Maps Static APISpecify and style the map to be rendered as a static image.
Mobility solutionsUse the Maps JavaScript API and SDKs for Android and iOS to style maps in Mobility solutions.1
Navigation SDK for AndroidStyle the map to be displayed in an Android application.1
Navigation SDK for iOSStyle the map to be displayed in an iOS application.1
WebGL (Vector maps)Enable WebGL features using a JavaScript vector map ID.

1 Using a map ID on Maps SDK for Android, Maps SDK for iOS, Navigation SDK for Android, or Navigation SDK for iOS triggers a map load that is charged against theDynamic Maps SKU.

Next steps

Create a map ID

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-10-10 UTC.