必須のリクエスト パラメータ

Map Management API にリクエストを行うには、ヘッダーと URL に次のものを含める必要があります。

  • プロジェクト識別子: X-Goog-User-Project ヘッダーの Google Cloud プロジェクトのプロジェクト番号または ID。この値によって、課金と割り当ての計算に使用されるプロジェクトが決まります。

    X-Goog-User-Project

  • 認証ヘッダー: Authorization ヘッダーの OAuth 2.0 トークン。詳細については、OAuth を使用するをご覧ください。

  • リソース名: リクエスト URL の 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
  }
}'

リクエストが成功すると、新しく作成された MapConfig オブジェクトが返されます。 

{
  "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