Package google.maps.mapsplatformdatasets.v1

Index

MapsPlatformDatasets

Dienstdefinition für die Maps Platform Datasets API.

CreateDataset

rpc CreateDataset(CreateDatasetRequest) returns (Dataset)

Erstellt ein neues Dataset für das angegebene Projekt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • mapsplatformdatasets.datasets.create

Weitere Informationen finden Sie in der IAM-Dokumentation.
DeleteDataset

rpc DeleteDataset(DeleteDatasetRequest) returns (Empty)

Löscht das angegebene Dataset.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • mapsplatformdatasets.datasets.delete

Weitere Informationen finden Sie in der IAM-Dokumentation.
DownloadDataset

rpc DownloadDataset(DownloadDatasetRequest) returns (DownloadDatasetResponse)

Lädt ein Dataset herunter.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • mapsplatformdatasets.datasets.export

Weitere Informationen finden Sie in der IAM-Dokumentation.
FetchDatasetErrors

rpc FetchDatasetErrors(FetchDatasetErrorsRequest) returns (FetchDatasetErrorsResponse)

Ruft alle Fehler eines Datasets ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource dataset:

  • mapsplatformdatasets.datasets.get

Weitere Informationen finden Sie in der IAM-Dokumentation.
GetDataset

rpc GetDataset(GetDatasetRequest) returns (Dataset)

Ruft das Dataset ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • mapsplatformdatasets.datasets.get

Weitere Informationen finden Sie in der IAM-Dokumentation.
ImportDataset

rpc ImportDataset(ImportDatasetRequest) returns (ImportDatasetResponse)

Importiert eine neue Version der Daten für das Dataset.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • mapsplatformdatasets.datasets.import

Weitere Informationen finden Sie in der IAM-Dokumentation.
ListDatasets

rpc ListDatasets(ListDatasetsRequest) returns (ListDatasetsResponse)

Listet alle Datasets für das angegebene Projekt auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • mapsplatformdatasets.datasets.list

Weitere Informationen finden Sie in der IAM-Dokumentation.
UpdateDatasetMetadata

rpc UpdateDatasetMetadata(UpdateDatasetMetadataRequest) returns (Dataset)

Aktualisiert die Metadaten für das Dataset.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform
IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • mapsplatformdatasets.datasets.update

Weitere Informationen finden Sie in der IAM-Dokumentation.

CreateDatasetRequest

Anfrage zum Erstellen eines Karten-Datasets.

Felder
parent

string

Erforderlich. Übergeordnetes Projekt, dem das Dataset gehört. Format: projects/{project}
dataset

Dataset

Erforderlich. Die zu erstellende Dataset-Version.

Dataset

Darstellung einer Dataset-Ressource.

Felder
name

string

Ressourcenname. Format: projects/{project}/datasets/{dataset_id}
display_name

string

Für Menschen lesbarer Name, der in der Konsolen-UI angezeigt wird.

Darf innerhalb eines Projekts nur einmal vorkommen.
description

string

Eine Beschreibung dieses Datasets.
version_id

string

Die Versions-ID des Datasets.
usage[]

Usage

Angegebener Anwendungsfall für dieses Dataset.
status

Status

Nur Ausgabe. Der Status dieser Dataset-Version.
create_time

Timestamp

Nur Ausgabe. Zeitpunkt, zu dem das Dataset zum ersten Mal erstellt wurde.
update_time

Timestamp

Nur Ausgabe. Zeitpunkt, zu dem die Dataset-Metadaten zuletzt aktualisiert wurden.
version_create_time

Timestamp

Nur Ausgabe. Zeitpunkt der Erstellung dieser Version.
version_description

string

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

LocalFileSource

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

GcsSource

Eine Google Cloud Storage-Dateiquelle für das Dataset bei einem einzelnen Upload.

DeleteDatasetRequest

Anfrage zum Löschen eines Datasets.

Felder
name

string

Erforderlich. Der Name des zu löschenden Datasets. Format: projects/{project}/datasets/{dataset_id}

DownloadDatasetRequest

Anfrage zum Herunterladen des Datasets.

Felder
name

string

Ressourcenname des abzurufenden Datasets. Format: projects/{project}/datasets/{dataset_id}

DownloadDatasetResponse

Antwortobjekt von DownloadDataset.

FetchDatasetErrorsRequest

Anfrage zum Auflisten detaillierter Fehler, die zu einem Dataset gehören.

Felder
dataset

string

Erforderlich. Der Name des Datasets, für das alle Fehler aufgelistet werden sollen. Format: projects/{project}/datasets/{dataset_id}
page_size

int32

Die maximale Anzahl von Fehlern, die pro Seite zurückgegeben werden sollen.

Der Maximalwert beträgt 500. Werte über 500 auf 500 begrenzt.

Wenn nicht angegeben, werden maximal 50 Fehler zurückgegeben.
page_token

string

Das Seitentoken, das von einem vorherigen ListDatasetErrors-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

FetchDatasetErrorsResponse

Antwortobjekt von FetchDatasetErrors.

