Después de crear un conjunto de datos y subir datos, puedes usar solicitudes HTTP GET 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.
Acerca de las versiones de conjuntos de datos
Después de subir datos correctamente, el estado del conjunto de datos se establece en STATE_COMPLETED
y ese conjunto de datos pasa a ser la versión activa. Esto significa que el conjunto de datos está listo para usarse en tu app. Si quieres determinar el state
del conjunto de datos, puedes enumerar todos los conjuntos de datos o bien obtener uno específico.
Puedes subir datos nuevos al conjunto de datos para crear una versión nueva del conjunto de datos:
Si los datos nuevos se suben correctamente, la versión nueva se convierte en la versión "activa" y es la que usa tu app.
Si hay un error en la carga, la versión anterior exitosa del conjunto de datos permanece como la versión "activa" y es la que usa tu app.
Para obtener más información sobre cómo crear una versión nueva de un conjunto de datos, consulta Sube datos nuevos al conjunto de datos.
Enumera todos los conjuntos de datos
Para enumerar todos los conjuntos de datos, envía una solicitud HTTP GET
al extremo mostrar lista de conjuntos de datos:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets
Esta solicitud muestra información sobre la última versión de todos los conjuntos de datos, sin importar si la versión es la versión activa. Si solo deseas enumerar la versión activa de cada conjunto de datos, agrega el parámetro de consulta tag=active
a la solicitud:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets?tag=active
Por ejemplo, esta llamada muestra información sobre la versión más reciente de todos los conjuntos de datos:
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 get dataset que también incluye el ID del conjunto de datos:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Esta solicitud muestra información sobre la versión más reciente del conjunto de datos, sin importar si la versión es la versión activa. Si deseas obtener información sobre la versión activa del conjunto de datos, agrega la etiqueta @active
a la solicitud:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@active
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@active
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" } }
Descargar un conjunto de datos
Para descargar los datos de la versión más reciente de un conjunto de datos, envía una solicitud HTTP GET
al extremo Descargar 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 el conjunto de datos se descarga 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 a myjson.json en el directorio /tmp
:
--output /tmp/myjson.json