必需的请求参数

如需向 Map Management API 发出任何请求，您必须在标头和网址中添加以下内容：

  • 项目标识符：Google Cloud 项目在 X-Goog-User-Project 标头中的项目编号或 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