En este momento, la API de Maps Datasets está en vista previa (versión previa a la DG). Los productos y las funciones que se encuentran en la fase previa la DG pueden tener asistencia limitada, y los cambios en estos productos y funciones podrían no ser compatibles con otras versiones de la fase previa a la DG. Las ofertas que se encuentran en la fase previa a la DG están cubiertas por los Términos específicos del servicio de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Se usó la API de Cloud Translation para traducir esta página.

Parámetros de solicitud obligatorios

Para realizar una solicitud a la API de Maps Datasets, debes incluir lo siguiente:

Es el número o ID de tu proyecto de Google Cloud en el encabezado X-Goog-User-Project de la solicitud. Este valor determina el proyecto que se usará para la facturación y los cálculos de la cuota de uso.

Nota: Si usas una cuenta de servicio para la autenticación, puedes omitir el encabezado X-Goog-User-Project. Para obtener más información sobre las cuentas de servicio, consulta Autenticación en Google.
Un token de OAuth en el encabezado Authorization de la solicitud. Para obtener más información sobre el uso de OAuth con la API de Maps Datasets, consulta Cómo usar OAuth.
Un número o ID del proyecto de Google Cloud en la URL de la solicitud. Este valor especifica el proyecto que contiene el conjunto de datos. Si bien este proyecto suele ser el mismo que el proyecto especificado en el encabezado X-Goog-User-Project, no es necesario que sea igual.
El ID del conjunto de datos en la URL de la solicitud. Cada vez que realizas una acción en un conjunto de datos específico, pasas el ID del conjunto de datos como parte de la URL de la solicitud.

Por ejemplo, para borrar un conjunto de datos:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Obtén el número de proyecto

Para obtener el PROJECT_NUMBER_OR_ID de tu proyecto de Google Cloud, haz lo siguiente:

Ve a la página Descripción general del proyecto en la consola de Cloud.
Si se solicita, selecciona tu proyecto.
El número y el ID del proyecto aparecen en el área Información del proyecto de la pantalla de descripción general.

Obtén un token de OAuth

Para la autenticación, tu solicitud a la API debe contener un token de OAuth en el encabezado Authorization. Para obtener más información, consulta Usa OAuth.

Por ejemplo, usa el siguiente comando gcloud para generar el token:

gcloud auth application-default print-access-token

Puedes incluir el comando gcloud directamente en el encabezado Authorization de un comando cURL para generar un token nuevo en cada solicitud, como se muestra en el ejemplo anterior.

De forma alternativa, puedes establecer una variable de entorno que contenga el token y, luego, pasar la variable de entorno como parte de la solicitud:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID