Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Obtén un conjunto de datos

Después de crear un conjunto de datos y subir datos a é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 que se suben los datos correctamente, 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 el 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 o obtener un conjunto de datos 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 versión que usa tu app.
Si hay un error en la carga, la versión anterior del conjunto de datos que se subió correctamente permanece como la versión "activa" y es la versión 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 de la lista de conjuntos de datos:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets

Esta solicitud devuelve información sobre la versión más reciente de todos los conjuntos de datos, independientemente de 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 devuelve 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 devuelve 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 de obtención de conjuntos 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

Esta solicitud devuelve información sobre la versión más reciente del conjunto de datos, independientemente de 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 devuelve 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 la versión más reciente de un conjunto de datos, envía una solicitud HTTP GET request to the download dataset endpoint that also incluye el ID del conjunto de datos:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:download?alt=media