Map Management API 是 RESTful API,可讓您透過程式輔助方式,管理雲端式地圖樣式設定資源。您可以使用這個 API 定義地圖的視覺外觀、管理地圖 ID,以及將自訂樣式和資料集與特定地圖變化版本建立關聯,完全不必使用 Cloud 控制台。
Map Management API 專為開發人員設計,可大規模管理地圖設定,或將地圖樣式整合至自己的自動化工作流程和內部工具。
重要資源
- StyleConfig:包含地圖樣式的 JSON 表示法。這會定義地圖項目的顏色、顯示設定和密度。
- MapConfig:代表不重複的地圖 ID。可做為樣式設定和功能的容器,例如搜尋點強化或建築物平面化。
- MapContextConfig:將
StyleConfig(以及一或多個選用資料集) 與MapConfig內的特定MapVariants建立關聯。
API 版本管理管道
Map Management API 採用以管道為基礎的版本管理機制,提供從實驗功能到穩定正式發布版的明確路徑。
- v2alpha (實驗版):包含最新的實驗功能。這個版本的功能可能會隨時變更,恕不另行通知,因此不建議用於正式環境。
- v2beta (預先發布版):包含穩定且準備正式發布的功能。這個版本適合在試產環境中早期採用及測試。
- v2 (正式發布版):包含完全支援、可用於正式環境的功能。
在各自的推出階段,v2alpha 和 v2beta 端點都支援大部分的第 2 版功能。如果是新使用者,Google 建議從 v2beta 端點開始。
驗證
您「只能」使用 OAuth 2.0 向 Map Management API 進行驗證,該 API 不支援 API 金鑰。詳情請參閱「使用 OAuth」。
限制
- 開發人員角色:如要使用 Map Management API,您必須具備必要的 IAM 權限,才能管理 Google Cloud 專案中的 Google 地圖平台資源。
- 資源範圍:這個 API 著重於管理雲端式地圖樣式設定資源。其他 Google Maps Platform 設定可能仍需透過 Cloud 控制台進行。
費用
使用 Map Management API 不會產生費用。API 呼叫會顯示在 Cloud 控制台的「Billing」(帳單) 頁面,但費用為 $0 美元。不過,要求會受到下列限制:
- 3 QPS (每秒查詢次數)
- 每項專案每分鐘 180 次查詢 (每分鐘更新一次)
- 每項專案每日 100,000 次查詢 (QPD),每天更新
請參閱「用量與計費」。