Package google.maps.mapsplatformdatasets.v1

Indice

MapsPlatformDatasets

Definizione del servizio per l'API Maps Platform Datasets.

CreateDataset

rpc CreateDataset(CreateDatasetRequest) returns (Dataset)

Crea un nuovo set di dati per il progetto specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • mapsplatformdatasets.datasets.create

Per saperne di più, consulta la documentazione IAM.
DeleteDataset

rpc DeleteDataset(DeleteDatasetRequest) returns (Empty)

Elimina il set di dati specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Richiede la seguente autorizzazione IAM per la risorsa name:

  • mapsplatformdatasets.datasets.delete

Per saperne di più, consulta la documentazione IAM.
DownloadDataset

rpc DownloadDataset(DownloadDatasetRequest) returns (DownloadDatasetResponse)

Scarica un set di dati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Richiede la seguente autorizzazione IAM per la risorsa name:

  • mapsplatformdatasets.datasets.export

Per saperne di più, consulta la documentazione IAM.
FetchDatasetErrors

rpc FetchDatasetErrors(FetchDatasetErrorsRequest) returns (FetchDatasetErrorsResponse)

Recupera tutti gli errori di un set di dati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Richiede la seguente autorizzazione IAM per la risorsa dataset:

  • mapsplatformdatasets.datasets.get

Per saperne di più, consulta la documentazione IAM.
GetDataset

rpc GetDataset(GetDatasetRequest) returns (Dataset)

Recupera il set di dati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Richiede la seguente autorizzazione IAM per la risorsa name:

  • mapsplatformdatasets.datasets.get

Per saperne di più, consulta la documentazione IAM.
ImportDataset

rpc ImportDataset(ImportDatasetRequest) returns (ImportDatasetResponse)

Importa una nuova versione dei dati per il set di dati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Richiede la seguente autorizzazione IAM per la risorsa name:

  • mapsplatformdatasets.datasets.import

Per saperne di più, consulta la documentazione IAM.
ListDatasets

rpc ListDatasets(ListDatasetsRequest) returns (ListDatasetsResponse)

Elenca tutti i set di dati per il progetto specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • mapsplatformdatasets.datasets.list

Per saperne di più, consulta la documentazione IAM.
UpdateDatasetMetadata

rpc UpdateDatasetMetadata(UpdateDatasetMetadataRequest) returns (Dataset)

Aggiorna i metadati per il set di dati.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Richiede la seguente autorizzazione IAM per la risorsa name:

  • mapsplatformdatasets.datasets.update

Per saperne di più, consulta la documentazione IAM.

CreateDatasetRequest

Richiesta di creazione di un set di dati per le mappe.

Campi
parent

string

Obbligatorio. Progetto padre proprietario del set di dati. Formato: projects/{project}
dataset

Dataset

Obbligatorio. La versione del set di dati da creare.

Set di dati

Una rappresentazione di una risorsa del set di dati.

Campi
name

string

Nome della risorsa. Formato: projects/{project}/datasets/{dataset_id}
display_name

string

Nome leggibile, mostrato nell'interfaccia utente della console.

Deve essere univoco all'interno di un progetto.
description

string

Una descrizione di questo set di dati.
version_id

string

L'ID versione del set di dati.
usage[]

Usage

Caso d'uso specificato per questo set di dati.
status

Status

Solo output. Lo stato della versione di questo set di dati.
create_time

Timestamp

Solo output. Data e ora di creazione del set di dati.
update_time

Timestamp

Solo output. Ora dell'ultimo aggiornamento dei metadati del set di dati.
version_create_time

Timestamp

Solo output. Data e ora di creazione della versione.
version_description

string

Solo output. La descrizione di questa versione del set di dati. Viene fornito durante l'importazione dei dati nel set di dati.
Campo unione data_source. Dettagli sull'origine dei dati per il set di dati. data_source può essere solo uno dei seguenti:
local_file_source

LocalFileSource

Un'origine file locale per il set di dati per un singolo caricamento.
gcs_source

GcsSource

Un'origine file di Google Cloud Storage per il set di dati per un singolo caricamento.

DeleteDatasetRequest

Richiesta di eliminazione di un set di dati.

Campi
name

string

Obbligatorio. Il nome del set di dati da eliminare. Formato: projects/{project}/datasets/{dataset_id}

DownloadDatasetRequest

Richiedi il download del set di dati.

Campi
name

string

Nome della risorsa del set di dati da recuperare. Formato: projects/{project}/datasets/{dataset_id}

DownloadDatasetResponse

Oggetto risposta di DownloadDataset.

FetchDatasetErrorsRequest

Richiesta di elencare gli errori dettagliati appartenenti a un set di dati.

Campi
dataset

string

Obbligatorio. Il nome del set di dati per il quale elencare tutti gli errori. Formato: projects/{project}/datasets/{dataset_id}
page_size

int32

Il numero massimo di errori da restituire per pagina.

Il valore massimo è 500. i valori superiori a 500 saranno limitati a 500.

Se non vengono specificati, verranno restituiti al massimo 50 errori.
page_token

string

Il token di pagina, ricevuto da una precedente chiamata ListDatasetErrors. Forniscilo per recuperare la pagina successiva.

FetchDatasetErrorsResponse

Oggetto risposta di FetchDatasetErrors.

Campi
next_page_token

string

Un token che può essere inviato come page_token per recuperare la pagina successiva.

Se questo campo viene omesso, non verranno visualizzate altre pagine.
errors[]

Status

Gli errori associati a un set di dati.

FileFormat

Il formato del file che stai caricando.

