地图 ID 是表示存储在 Google Cloud 中的 Google 地图样式和配置设置的唯一标识符。您可以使用地图 ID 在网站和应用中启用功能或管理地图,也可以为地图设置样式。您可以在 Google Cloud 控制台项目的地图管理 页面中,为所需的每个平台(JavaScript、Android、iOS 或静态地图)创建地图 ID。
如需了解如何创建地图 ID,请参阅如何创建地图 ID。
地图 ID 的用途
您可以使用地图 ID 来启用功能和样式。以下是一些使用地图 ID 的示例。如需查看完整列表,请参阅使用地图 ID 的功能:
云端地图样式设置:将地图 ID 与地图样式相关联,以便使用 Google Cloud 控制台为地图设置样式、自定义地图和管理地图。适用于所有平台: Android、 iOS、 JavaScript、 和 Maps Static API。
矢量地图:使用地图 ID 来使用由矢量图块组成的地图,这些图块在加载时使用 WebGL 在客户端绘制。适用于 JavaScript。
高级标记:使用地图 ID 来启用高级标记。适用于 Android、 iOS 和 JavaScript。
云端地图样式设置示例
如需使用云端地图样式设置为网站和 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:
| 功能或 API | 使用地图 ID 来实现以下目标 |
|---|---|
| 高级标记 | 启用高级标记。您无需创建
地图 ID,而是可以使用演示地图 ID DEMO_MAP_ID。 |
| 边界的数据驱动型样式 | 将地图 ID 与一组边界和样式相关联,以便根据边界为地图设置样式。 |
| 数据集的数据驱动型样式 | 将地图 ID 与一组数据和样式相关联,以便根据数据集为地图设置样式。 |
| Flutter | 为 Flutter 应用中使用的 Google 地图设置样式。 |
| 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 |
| 适用于 Android 的 Navigation SDK | 为 Android 应用中显示的地图设置样式。1 |
| 适用于 iOS 的 Navigation SDK | 为 iOS 应用中显示的地图设置样式。1 |
| WebGL(矢量地图) | 使用 JavaScript 矢量地图 ID 启用 WebGL 功能。 |
1 在 Maps SDK for Android、Maps SDK for iOS、适用于 Android 的 Navigation SDK 或适用于 iOS 的 Navigation SDK 中使用地图 ID 会触发地图加载次数,该加载次数需支付 动态地图 SKU 的费用。