Paramètres de requête obligatoires

Pour envoyer une requête à l'API Map Management, vous devez inclure les éléments suivants dans vos en-têtes et URL :

  • Identifiant de projet : numéro ou ID de votre projet Google Cloud dans l'en-tête X-Goog-User-Project. Cette valeur détermine le projet utilisé pour la facturation et le calcul des quotas.

  • En-tête d'autorisation : jeton OAuth 2.0 dans l'en-tête Authorization. Pour en savoir plus, consultez Utiliser OAuth.

  • Nom de la ressource : numéro ou ID de projet Google Cloud dans l'URL de la requête, ainsi que l'ID de ressource spécifique (par exemple, mapConfigId ou styleConfigId).

Exemple : Créer un MapConfig

L'exemple suivant montre comment créer un objet MapConfig à l'aide de curl. Lorsque vous envoyez cette requête, vous recevez le nouvel objet en réponse si la création de MapConfig a réussi.

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

Si la requête aboutit, vous recevez l'objet Map Config nouvellement créé : 

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

Exemple : Supprimer un MapConfig

L'exemple suivant montre comment supprimer un objet MapConfig à l'aide de curl. Lorsque vous envoyez cette requête, vous recevez un objet JSON vide {} en réponse si le MapConfig a été trouvé et supprimé.

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

Si la requête aboutit, vous recevez un objet de réponse vide : 

{}

Obtenir le numéro de projet

Pour obtenir le numéro ou l'ID de votre projet Google Cloud :

  1. Accédez à la page Présentation du projet dans la console Cloud.
  2. Le numéro de projet et l'ID du projet s'affichent dans la zone Informations sur le projet.

Obtenir un jeton OAuth

Pour le développement ou les tests, vous pouvez utiliser la CLI gcloud pour générer un jeton OAuth temporaire :

gcloud auth application-default print-access-token

Vous pouvez inclure la commande gcloud directement dans l'en-tête Authorization d'une requête curl, comme indiqué dans les exemples précédents. Vous pouvez également définir une variable d'environnement :

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