REST Resource: projects.datasets

Ressource: Dataset

Darstellung eines Maps Platform-Datasets.

JSON-Darstellung 
{
  "name": string,
  "displayName": string,
  "description": string,
  "versionId": string,
  "usage": [
    enum (Usage)
  ],
  "status": {
    object (Status)
  },
  "createTime": string,
  "updateTime": string,
  "versionCreateTime": string,
  "versionDescription": string,

  // Union field data_source can be only one of the following:
  "localFileSource": {
    object (LocalFileSource)
  },
  "gcsSource": {
    object (GcsSource)
  }
  // End of list of possible types for union field data_source.
}
Felder
name

string

Ressourcenname, projects/{project}/datasets/{dataset_id}
displayName

string

Ein menschenlesbarer Name, der in der Konsole angezeigt wird.
description

string

Eine Beschreibung dieses Datasets .
versionId

string

Die Versions-ID des Datensatzes.
usage[]

enum (Usage)

Angegebene Anwendungsfälle für diesen Datensatz.
status

object (Status)

Nur Ausgabe. Der Status dieser Datensatzversion.
createTime

string (Timestamp format)

Nur Ausgabe. Die Zeit, zu der das Dataset zum ersten Mal erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem die Metadaten des Datensatzes zuletzt aktualisiert wurden.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
versionCreateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem diese Version des Datasets erstellt wurde. (Fehler beim Importieren von Daten in das Dataset)

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
versionDescription

string

Nur Ausgabe. Die Beschreibung dieser Version des Datasets. Sie wird beim Importieren von Daten in das Dataset angegeben.
Union-Feld data_source. Details zur Quelle der Daten für den Datensatz. Für data_source ist nur einer der folgenden Werte zulässig:
localFileSource

object (LocalFileSource)

Eine lokale Dateiquelle für das Dataset für einen einzelnen Upload.
gcsSource

object (GcsSource)

Eine Google Cloud Storage-Dateiquelle für den Datensatz für einen einzelnen Upload.

Nutzung

Unter „Verwendung“ wird angegeben, wo die Daten verwendet werden sollen, um die Verarbeitung zu steuern.

Enums
USAGE_UNSPECIFIED Die Nutzung dieses Datasets ist nicht festgelegt.
USAGE_DATA_DRIVEN_STYLING Dieses Dataset wird für datengestützte Stile verwendet.

LocalFileSource

Die Details zur Datenquelle, wenn es sich um eine lokale Datei handelt.

JSON-Darstellung 
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Felder
filename

string

Der Dateiname und die Dateiendung der hochgeladenen Datei.
fileFormat

enum (FileFormat)

Das Format der hochgeladenen Datei.

FileFormat

Das Format der Datei, die hochgeladen wird.

Enums
FILE_FORMAT_UNSPECIFIED Nicht angegebenes Dateiformat.
FILE_FORMAT_GEOJSON GeoJson-Datei.
FILE_FORMAT_KML KML-Datei.
FILE_FORMAT_CSV CSV-Datei herunterladen" klickst.

GcsSource

Die Details zur Datenquelle, wenn sie sich in Google Cloud Storage befindet.

JSON-Darstellung 
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Felder
inputUri

string

Quelldaten-URI. Beispiel: gs://my_bucket/my_object.
fileFormat

enum (FileFormat)

Das Dateiformat des Google Cloud Storage-Objekts. Sie wird hauptsächlich zur Validierung verwendet.

Status

Status der Datensatzversion.

JSON-Darstellung 
{
  "state": enum (State),
  "errorMessage": string
}
Felder
state

enum (State)

Status-Enum für Status.
errorMessage

string

Fehlermeldung, die den Grund für den Fehler angibt. Es ist leer, wenn die Datasets nicht den Status „Fehlgeschlagen“ haben.

Status

Eine Liste der Status für die Datensatzversion. Wenn hier Werte geändert werden, sollten Sie die Status-Dienstmethoden aktualisieren.

Enums
STATE_UNSPECIFIED Der Status dieses Datensatzes ist nicht festgelegt.
STATE_IMPORTING Die Dataset-Version wird importiert.
STATE_IMPORT_SUCCEEDED Die Dataset-Version wurde importiert.
STATE_IMPORT_FAILED Die Dataset-Version konnte nicht importiert werden.
STATE_DELETING Das Dataset wird gerade gelöscht.
STATE_DELETION_FAILED Der Status „Löschen“ ist fehlgeschlagen. Dieser Status bedeutet, dass das Löschen des Datasets fehlgeschlagen ist. Der Löschvorgang kann noch einmal versucht werden.
STATE_PROCESSING Der Verarbeitungsstatus. Dieser Status steht für die anfängliche Zuordnung und Verarbeitung von Datasets zu abgeleiteten Datasets.
STATE_PROCESSING_FAILED Der Status „Verarbeitung fehlgeschlagen“. Dieser Status bedeutet, dass die Verarbeitung fehlgeschlagen ist und möglicherweise Fehler gemeldet werden.
STATE_NEEDS_REVIEW Der Status „Überprüfung erforderlich“. Dieser Status zeigt an, dass Daten entsprechend der jeweiligen Nutzung veröffentlicht und bereitgestellt werden können.
STATE_PUBLISHING Der Veröffentlichungsstatus. Dieser Status gibt an, dass die Veröffentlichung gerade erfolgt.
STATE_PUBLISHING_FAILED Der Status der Veröffentlichung fehlgeschlagen. Dieser Status bedeutet, dass die Veröffentlichung fehlgeschlagen ist. Sie können die Veröffentlichung noch einmal versuchen.
STATE_COMPLETED Der abgeschlossene Status. Dieser Status gibt an, dass der Datensatz für die jeweilige Verwendung verfügbar ist.

Methoden

create

 Erstellt ein neues Dataset für das angegebene Projekt.

delete

 Löschen Sie das angegebene Dataset.

get

 Rufen Sie das Dataset ab.

list

 Listet alle Datasets für das angegebene Projekt auf.

patch

 Aktualisieren Sie die Metadaten für das Dataset.