Enum
FILE_FORMAT_UNSPECIFIED Formato file non specificato.
FILE_FORMAT_GEOJSON GeoJson.
FILE_FORMAT_KML file KML.
FILE_FORMAT_CSV .CSV.

GcsSource

Dettagli sull'origine dati quando si trova in Google Cloud Storage.

Campi
input_uri

string

URI dei dati di origine. Ad esempio, gs://my_bucket/my_object.
file_format

FileFormat

Il formato file dell'oggetto Google Cloud Storage. Viene utilizzato principalmente per la convalida.

GetDatasetRequest

Richiesta di ottenere il set di dati specificato.

Campi
name

string

Obbligatorio. Nome della risorsa. Formato: projects/{project}/datasets/{dataset_id}

Puoi recuperare alcune versioni speciali anche aggiungendo "@" e un tag. Formato: projects/{project}/datasets/{dataset_id}@{tag}

Tag "active": saranno incluse le informazioni dell'ultima versione completata e NOT_FOUND se il set di dati non ne ha una.

ImportDatasetRequest

Richiedi l'importazione di una nuova versione del set di dati.

Campi
name

string

Obbligatorio. Nome della risorsa. Formato: projects/{project}/datasets/{dataset_id}
version_description

string

Una descrizione dei nuovi dati importati.
Campo unione data_source. Dettagli sull'origine dei dati per il set di dati. data_source può essere solo uno dei seguenti:
local_file_source

LocalFileSource

Un'origine file locale per il set di dati per un'importazione una tantum.
gcs_source

GcsSource

Un'origine file di Google Cloud Storage per il set di dati per un'importazione una tantum.

ImportDatasetResponse

Oggetto risposta di ImportDataset.

Campi
name

string

Obbligatorio. Nome risorsa della versione del set di dati appena creata. Formato: projects/{project}/datasets/{dataset_id}@{version_id}

ListDatasetsRequest

Richiesta di elencare i set di dati per il progetto.

Campi
parent

string

Obbligatorio. Il nome del progetto per il quale elencare tutti i set di dati. Formato: projects/{project}
page_size

int32

Il numero massimo di set di dati da restituire per pagina.

Se non specificati (o zero), verranno restituiti tutti i set di dati.
page_token

string

Il token di pagina, ricevuto da una precedente chiamata ListDatasets. Forniscilo per recuperare la pagina successiva.
tag

string

Il tag che specifica la versione desiderata per ogni set di dati.

Tieni presente che quando viene specificata anche l'impaginazione, alcuni filtri possono essere applicati dopo l'impaginazione, il che potrebbe causare la presenza nella risposta di un numero inferiore di set di dati rispetto alle dimensioni della pagina, anche se non si tratta dell'ultima pagina.

Tag "active": ogni set di dati nella risposta includerà le informazioni dell'ultima versione completata e, se non è disponibile, il set di dati verrà ignorato.

ListDatasetsResponse

Oggetto risposta di ListDatasets.

Campi
datasets[]

Dataset

Tutti i set di dati per il progetto.
next_page_token

string

Un token che può essere inviato come page_token per recuperare la pagina successiva.

Se questo campo viene omesso, non verranno visualizzate altre pagine.

LocalFileSource

Dettagli sull'origine dati, se si tratta di un file locale.

Campi
filename

string

Il nome del file caricato.
file_format

FileFormat

Il formato del file che viene caricato.

Stato

Stato del set di dati.

Campi
state

State

Enum dello stato.
error_message

string

Messaggio di errore che indica il motivo dell'errore. È vuoto se il set di dati non è in uno stato "Non riuscito".

Stato

Un elenco di stati per il set di dati.

Enum
STATE_UNSPECIFIED Lo stato di questo set di dati non è impostato.
STATE_IMPORTING È in corso l'importazione dei dati in un set di dati.
STATE_IMPORT_SUCCEEDED Importazione dei dati in un set di dati riuscita.
STATE_IMPORT_FAILED Importazione dei dati in un set di dati non riuscita.
STATE_DELETING Il set di dati è in fase di eliminazione.
STATE_DELETION_FAILED Stato di eliminazione non riuscita. Questo stato rappresenta che l'eliminazione del set di dati non è riuscita. È possibile ritentare l'eliminazione.
STATE_PROCESSING I dati sono in fase di elaborazione.
STATE_PROCESSING_FAILED Stato di elaborazione non riuscita. Questo stato indica che l'elaborazione non è riuscita e potrebbe segnalare errori.
STATE_NEEDS_REVIEW Questo stato non è attualmente utilizzato.
STATE_PUBLISHING Lo stato di pubblicazione. Questo stato indica che la pubblicazione è in corso.
STATE_PUBLISHING_FAILED Stati di pubblicazione non riuscita. Questo stato indica che la pubblicazione non è riuscita. È possibile ritentare la pubblicazione.
STATE_COMPLETED Lo stato Completato. Questo stato rappresenta il set di dati disponibile per il suo utilizzo specifico.

UpdateDatasetMetadataRequest

Richiedi l'aggiornamento dei campi dei metadati del set di dati.

Campi
dataset

Dataset

Obbligatorio. Nome risorsa del set di dati da aggiornare. Formato: projects/{project}/datasets/{dataset_id}
update_mask

FieldMask

L'elenco dei campi da aggiornare.

Il valore "*" viene utilizzato per la sostituzione completa (impostazione predefinita).

Utilizzo

L'utilizzo specifica la posizione in cui i dati vengono utilizzati per definire le modalità di elaborazione dei dati.

Enum
USAGE_UNSPECIFIED L'utilizzo di questo set di dati non è impostato.
USAGE_DATA_DRIVEN_STYLING Questo set di dati verrà utilizzato per gli stili basati sui dati.