地图 ID 概览

请选择平台： Android iOS JavaScript Web 服务

地图 ID 是表示单个 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 应用中的地图设置样式，请按以下步骤操作：

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

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

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

  4. 在您的网站 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 Embed API 指定要嵌入到网页上的地图并设置其样式。
Maps JavaScript API 为要在网页上显示的地图设置样式。
Maps SDK for Android 为要在 Android 应用中显示的地图设置样式。1
Maps SDK for iOS 为要在 iOS 应用中显示的地图设置样式。1
Maps Static API 指定地图并为其设置样式，以便将其渲染为静态图片。
移动解决方案 使用适用于 Android 和 iOS 的 Maps JavaScript API 和 SDK 为移动解决方案中的地图设置样式。1
WebGL（矢量地图） 使用 JavaScript 矢量地图 ID 启用 WebGL 功能。

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

后续步骤

创建地图 ID