Dataset abrufen

Nachdem Sie ein Dataset erstellt und Daten in dieses Dataset hochgeladen haben, können Sie HTTP-GET-Anfragen verwenden. um auf das Dataset zuzugreifen. Auf dieser Seite wird beschrieben, wie Sie alle Datasets auflisten, Wie Sie Informationen zu einem bestimmten Dataset erhalten und wie Sie die Daten herunterladen können aus einem Dataset.

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 die kann in Ihrer Anwendung 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 dataset:

  • Wenn die neuen Daten erfolgreich hochgeladen wurden, wird die neue Version zum „aktiven“. Version und ist die von Ihrer App verwendete Version.

  • 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 Laden Sie neue Daten in das Dataset hoch.

Alle Datasets auflisten

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

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 Datasets auflisten, den Abfrageparameter tag=active anhängen hinzugefügt:

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 Datasets 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 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 Datensatzes herunterladen möchten, senden Sie eine HTTP-GET-Anfrage an den Endpunkt Dataset herunterladen, 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 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

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

--output /tmp/myjson.json