Recupero di un set di dati

Dopo aver creato un set di dati e caricato i dati al suo interno, puoi utilizzare le richieste HTTP `GET` per accedere al set di dati. Questa pagina descrive come elencare tutti i set di dati, come ottenere informazioni su un set di dati specifico e come scaricare i dati da un set di dati.

Informazioni sulle versioni dei set di dati

Dopo il caricamento dei dati, lo stato del set di dati viene impostato su STATE_COMPLETED e il set di dati diventa la versione attiva. Ciò significa che il set di dati è pronto per essere utilizzato nella tua app. Per determinare lo state del set di dati, puoi elencare tutti i set di dati o ottenere un set di dati specifico.

Puoi caricare nuovi dati nel set di dati per creare una nuova versione del set di dati:

  • Se il caricamento dei nuovi dati va a buon fine, la nuova versione diventa la versione "attiva" ed è la versione utilizzata dalla tua app.

  • Se si verifica un errore durante il caricamento, la versione precedente del set di dati rimane la versione "attiva" ed è la versione utilizzata dalla tua app.

Per ulteriori informazioni sulla creazione di una nuova versione di un set di dati, consulta Caricare nuovi dati nel set di dati.

Elencare tutti i set di dati

Elenca tutti i set di dati inviando una richiesta HTTP GET all' endpoint list datasets:

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

Questa richiesta restituisce informazioni sull'ultima versione di tutti i set di dati, indipendentemente dal fatto che la versione sia la versione attiva. Se vuoi elencare solo la versione attiva di ogni set di dati, aggiungi il parametro di query tag=active alla richiesta:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets?tag=active

Ad esempio, questa chiamata restituisce informazioni sull'ultima versione di tutti i set di dati:

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"

Questa chiamata restituisce una risposta nel 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"
      }
    }
  ]
}

Ottenere informazioni su un set di dati

Per ottenere informazioni su un set di dati specifico, invia una richiesta HTTP GET all'endpoint get dataset che include anche l'ID del set di dati:

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

Questa richiesta restituisce informazioni sull'ultima versione del set di dati, indipendentemente dal fatto che la versione sia la versione attiva. Se vuoi informazioni sulla versione attiva del set di dati, aggiungi il tag @active alla richiesta:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@active

Ad esempio:

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"

Questa richiesta restituisce una risposta nel 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"
  }
}

Scaricare un set di dati

Per scaricare i dati dall'ultima versione di un set di dati, invia una richiesta HTTP GET richiesta all' endpoint download dataset che include anche l'ID del set di dati:

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

Ad esempio:

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"

In questo esempio, utilizzi l'opzione cURL --output per specificare il nome del file che contiene i dati scaricati. Ad esempio, il seguente flag --output specifica di scaricare il set di dati in un file denominato myjson.json nella stessa directory utilizzata per eseguire il comando cURL:

--output myjson.json

In alternativa, utilizza il seguente flag per scaricare i dati in myjson.json nella directory /tmp:

--output /tmp/myjson.json