Dopo aver creato un set di dati e avervi caricato i dati, puoi utilizzare le richieste HTTP GET per accedere al set di dati. In questa pagina viene descritto 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 del set di dati
Dopo un caricamento dei dati riuscito, lo stato del set di dati viene impostato su
STATE_COMPLETED
e il set di dati diventa la versione attiva. Ciò significa
pronto per essere utilizzato nella tua app. Per determinare il valore state
del set di dati,
puoi elencare tutti i set di dati o recuperarne uno specifico.
Puoi caricare nuovi dati nel set di dati per creare una nuova versione del set di dati:
Se i nuovi dati vengono caricati correttamente, la nuova versione diventa "attiva" ed è la versione utilizzata dalla tua app.
Se si verifica un errore durante il caricamento, viene utilizzata la precedente versione del set di dati riuscita rimane "attivo" ed è la versione utilizzata dalla tua app.
Per saperne di più sulla creazione di una nuova versione di un set di dati, consulta Carica nuovi dati nel set di dati.
Elenco di tutti i set di dati
Elenca tutti i set di dati inviando una richiesta GET
HTTP all'
endpoint list dataset (elenca set di dati):
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets
Questa richiesta restituisce informazioni sull'ultima versione di tutti i set di dati,
a prescindere dal fatto che la versione sia attiva o meno. Se vuoi solo
elenca 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 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 GET
HTTP al
l'endpoint get dataset e che anche
include 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,
a prescindere dal fatto che la versione sia attiva o meno. 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 modulo:
{ "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" } }
Scarica un set di dati
Per scaricare i dati dalla versione più recente di un set di dati, invia un GET
HTTP
richiesta alla
scarica set di dati
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, viene utilizzata l'opzione cURL --output
per specificare il nome
contenente i dati scaricati. Ad esempio, il seguente flag --output
specifica di scaricare il set di dati in un file denominato myjson.json nello stesso
directory utilizzata per eseguire il comando cURL
:
--output myjson.json
In alternativa utilizza il seguente flag per scaricare i dati in myjson.json nell'elemento /tmp
directory:
--output /tmp/myjson.json