Felder
next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen.

Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
errors[]

Status

Die mit einem Dataset verbundenen Fehler.

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.

Felder
input_uri

string

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

FileFormat

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

GetDatasetRequest

Anfrage zum Abrufen des angegebenen Datasets.

Felder
name

string

Erforderlich. Ressourcenname. Format: projects/{project}/datasets/{dataset_id}

Einige spezielle Versionen können auch abgerufen werden, indem „@“ angehängt wird und ein Tag. Format: projects/{project}/datasets/{dataset_id}@{tag}

Tag „active“: Die Informationen der neuesten fertigen Version werden eingeschlossen und NOT_FOUND, wenn im Dataset keine Version vorhanden ist.

ImportDatasetRequest

Anfrage zum Importieren einer neuen Version des Datasets.

Felder
name

string

Erforderlich. Ressourcenname. Format: projects/{project}/datasets/{dataset_id}
version_description

string

Eine Beschreibung der neu importierten Daten.
Union-Feld data_source. Details zur Quelle der Daten für das Dataset. Für data_source ist nur einer der folgenden Werte zulässig:
local_file_source

LocalFileSource

Eine lokale Dateiquelle für das Dataset für den einmaligen Import.
gcs_source

GcsSource

Eine Google Cloud Storage-Dateiquelle für das Dataset für einen einmaligen Import.

ImportDatasetResponse

Antwortobjekt von ImportDataset.

Felder
name

string

Erforderlich. Ressourcenname der neu erstellten Dataset-Version. Format: projects/{project}/datasets/{dataset_id}@{version_id}

ListDatasetsRequest

Anfrage zum Auflisten von Datasets für das Projekt.

Felder
parent

string

Erforderlich. Der Name des Projekts, für das alle Datasets aufgelistet werden sollen. Format: projects/{project}
page_size

int32

Die maximale Anzahl von Datasets, die pro Seite zurückgegeben werden sollen.

Wenn kein Wert (oder null) angegeben ist, werden alle Datasets zurückgegeben.
page_token

string

Das von einem vorherigen ListDatasets-Aufruf erhaltene Seitentoken. Geben Sie diese an, um die nachfolgende Seite abzurufen.
tag

string

Das Tag, das die gewünschte Version für jedes Dataset angibt.

Wenn auch die Paginierung angegeben ist, kann nach der Paginierung einiges nach der Paginierung gefiltert werden. Dies kann dazu führen, dass die Antwort weniger Datasets als die Seitengröße enthält, auch wenn es sich nicht um die letzte Seite handelt.

Tag „aktiv“: Jedes Dataset in der Antwort enthält die Informationen der neuesten fertigen Version. Das Dataset wird übersprungen, wenn es keine Version hat.

ListDatasetsResponse

Antwortobjekt von ListDatasets.

Felder
datasets[]

Dataset

Alle Datasets für das Projekt.
next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen.

Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

LocalFileSource

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

Felder
filename

string

Der Dateiname der hochgeladenen Datei.
file_format

FileFormat

Das Format der Datei, die hochgeladen wird.

Status

Status des Datasets.

Felder
state

State

Status-Enum für Status.
error_message

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 das Dataset.

Enums
STATE_UNSPECIFIED Der Status dieses Datasets ist nicht festgelegt.
STATE_IMPORTING Daten werden in ein Dataset importiert.
STATE_IMPORT_SUCCEEDED Daten wurden in ein Dataset importiert.
STATE_IMPORT_FAILED Daten konnten nicht in ein Dataset 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 Daten werden verarbeitet.
STATE_PROCESSING_FAILED Der Status „Verarbeitung fehlgeschlagen“. Dieser Status bedeutet, dass die Verarbeitung fehlgeschlagen ist und möglicherweise Fehler gemeldet werden.
STATE_NEEDS_REVIEW Dieser Status wird derzeit nicht verwendet.
STATE_PUBLISHING Der Veröffentlichungsstatus. Dieser Status bedeutet, dass die Veröffentlichung läuft.
STATE_PUBLISHING_FAILED Der Status der Veröffentlichung fehlgeschlagen. Dieser Status bedeutet, dass die Veröffentlichung fehlgeschlagen ist. Sie können die Veröffentlichung wiederholen.
STATE_COMPLETED Der Status „Abgeschlossen“. Dieser Status stellt das Dataset dar, das für seine spezifische Nutzung verfügbar ist.

UpdateDatasetMetadataRequest

Anfrage zum Aktualisieren der Metadatenfelder des Datasets.

Felder
dataset

Dataset

Erforderlich. Ressourcenname des Datasets, das aktualisiert werden soll. Format: projects/{project}/datasets/{dataset_id}
update_mask

FieldMask

Die Liste der Felder, die aktualisiert werden sollen.

Der Wert „*“ wird für den vollständigen Ersatz verwendet (Standardeinstellung).

Nutzung

Die Nutzung gibt an, wo die Daten verwendet werden sollen, um zu bestimmen, wie die Daten verarbeitet werden sollen.

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