地图 ID 概览

请选择平台: Android iOS JavaScript 网络服务

地图 ID 是表示存储在 Google Cloud 中的 Google 地图样式和配置设置的唯一标识符。您可以使用地图 ID 在网站和应用中启用功能或管理地图和设置地图样式。您可以在 Google Cloud 控制台项目的地图管理页面中,为所需的每个平台(JavaScript、Android、iOS 或静态地图)创建地图 ID。

如需了解如何创建地图 ID,请参阅如何创建地图 ID

地图 ID 的用途

使用地图 ID 启用功能和样式设置。以下是一些有关如何使用地图 ID 的示例。如需查看完整列表,请参阅使用地图 ID 的功能

  • 云端地图样式设置:将地图 ID 与地图样式相关联,以便使用 Google Cloud 控制台设置地图样式、自定义和管理地图。适用于所有平台:AndroidiOSJavaScriptMaps Static API

  • 矢量地图:使用地图 ID 可使用由基于矢量的图块组成的地图,这些图块在加载时使用 WebGL 在客户端绘制。 适用于 JavaScript

  • 高级标记:使用地图 ID 启用高级标记。适用于 AndroidiOSJavaScript

云端地图样式设置示例

如需使用云端地图样式设置来设置网站和 Android 应用中的地图样式,请按以下步骤操作:

  1. 为所使用的每个平台创建地图 ID。例如,创建 JavaScript 和 Android 地图 ID。如需了解详情,请参阅创建地图 ID

  2. 在 Google Cloud 控制台中配置地图样式。如需了解详情,请参阅云端地图样式设置

  3. 在 Google Cloud 控制台中,将这两个地图 ID 都与地图样式相关联。 如需了解详情,请参阅将地图 ID 与样式相关联

  4. 在网站 JavaScript 和 Android 应用代码中引用地图 ID。 如需了解详情,请参阅为您的应用添加地图 ID

然后,与地图 ID 相关联的地图样式会显示在您的网站和 Android 应用中。您可以在 Cloud 控制台中更新地图样式,所做更改会自动显示在网站和 Android 应用中,无需客户进行任何应用更新。

使用地图 ID 的功能

下表列出了使用地图 ID 的 Google Maps Platform 功能和 API:

功能或 API 使用地图 ID 实现这些目标
高级标记 启用高级标记。您无需创建地图 ID,而是可以使用演示地图 ID DEMO_MAP_ID
边界的数据驱动型样式 将地图 ID 与一组边界和样式相关联,以便根据边界设置地图样式。
数据集的数据驱动型样式 将地图 ID 与一组数据和样式相关联,以便根据数据集设置地图样式。
Flutter 设置 Flutter 应用中使用的 Google 地图的样式。
Maps Embed API 指定要嵌入网页的地图并设置其样式。
Maps JavaScript API 设置要在网页上显示的地图的样式。
Maps SDK for Android 设置要在 Android 应用中显示的地图的样式。1
Maps SDK for iOS 设置要在 iOS 应用中显示的地图的样式。1
Maps Static API 指定地图并设置其样式,以便将其渲染为静态图片。
移动解决方案 使用 Maps JavaScript API 以及 Android 和 iOS 版 SDK 在出行解决方案中设置地图样式。1
WebGL(矢量地图) 使用 JavaScript 矢量地图 ID 启用 WebGL 功能。

1 在 Maps SDK for Android 或 Maps SDK for iOS 上使用地图 ID 会触发地图加载,该加载需支付动态地图 SKU 的费用。

后续步骤

创建地图 ID