Map Management API 是一种 RESTful API,可用于以编程方式管理云端地图样式设置资源。借助此 API,您可以定义地图的视觉外观、管理地图身份,以及将自定义样式和数据集与特定地图变体相关联,而无需使用 Cloud 控制台。
Map Management API 专为希望大规模管理地图配置或将地图样式集成到自己的自动化工作流和内部工具中的开发者而设计。
重要资源
- StyleConfig:包含地图样式的 JSON 表示法。此元素用于定义地图项的颜色、可见性和密度。
- MapConfig:表示唯一的地图身份(地图 ID)。它充当样式设置和功能(例如 POI 增强或建筑物扁平化)的容器。
- MapContextConfig:将
StyleConfig(以及可选的一个或多个数据集)与MapConfig中的特定MapVariants相关联。
API 版本控制渠道
Map Management API 使用基于渠道的版本控制,以便为从实验性功能到稳定、正式版功能的过渡提供清晰的路径。
- v2alpha(实验性):包含最新的实验性功能。 此渠道中的功能可能会在不另行通知的情况下发生变化,因此不建议用于生产用途。
- v2beta(预览版):包含稳定且正在准备正式版的功能。此渠道适合在预生产环境中进行早期采用和测试。
- v2(正式版):包含完全受支持且可用于生产用途的功能。
在各自的推出阶段,大多数 v2 功能都可在 v2alpha 和 v2beta 端点上使用。对于新用户,Google 建议从 v2beta 端点开始。
身份验证
您只能使用 OAuth 2.0 向 Map Management API 进行身份验证,该 API 不支持 API 密钥。如需了解详情,请参阅使用 OAuth。
限制
- 开发者角色:如需使用 Map Management API,您必须拥有必要的 IAM 权限,才能在 Google Cloud 项目中管理 Google Maps Platform 资源。
- 资源范围:此 API 专注于管理基于云的地图样式资源。其他 Google Maps Platform 配置可能仍需要使用 Cloud 控制台。
费用
Map Management API 可免费使用。API 调用会显示在 Cloud 控制台的“结算”页面上,但费用将为 0 美元。不过,请求会受到以下限制:
- 3 QPS(每秒查询次数)
- 每个项目每分钟 180 次查询 (QPM),每分钟刷新一次
- 每个项目的 QPD(每日查询次数)为 10 万,每天刷新一次
请参阅使用量和结算。