REST Resource: projects.datasets

Risorsa: set di dati

Una rappresentazione di un set di dati di una piattaforma per mappe.

Rappresentazione JSON
{
  "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.
}
Campi
name

string

Nome risorsa, progetti/{progetto}/set di dati/{dataset_id}

displayName

string

Nome leggibile, visualizzato nell'interfaccia utente della console .

description

string

Una descrizione di questo set di dati .

versionId

string

L'ID versione del set di dati.

usage[]

enum (Usage)

Casi d'uso specificati per questo set di dati.

status

object (Status)

Solo output. Lo stato di questa versione del set di dati.

createTime

string (Timestamp format)

Solo output. La data e l'ora della creazione iniziale del set di dati.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

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

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

versionCreateTime

string (Timestamp format)

Solo output. Ora di creazione di questa versione del set di dati. (È avvenuto durante l'importazione dei dati nel set di dati)

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

versionDescription

string

Solo output. La descrizione di questa versione del set di dati. Viene fornito durante l'importazione dei dati nel set di dati.

Campo di unione data_source. Dettagli sull'origine dei dati per il set di dati. data_source può essere solo uno dei seguenti:
localFileSource

object (LocalFileSource)

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

gcsSource

object (GcsSource)

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

Utilizzo

L'utilizzo specifica dove i dati vengono utilizzati per stabilire 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.

LocalFileSource

I dettagli sull'origine dati quando si tratta di un file locale.

Rappresentazione JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Campi
filename

string

Il nome e l'estensione del file caricato.

fileFormat

enum (FileFormat)

Il formato del file che viene caricato.

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

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

Rappresentazione JSON
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Campi
inputUri

string

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

fileFormat

enum (FileFormat)

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

Stato

Stato del set di dati.

Rappresentazione JSON
{
  "state": enum (State),
  "errorMessage": string
}
Campi
state

enum (State)

Enum per lo stato.

errorMessage

string

Messaggio di errore che indica il motivo dell'errore. Il campo è vuoto se lo stato del set di dati non è 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 Importazione dei dati in un set di dati in corso.
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: eliminazione non riuscita. Questo stato indica che l'eliminazione del set di dati non è riuscita. È possibile riprovare l'eliminazione.
STATE_PROCESSING Elaborazione dei dati in corso.
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 rappresenta la pubblicazione in corso.
STATE_PUBLISHING_FAILED Gli stati di pubblicazione non riuscita. Questo stato indica che la pubblicazione non è riuscita. È possibile riprovare la pubblicazione.
STATE_COMPLETED Lo stato completato. Questo stato rappresenta il set di dati disponibile per il suo utilizzo specifico.

Metodi

create

Crea un nuovo set di dati per il progetto specificato.

delete

Elimina il set di dati specificato .

get

Recupera il set di dati.

list

Elenca tutti i set di dati per il progetto specificato.

patch

Aggiorna i metadati per il set di dati.