Erforderliche Anfrageparameter

Wenn Sie eine Anfrage an die Map Management API stellen, müssen Sie Folgendes in Ihre Header und URLs aufnehmen:

  • Projekt-ID: Die Projektnummer oder ‑ID Ihres Google Cloud-Projekts in der X-Goog-User-Project-Kopfzeile. Dieser Wert bestimmt das Projekt, das für die Abrechnung und Kontingentberechnungen verwendet wird.

  • Autorisierungsheader: Ein OAuth 2.0-Token im Authorization-Header. Weitere Informationen finden Sie unter OAuth verwenden.

  • Ressourcenname: Eine Google Cloud-Projektnummer oder ‑ID in der Anfrage-URL zusammen mit der spezifischen Ressourcen-ID (z. B. mapConfigId oder styleConfigId).

Beispiel: MapConfig erstellen

Im folgenden Beispiel wird gezeigt, wie Sie ein MapConfig-Objekt mit curl erstellen. Wenn Sie diese Anfrage senden, erhalten Sie das neu erstellte Objekt in der Antwort, sofern die MapConfig-Erstellung erfolgreich abgeschlossen wurde.

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
  }
}'

Wenn die Anfrage erfolgreich ist, erhalten Sie das neu erstellte Map Config-Objekt: 

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

Beispiel: MapConfig löschen

Im folgenden Beispiel wird gezeigt, wie Sie ein MapConfig-Objekt mit curl löschen. Wenn Sie diese Anfrage senden, erhalten Sie als Antwort ein leeres JSON-Objekt {}, wenn die MapConfig gefunden und erfolgreich gelöscht wurde.

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

Wenn die Anfrage erfolgreich ist, erhalten Sie ein leeres Antwortobjekt: 

{}

Projektnummer abrufen

So rufen Sie die Nummer oder ID Ihres Google Cloud-Projekts ab:

  1. Rufen Sie in der Cloud Console die Übersichtsseite des Projekts auf.
  2. Die Projektnummer und die Projekt-ID werden im Bereich Projektinformationen angezeigt.

OAuth-Token abrufen

Für die Entwicklung oder das Testen können Sie mit der gcloud-CLI ein temporäres OAuth-Token generieren:

gcloud auth application-default print-access-token

Sie können den Befehl gcloud direkt in den Header Authorization einer curl-Anfrage einfügen, wie in den Beispielen oben gezeigt. Alternativ können Sie eine Umgebungsvariable festlegen:

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