Parámetros de solicitud obligatorios

Para realizar cualquier solicitud a la API de Map Management, debes incluir lo siguiente en tus encabezados y URLs:

  • Identificador del proyecto: Es el número o ID de tu proyecto de Google Cloud en el encabezado X-Goog-User-Project. Este valor determina el proyecto que se usa para los cálculos de facturación y cuota.

  • Encabezado de autorización: Un token de OAuth 2.0 en el encabezado Authorization. Para obtener más información, consulta Cómo usar OAuth.

  • Nombre del recurso: Es un ID o número de proyecto de Google Cloud en la URL de la solicitud, junto con el ID de recurso específico (como mapConfigId o styleConfigId).

Ejemplo: Crea un MapConfig

En el siguiente ejemplo, se muestra cómo crear un objeto MapConfig con curl. Cuando envías esta solicitud, recibes el objeto recién creado en la respuesta si la creación de MapConfig se completó correctamente.

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 solicitud se realiza correctamente, recibirás el objeto Map Config recién creado: 

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

Ejemplo: Borra un MapConfig

En el siguiente ejemplo, se muestra cómo borrar un objeto MapConfig con curl. Cuando envías esta solicitud, recibes un objeto JSON vacío {} como respuesta si se encontró y borró correctamente el MapConfig.

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 solicitud se realiza correctamente, recibirás un objeto de respuesta vacío: 

{}

Obtén el número de proyecto

Para obtener el número o el ID de tu proyecto de Google Cloud, sigue estos pasos:

  1. Ve a la página de descripción general del proyecto en la consola de Cloud.
  2. El número de proyecto y el ID del proyecto aparecen en el área Información del proyecto.

Obtén un token de OAuth

Para el desarrollo o las pruebas, puedes usar la CLI de gcloud para generar un token de OAuth temporal:

gcloud auth application-default print-access-token

Puedes incluir el comando gcloud directamente en el encabezado Authorization de una solicitud de curl, como se muestra en los ejemplos anteriores. Como alternativa, puedes establecer una variable de entorno:

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