Obtén un conjunto de datos

Después de crear un conjunto de datos y subir datos en él, 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 una carga exitosa de datos, el estado del conjunto de datos se establece en STATE_COMPLETED y ese conjunto de datos se convierte en la versión activa. Eso significa que conjunto de datos esté listo para usarse en tu app. Para determinar el state del conjunto de datos, puedes enumerar todos los conjuntos de datos u obtener uno específico.

Puedes subir datos nuevos al conjunto de datos para crear una versión nueva del conjunto de datos:

  • Si los nuevos datos se suben correctamente, la nueva versión pasa a ser “activa”. y es la versión que usa tu app.

  • Si hay un error en la carga, significa que la versión anterior exitosa del conjunto de datos permanece como el estado "activo" y es la versión que usa tu app.

Para obtener más información sobre cómo crear una nueva versión de un conjunto de datos, consulta Sube datos nuevos al conjunto de datos.

Enumera todos los conjuntos de datos

Envía una solicitud GET HTTP al Enumera 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. independientemente de si la versión es la activa. Si solo quieres enumerar la versión activa de cada conjunto de datos, agregar 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 devuelve información sobre la última versión de todos 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 GET HTTP al 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 devuelve información sobre la última versión del conjunto de datos. independientemente de si la versión es la activa. Si quieres información acerca de la versión activa del conjunto de datos, agrega la etiqueta @active al 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 un GET HTTP. solicitud a la descargar conjunto de datos que también incluye 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, usarás la opción cURL --output para especificar el nombre del que contiene los datos descargados. Por ejemplo, la siguiente marca --output especifica que se debe descargar el conjunto de datos a un archivo llamado myjson.json en el mismo 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 /tmp. directorio:

--output /tmp/myjson.json