必要的要求參數

如要向 Map Management API 提出任何要求，您必須在標頭和網址中加入下列項目：

  • 專案 ID：X-Goog-User-Project 標頭中 Google Cloud 專案的專案編號或 ID。這個值會決定用於帳單和配額計算的專案。

  • 授權標頭：Authorization 標頭中的 OAuth 2.0 權杖。詳情請參閱「使用 OAuth」。

  • 資源名稱：要求網址中的 Google Cloud 雲端專案編號或 ID，以及特定資源 ID (例如 mapConfigId 或 styleConfigId)。

範例：建立 MapConfig

以下範例說明如何使用 curl 建立 MapConfig 物件。如果 MapConfig 建立作業成功完成，傳送這項要求後，您會在回應中收到新建立的物件。

curl -X POST \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs -d '{
  "displayName": "My New York Map",
  "description": "A Map for New York City",
  "mapType" : "VECTOR",
  "mapFeatures": {
    "simpleFeatures": ["FLATTEN_BUILDINGS", "ICONIC_ICONS"],
    "poiBoostLevel": 1
  }
}'

如果要求成功，您會收到新建立的 Map Config 物件： 

{
  "name": "projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID",
  "displayName": "Testing No Type",
  "description": "Testing",
  "mapId": "YOUR_MAP_CONFIG_ID",
  "mapFeatures": {
    "simpleFeatures": [
      "FLATTEN_BUILDINGS",
      "ICONIC_ICONS"
    ],
    "poiBoostLevel": 1
  },
  "createTime": "2026-02-07T20:04:11.467243390Z",
  "updateTime": "2026-02-07T20:04:11.467243542Z",
  "mapType": "VECTOR"
}

範例：刪除 MapConfig

以下範例說明如何使用 curl 刪除 MapConfig 物件。傳送這項要求後，如果系統找到並成功刪除 MapConfig，您會收到空白的 JSON 物件 {} 做為回應。

curl -X DELETE \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID

如果要求成功，您會收到空白的回應物件： 

{}

取得專案編號

如要取得 Google Cloud 專案的編號或 ID，請按照下列步驟操作：

  1. 前往 Cloud 控制台的專案總覽頁面。
  2. 「專案資訊」區域會顯示「專案編號」和「專案 ID」。

取得 OAuth 權杖

如要進行開發或測試，可以使用 gcloud CLI 產生臨時 OAuth 權杖：

gcloud auth application-default print-access-token

您可以直接在 curl 要求的 Authorization 標頭中加入 gcloud 指令，如先前的範例所示。或者，您也可以設定環境變數：

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X GET \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $TOKEN" \
https://mapmanagement.googleapis.com/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs