Parametri di richiesta obbligatori

Per effettuare qualsiasi richiesta all'API di gestione delle mappe, devi includere quanto segue nelle intestazioni e negli URL:

  • Identificatore progetto: il numero o l'ID del tuo progetto Google Cloud nell'intestazione X-Goog-User-Project. Questo valore determina il progetto utilizzato per i calcoli di fatturazione e quota.

  • Intestazione di autorizzazione: un token OAuth 2.0 nell'intestazione Authorization. Per saperne di più, consulta Utilizza OAuth.

  • Nome risorsa: un numero o un ID progetto Google Cloud nell'URL della richiesta, insieme all'ID risorsa specifico (ad esempio mapConfigId o styleConfigId).

Esempio: crea un MapConfig

L'esempio seguente mostra come creare un oggetto MapConfig utilizzando curl. Quando invii questa richiesta, ricevi l'oggetto appena creato in risposta se la creazione di MapConfig è stata completata correttamente.

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

Se la richiesta va a buon fine, ricevi l'oggetto di configurazione della mappa appena creato: 

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

Esempio: elimina un MapConfig

L'esempio seguente mostra come eliminare un oggetto MapConfig utilizzando curl. Quando invii questa richiesta, ricevi un oggetto JSON vuoto {} in risposta se MapConfig è stato trovato ed eliminato correttamente.

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

Se la richiesta ha esito positivo, ricevi un oggetto di risposta vuoto: 

{}

Recuperare il numero di progetto

Per ottenere il numero o l'ID del tuo progetto Google Cloud:

  1. Vai alla pagina Panoramica del progetto nella console Cloud.
  2. Il Numero progetto e l'ID progetto vengono visualizzati nell'area Informazioni sul progetto.

Ottenere un token OAuth

Per lo sviluppo o il test, puoi utilizzare la CLI gcloud per generare un token OAuth temporaneo:

gcloud auth application-default print-access-token

Puoi includere il comando gcloud direttamente nell'intestazione Authorization di una richiesta curl, come mostrato negli esempi precedenti. In alternativa, imposta una variabile di ambiente:

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