Map Management API 總覽

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),每天更新

請參閱「用量與計費」。