Dataset abrufen

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

Dataset-Versionen

Nach einem erfolgreichen Daten-Upload wird der Status des Datasets auf STATE_COMPLETED gesetzt und das Dataset wird zur aktiven Version. Das Dataset kann also in Ihrer App verwendet werden. 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 werden, wird die neue Version zur „aktiven“ Version und von Ihrer App verwendet.

  • Wenn beim Upload ein Fehler auftritt, bleibt die vorherige erfolgreiche Dataset-Version die „aktive“ Version 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

Alle Datasets auflisten: Senden Sie eine HTTP-GET-Anfrage an den Endpunkt list datasets:

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 es sich um die aktive Version handelt. Wenn Sie nur die aktive Version der einzelnen 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

Mit diesem Aufruf werden beispielsweise Informationen zur neuesten Version aller Datasets 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 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 Dataset abrufen, die auch die ID des Datasets enthält:

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 es sich um die aktive Version handelt. Wenn Sie Informationen zur aktiven Version des Datasets erhalten möchten, 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 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 der neuesten Version eines Datasets herunterladen möchten, senden Sie eine HTTP-GET-Anfrage an den Endpunkt Dataset 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, in der die heruntergeladenen Daten gespeichert werden. Mit dem folgenden --output-Flag wird beispielsweise angegeben, dass das Dataset in eine Datei mit dem Namen myjson.json in demselben Verzeichnis heruntergeladen werden soll, in dem der cURL-Befehl ausgeführt wird:

--output myjson.json

Alternativ können Sie das folgende Flag verwenden, um die Daten in das Verzeichnis /tmp in die Datei myjson.json herunterzuladen:

--output /tmp/myjson.json