Nachdem Sie ein Dataset erstellt und Daten darauf hochgeladen haben, können Sie mithilfe von HTTP-GET-Anfragen auf das Dataset zugreifen. Auf dieser Seite wird beschrieben, wie Sie eine Liste aller Ihrer Datasets aufrufen, Informationen zu einem bestimmten Dataset abrufen und die Daten aus einem Dataset herunterladen.
Dataset-Versionen
Nach einem erfolgreichen Datenupload wird der Status des Datensatzes auf STATE_COMPLETED gesetzt und dieser Datensatz wird zur aktiven Version. Das bedeutet, dass der Datensatz in Ihrer App verwendet werden kann. Um die state des Datensatzes zu ermitteln, können Sie entweder alle Datensätze auflisten oder einen bestimmten Datensatz abrufen.
Sie können neue Daten in das Dataset hochladen, um eine neue Version davon zu erstellen:
Wenn der Upload der neuen Daten erfolgreich war, wird die neue Version zur „aktiven“ Version und ist die Version, die von Ihrer App verwendet wird.
Wenn beim Upload ein Fehler auftritt, bleibt die vorherige erfolgreiche Datensatzversion als „aktive“ Version erhalten und wird von Ihrer App verwendet.
Weitere Informationen zum Erstellen einer neuen Version eines Datasets finden Sie unter Neue Daten in das Dataset hochladen.
Alle Datasets auflisten
Senden Sie eine HTTP-GET-Anfrage an den Endpunkt list datasets, um eine Liste aller Datensätze aufzurufen:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets
Diese Anfrage gibt Informationen zur neuesten Version aller Datensätze zurück, unabhängig davon, ob es sich um die aktive Version handelt. Wenn Sie nur die aktive Version jedes Datensatzes auflisten möchten, hängen Sie den Abfrageparameter tag=active an die Anfrage an:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets?tag=active
Mit diesem Aufruf werden beispielsweise Informationen zur neuesten Version aller Datensätze zurückgegeben:
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 der folgenden Form 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 Datensatz abrufen möchten, senden Sie eine HTTP-GET-Anfrage an den Endpunkt get dataset (Datensatz abrufen), die auch die ID des Datensatzes enthält:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID
Diese Anfrage gibt Informationen zur neuesten Version des Datensatzes zurück, unabhängig davon, ob es sich um die aktive Version handelt. Wenn Sie Informationen zur aktiven Version des Datensatzes benötigen, fügen Sie der Anfrage das Tag @active hinzu:
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@active
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@active"
Diese Anfrage gibt eine Antwort in der folgenden Form 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 der neuesten Version eines Datensatzes herunterladen möchten, senden Sie eine HTTP-GET-Anfrage an den Endpunkt download dataset, die auch die ID des Datensatzes 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 geben Sie mit der Option cURL --output den Namen der Datei an, die die heruntergeladenen Daten enthält. Mit dem folgenden --output-Flag wird beispielsweise angegeben, dass der Datensatz in eine Datei namens myjson.json im selben Verzeichnis heruntergeladen werden soll, in dem der Befehl cURL ausgeführt wurde:
--output myjson.json
Alternativ können Sie die Daten mit dem folgenden Flag in das Verzeichnis /tmp unter myjson.json herunterladen:
--output /tmp/myjson.json