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 folgenden Wert gesetzt: STATE_COMPLETED und dieses Dataset 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 Hochladen ein Fehler auftritt, wird die vorherige erfolgreiche Dataset-Version bleibt als „aktiv“ Version und ist die von Ihrer App verwendete Version.

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 über die neueste Version aller Datasets 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

Dieser Aufruf gibt beispielsweise Informationen über die neueste Version aller Datasets:

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

Um Informationen zu einem bestimmten Dataset zu erhalten, senden Sie eine HTTP-GET-Anfrage an den Dataset--Endpunkt abrufen, der auch enthält die 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 es sich um die aktive Version handelt. Wenn Sie Informationen benötigen, zur aktiven Version des Datasets, hängen Sie das Tag @active an die Anfrage:

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

Senden Sie eine HTTP-GET-Anfrage, um die Daten aus der neuesten Version eines Datasets herunterzuladen. an den Dataset herunterladen Endpunkt, 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 geben Sie mit der Option cURL --output den Namen der die die heruntergeladenen Daten enthält. Das folgende --output-Flag gibt an, das Dataset in eine Datei namens myjson.json im selben Ordner Verzeichnis, in dem der Befehl cURL ausgeführt wird:

--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