地图 ID 概览
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
地图 ID 是表示存储在 Google Cloud 中的 Google 地图样式和配置设置的唯一标识符。您可以使用地图 ID 在网站和应用中启用功能或管理地图和设置地图样式。您可以在 Google Cloud 控制台项目的地图管理页面中,为所需的每个平台(JavaScript、Android、iOS 或静态地图)创建地图 ID。
如需了解如何创建地图 ID,请参阅如何创建地图 ID。
地图 ID 的用途
使用地图 ID 启用功能和样式设置。以下是一些有关如何使用地图 ID 的示例。如需查看完整列表,请参阅使用地图 ID 的功能:
云端地图样式设置示例
如需使用云端地图样式设置来设置网站和 Android 应用中的地图样式,请按以下步骤操作:
为所使用的每个平台创建地图 ID。例如,创建 JavaScript 和 Android 地图 ID。如需了解详情,请参阅创建地图 ID。
在 Google Cloud 控制台中配置地图样式。如需了解详情,请参阅云端地图样式设置。
在 Google Cloud 控制台中,将这两个地图 ID 都与地图样式相关联。
如需了解详情,请参阅将地图 ID 与样式相关联。
在网站 JavaScript 和 Android 应用代码中引用地图 ID。
如需了解详情,请参阅为您的应用添加地图 ID。
然后,与地图 ID 相关联的地图样式会显示在您的网站和 Android 应用中。您可以在 Cloud 控制台中更新地图样式,所做更改会自动显示在网站和应用中,无需客户进行任何应用更新。
使用地图 ID 的功能
下表列出了使用地图 ID 的 Google Maps Platform 功能和 API:
1 在 Maps SDK for Android 或 Maps SDK for iOS 上使用地图 ID 会触发地图加载,该加载需支付动态地图 SKU 的费用。
后续步骤
创建地图 ID
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-31。
[null,null,["最后更新时间 (UTC):2025-08-31。"],[[["\u003cp\u003eMap IDs are unique identifiers used to manage and style Google Maps on websites and applications, enabling features and configurations stored in Google Cloud.\u003c/p\u003e\n"],["\u003cp\u003eMap IDs support cloud-based map styling across Android, iOS, JavaScript, and Static Maps, allowing for consistent customization and management of maps through the Google Cloud console.\u003c/p\u003e\n"],["\u003cp\u003eUsing map IDs allows for the activation of advanced features like vector maps and advanced markers, enhancing the user experience with Google Maps.\u003c/p\u003e\n"],["\u003cp\u003eCreating and associating map IDs with a specific map style allows for automatic updates to be displayed across the multiple specified platforms, without the need for app updates.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing map IDs with the Maps SDK for Android or iOS will result in a charge against the Dynamic Maps SKU.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/maps/documentation/android-sdk/map-ids/mapid-over \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/map-ids/mapid-over \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/map-ids/mapid-over \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/maps-static/map-ids/mapid-over \"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 how to create map IDs, see [How to create map IDs](/maps/documentation/maps-static/map-ids/get-map-id).\n\nWhat you can do with map IDs\n\nUse map IDs to enable features and styling. Here are some examples of how to\nuse map IDs. For a full list, see [Features that use map IDs](#features-available):\n\n- **Cloud-based maps styling** : Associate a map ID with a map style to\n style, customize, and manage your maps using the Google Cloud console.\n Available on all platforms:\n [Android](/maps/documentation/android-sdk/cloud-customization),\n [iOS](/maps/documentation/ios-sdk/cloud-customization),\n [JavaScript](/maps/documentation/javascript/cloud-customization),\n and [Maps Static API](/maps/documentation/maps-static/cloud-customization).\n\n- **Vector maps** : Use a map ID to use a map composed of vector-based tiles\n that are drawn at load time on the client side using WebGL.\n Available on [JavaScript](/maps/documentation/javascript/vector-map).\n\n- **Advanced markers** : Use a map ID to enable Advanced markers. Available on\n [Android](/maps/documentation/android-sdk/advanced-markers/overview),\n [iOS](/maps/documentation/ios-sdk/advanced-markers/overview), and\n [JavaScript](/maps/documentation/javascript/advanced-markers/overview).\n\nExample for cloud-based maps styling\n\nTo use cloud-based maps styling to style maps on your website and Android apps,\nfollow these steps:\n\n1. Create map IDs for each platform you are using. For example, create a\n JavaScript and an Android map ID. For details, see\n [Create map IDs](/maps/documentation/maps-static/map-ids/get-map-id).\n\n2. Configure a map style on the Google Cloud console. For details, see\n [cloud-based maps styling](/maps/documentation/javascript/cloud-customization/map-styles-leg).\n\n3. Associate both of your map IDs with the map style in the Google Cloud console.\n For details, see [Associate map IDs with your style](/maps/documentation/javascript/cloud-customization/map-styles-leg#associate-style-with-map-id).\n\n4. Reference the map ID in your website JavaScript and your Android app code.\n For details, see [Add a map ID to your app](/maps/documentation/maps-static/map-ids/get-map-id#add-a-map-id-to-your-app).\n\nThe map style associated with your map IDs is then displayed on your website and\nin your Android app. You can make updates to your map style in the\nCloud console, and changes appear in both places automatically,\nwithout the need for any app updates by your customers.\n\nFeatures that use map IDs\n\nThe following table shows the Google Maps Platform features and APIs that use\nmap IDs:\n\n| Feature or API | Uses map IDs to accomplish these goals |\n|-----------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|\n| [Advanced markers](/maps/documentation/javascript/advanced-markers/overview) | Enable advanced markers. You don't need to create a map ID, and can instead use the demo map ID `DEMO_MAP_ID`. |\n| [Data-driven styling for boundaries](/maps/documentation/android-sdk/dds-boundaries/overview) | Associate the map ID with a set of boundaries and styling to style the map according to the boundaries. |\n| [Data-driven styling for datasets](/maps/documentation/android-sdk/dds-datasets/overview) | Associate the map ID with a set of data and styling to style the map according to the dataset. |\n| [Flutter](/maps/documentation/cross-platform/navigation) | Style the Google maps used in your Flutter apps. |\n| [Maps Embed API](/maps/documentation/embed/get-started) | Specify and style the map to be embedded on a web page. |\n| [Maps JavaScript API](/maps/documentation/javascript/cloud-customization) | Style the map to be displayed on a web page. |\n| [Maps SDK for Android](/maps/documentation/android-sdk/cloud-customization) | Style the map to be displayed in an Android application.^1^ |\n| [Maps SDK for iOS](/maps/documentation/ios-sdk/cloud-customization) | Style the map to be displayed in an iOS application.^1^ |\n| [Maps Static API](/maps/documentation/maps-static/cloud-customization) | Specify and style the map to be rendered as a static image. |\n| [Mobility solutions](/maps/documentation/mobility/journey-sharing/on-demand/javascript/style) | Use the Maps JavaScript API and SDKs for Android and iOS to style maps in Mobility solutions.^1^ |\n| [WebGL (Vector maps)](/maps/documentation/javascript/webgl) | Enable WebGL features using a JavaScript vector map ID. |\n\n^1^ Using a map ID on Maps SDK for Android or Maps SDK for iOS\ntriggers a map load that is charged against the Dynamic Maps SKU.\n\nNext steps\n\n[Create a map ID](/maps/documentation/maps-static/map-ids/get-map-id)"]]