Map Management API 是一种 RESTful API,可用于以编程方式管理云端地图样式设置资源。借助此 API,您可以定义地图的视觉外观、管理地图标识,以及将自定义样式和数据集与特定地图变体相关联,而无需使用 Cloud 控制台。
Map Management API 专为希望大规模管理地图配置或将地图样式设置集成到自己的自动化工作流和内部工具中的开发者而设计。
重要资源
- StyleConfig:包含地图样式的 JSON 表示法。这会定义地图项的颜色、可见性和密度。
- MapConfig:表示唯一的地图身份(地图 ID)。它充当样式设置和功能(例如地图注点提升或建筑物扁平化)的容器。
- 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(每分钟查询次数),每分钟刷新一次
- 每个项目每天 100,000 次查询 (QPD),每天刷新
请参阅用量和结算。