Nachdem Sie ein Dataset erstellt und Daten in das Dataset hochgeladen haben, können Sie mit HTTP-GET-Anfragen auf das Dataset zugreifen. Auf dieser Seite wird beschrieben, wie Sie alle Ihre Datasets auflisten, Informationen zu einem bestimmten Dataset erhalten und die Daten aus einem Dataset herunterladen können.
Alle Datasets auflisten
Um alle Datasets aufzulisten, senden Sie eine HTTP-GET
-Anfrage an den Endpunkt Datasets auflisten:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets
Beispiel:
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
Dieser Aufruf gibt eine Antwort in folgendem Format zurück:
{ "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" } } ] }
Informationen zu einem Dataset abrufen
Wenn Sie Informationen zu einem bestimmten Dataset abrufen möchten, senden Sie eine HTTP-GET
-Anfrage an den Endpunkt get dataset, die auch die ID des Datasets enthält:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Beispiel:
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
Diese Anfrage gibt eine Antwort in folgendem Format zurück:
{ "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" } }
Dataset herunterladen
Wenn Sie die Daten aus einem Dataset herunterladen möchten, senden Sie eine HTTP-GET
-Anfrage an den Endpunkt Dataset herunterladen, der auch die ID des Datasets enthält:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:download?alt=media
Beispiel:
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 diesem Beispiel verwenden Sie die Option cURL --output
, um den Namen der Datei anzugeben, die die heruntergeladenen Daten enthält. Das folgende --output
-Flag gibt beispielsweise an, dass das Dataset in eine Datei namens myjson.json heruntergeladen wird, die sich in demselben Verzeichnis befindet, in dem der Befehl cURL
ausgeführt wird:
--output myjson.json
Alternativ können Sie das folgende Flag verwenden, um die Daten in myjson.json im Verzeichnis /tmp
herunterzuladen:
--output /tmp/myjson.json