Map Management API 是 RESTful API,可透過程式輔助方式管理雲端式地圖樣式設定資源。您可以使用這項 API 定義地圖的視覺外觀、管理地圖 ID,以及將自訂樣式和資料集與特定地圖變體建立關聯,完全不需要使用 Cloud 控制台。
Map Management API 專為開發人員設計,可大規模管理地圖設定,或將地圖樣式整合至自動化工作流程和內部工具。
重要資源
- StyleConfig:包含地圖樣式的 JSON 表示法。這會定義地圖項目的顏色、顯示設定和密度。
- MapConfig:代表不重複的地圖 ID。這個容器可裝載樣式設定和功能,例如搜尋點提升或建築物平面化。
- MapContextConfig:將
StyleConfig(以及一或多個選用資料集) 與MapConfig中的特定MapVariants建立關聯。
API 版本管理管道
地圖管理 API 採用以管道為準的版本管理方式,可清楚呈現從實驗功能到穩定正式發布的演進過程。
- v2alpha (實驗功能):包含最新的實驗功能。 這個管道中的功能可能會隨時變更,因此不建議用於實際工作環境。
- v2beta (預先發布版):包含穩定且準備正式發布的功能。這個管道適合在試前環境中搶先採用及測試。
- 第 2 版 (正式發布):包含完全支援且可立即用於正式環境的功能。
在各自的推出階段,v2alpha 和 v2beta 端點都提供大多數的 v2 功能。如果是新使用者,Google 建議從 v2beta 端點開始。
驗證
您只能使用 OAuth 2.0 向地圖管理 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 次查詢,每分鐘重新整理一次
- 專案每日 10 萬次查詢,每天重新計算
請參閱「用量與帳單」。