Dataset abrufen

Nachdem Sie ein Dataset erstellt und Daten hochgeladen haben, können Sie mit HTTP-GET-Anfragen auf das Dataset zugreifen. Auf dieser Seite wird beschrieben, wie Sie alle Datasets auflisten, Informationen zu einem bestimmten Dataset abrufen und die Daten aus einem Dataset herunterladen können.

Dataset-Versionen

Nach einem erfolgreichen Datenupload wird der Status des Datasets auf STATE_COMPLETED gesetzt und das Dataset wird zur aktiven Version. Das bedeutet, dass das Dataset sofort in Ihrer Anwendung verwendet werden kann. Um den state des Datasets zu ermitteln, können Sie entweder alle Datasets auflisten oder ein bestimmtes Dataset abrufen.

Sie können neue Daten in das Dataset hochladen, um eine neue Version des Datasets zu erstellen:

  • Wenn die neuen Daten erfolgreich hochgeladen wurden, wird die neue Version zur „aktiven“ Version und ist die Version, die von Ihrer Anwendung verwendet wird.

  • Wenn beim Upload ein Fehler auftritt, bleibt die vorherige erfolgreiche Dataset-Version die "aktive" Version und die von Ihrer Anwendung verwendete Version.

Weitere Informationen zum Erstellen einer neuen Version eines Datasets finden Sie unter Neue Daten in das Dataset hochladen.

Alle Datasets auflisten

Sie können alle Datasets auflisten, indem Sie eine HTTP-GET-Anfrage an den Endpunkt list datasets senden:

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

Diese Anfrage gibt Informationen zur neuesten Version aller Datasets zurück, unabhängig davon, ob die Version die aktive Version ist. Wenn Sie nur die aktive Version jedes Datasets 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

Dieser Aufruf gibt beispielsweise Informationen zur neuesten Version aller Datasets zurück:

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 (Dataset abrufen) mit der ID des Datasets:

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

Diese Anfrage gibt Informationen zur neuesten Version des Datasets zurück, unabhängig davon, ob die Version die aktive Version ist. Wenn Sie Informationen zur aktiven Version des Datasets benötigen, hängen Sie das Tag @active an die Anfrage an:

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 im folgenden 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 der neuesten Version eines Datasets herunterladen möchten, senden Sie eine HTTP-GET-Anfrage an den Endpunkt des Datasets herunterladen, die 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 Flag --output gibt beispielsweise an, dass das Dataset in eine Datei namens myjson.json heruntergeladen wird, die sich im selben Verzeichnis befindet, in dem der Befehl cURL ausgeführt wird:

--output myjson.json

Oder verwenden Sie das folgende Flag, um die Daten nach myjson.json im Verzeichnis /tmp herunterzuladen:

--output /tmp/myjson.json