Después de crear un conjunto de datos y subirlo, puedes usar solicitudes GET HTTP para acceder al conjunto de datos. En esta página, se describe cómo enumerar todos tus conjuntos de datos, cómo obtener información sobre un conjunto de datos específico y cómo descargar los datos de un conjunto de datos.
Enumera todos los conjuntos de datos
Para enumerar todos los conjuntos de datos, envía una solicitud GET HTTP al extremo list dataset (lista de conjuntos de datos):
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets
Por ejemplo:
curl -X GET \ -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \ -H 'Authorization: Bearer $TOKEN' \ https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets
Esta llamada muestra una respuesta con el siguiente formato:
{
"datasets": [
{
"name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46",
"displayName": "My Test Dataset",
"versionId": "5fb34e-1405-4ecd-8f81-31f1c07",
"usage": [
"USAGE_DATA_DRIVEN_STYLING"
],
"gcsSource": {
"inputUri": "gs://mybucket/my.csv",
"fileFormat": "FILE_FORMAT_CSV"
},
"createTime": "2023-03-24T14:47:37.308977Z",
"updateTime": "2023-03-24T14:48:05.053114Z",
"versionCreateTime": "2023-03-24T14:48:05.053114Z",
"status": {
"state": "STATE_COMPLETED"
}
},
{
"name": "projects/PROJECT_NUMBER_OR_ID/datasets/2c8ae479-96704-89c6435ca959",
"displayName": "My Other Test Dataset",
"versionId": "0d2e3-b9da-47cc-819f-7ac67562",
"usage": [
"USAGE_DATA_DRIVEN_STYLING"
],
"localFileSource": {
"fileFormat": "FILE_FORMAT_CSV"
},
"createTime": "2023-03-24T14:41:52.579755Z",
"updateTime": "2023-03-24T14:42:56.784122Z",
"versionCreateTime": "2023-03-24T14:42:56.784122Z",
"status": {
"state": "STATE_COMPLETED"
}
}
]
}
Obtén información sobre un conjunto de datos
Para obtener información sobre un conjunto de datos específico, envía una solicitud HTTP GET al extremo obtener conjunto de datos que también incluya el ID del conjunto de datos:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Por ejemplo:
curl -X GET \ -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \ -H 'Authorization: Bearer $TOKEN' \ https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46
Esta solicitud muestra una respuesta con el siguiente formato:
{
"name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46",
"displayName": "My Test Dataset",
"versionId": "5fb34e-1405-4ecd-8f81-31f1c07",
"usage": [
"USAGE_DATA_DRIVEN_STYLING"
],
"gcsSource": {
"inputUri": "gs://mybucket/my.csv",
"fileFormat": "FILE_FORMAT_CSV"
},
"createTime": "2023-03-24T14:47:37.308977Z",
"updateTime": "2023-03-24T14:48:05.053114Z",
"versionCreateTime": "2023-03-24T14:48:05.053114Z",
"status": {
"state": "STATE_COMPLETED"
}
}
Descarga un conjunto de datos
Para descargar los datos de un conjunto de datos, envía una solicitud HTTP GET al extremo de descarga del conjunto de datos que también incluya el ID del conjunto de datos:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:download?alt=media
Por ejemplo:
curl -X GET -L \ -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \ -H 'Authorization: Bearer $TOKEN' \ --output LOCAL_LOCATION_TO_OUTPUT \ https://mapsplatformdatasets.googleapis.com/download/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46:download?alt=media
En este ejemplo, se usa la opción cURL --output para especificar el nombre del archivo que contiene los datos descargados. Por ejemplo, la siguiente marca --output especifica que se debe descargar el conjunto de datos en un archivo llamado myjson.json en el mismo directorio que se usa para ejecutar el comando cURL:
--output myjson.json
También puedes usar la siguiente marca para descargar los datos en myjson.json en el directorio /tmp:
--output /tmp/myjson.json