Method: projects.table.import

Importa una tabella.

Richiesta HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/table:import

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
project

string

L'ID o il numero del progetto della piattaforma Google Cloud che deve essere considerato il consumatore di servizi per questa richiesta. Il formato è projects/{project-id}.

L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata project:

  • earthengine.assets.create

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "tableManifest": {
    object (TableManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
Campi
tableManifest

object (TableManifest)

Il file manifest della tabella.

description

string

Un nome leggibile dell'attività.

overwrite

boolean

Indica se consentire la sovrascrittura di una risorsa esistente.

requestId

string

Una stringa univoca utilizzata per rilevare le richieste duplicate. Se lo stesso utente effettua più richieste con lo stesso requestId non vuoto, solo una di queste richieste può avviare correttamente un'operazione a lungo termine. requestId può contenere i caratteri a-z, A-Z, 0-9 o "-". requestId può avere una lunghezza massima di 60 caratteri.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

TableManifest

Descrive in che modo il servizio EarthEngine deve comporre una tabella da un insieme di file.

Rappresentazione JSON
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "memo": string
}
Campi
name

string

Il nome dell'asset da creare. name sia nel formato "projects/*/assets/**" (ad es. "projects/earthengine-legacy/assets/users//"). Tutti gli asset di proprietà dell'utente si trovano nel progetto "earthengine-legacy" (ad es. "projects/earthengine-legacy/assets/users/foo/bar"). Tutti gli altri asset si trovano nel progetto "earthengine-public" (ad es. "projects/earthengine-public/assets/LANDSAT").

properties

object (Struct format)

Proprietà aggiuntive della risorsa. I nomi delle proprietà "system:time_start" e "system:time_end" sono stati ritirati. Utilizza invece i campi startTime e endTime.

uriPrefix

string

Il prefisso facoltativo anteposto a tutti i uri definiti in questo manifest.

sources[]

object (TableSource)

Le origini che compongono questa tabella.

startTime

string (Timestamp format)

Il timestamp associato all'asset, se presente, ad esempio l'ora in cui è stata acquisita un'immagine satellitare. Per gli asset che corrispondono a un intervallo di tempo, ad esempio i valori medi di un mese o un anno, questo timestamp corrisponde all'inizio dell'intervallo.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Per gli asset che corrispondono a un intervallo di tempo, ad esempio i valori medi di un mese o un anno, questo timestamp corrisponde alla fine dell'intervallo (esclusivo).

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

csvColumnDataTypeOverrides
(deprecated)

map (key: string, value: enum (CsvColumnDataType))

Utilizza invece columnDataTypeOverrides.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

columnDataTypeOverrides

map (key: string, value: enum (ColumnDataType))

Una mappa dal nome della colonna al tipo da utilizzare per quella colonna. Il tipo delle colonne non specificate qui verrà dedotto, in modo che le colonne numeriche diventino numeri, le colonne WKT diventino geometria e così via.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

memo

string

Campo di tipo libero per archiviare le note dell'utente. Non utilizzato nell'importazione.

TableSource

Un file di tabelle.

Rappresentazione JSON
{
  "uris": [
    string
  ],
  "charset": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "crs": string,
  "geodesic": boolean,
  "primaryGeometryColumn": string,
  "xColumn": string,
  "yColumn": string,
  "dateFormat": string,
  "csvDelimiter": string,
  "csvQualifier": string
}
Campi
uris[]

string

Gli URI dei dati da importare. Al momento sono supportati solo gli URI di Google Cloud Storage. Ogni URI deve essere specificato nel seguente formato: "gs://bucket-id/object-id". L'oggetto principale deve essere il primo elemento dell'elenco, i file sidecar vengono dedotti dal percorso del file dell'oggetto principale. Al momento è supportato un solo URI. Se viene specificato più di un URI, viene restituito un errore INALID_ARGUMENT.

charset

string

Il nome del set di caratteri predefinito da utilizzare per la decodifica delle stringhe. Se vuoto, per impostazione predefinita viene assunto il set di caratteri "utf-8".

maxErrorMeters

number

L'errore massimo consentito in metri durante la trasformazione della geometria tra sistemi di coordinate. Se non viene specificato, l'errore massimo è 1 metro per impostazione predefinita.

maxVertices

integer

Il numero massimo di vertici. Se non è pari a zero, la geometria verrà suddivisa in parti spazialmente sconnesse, ciascuna delle quali inferiore a questo limite.

crs

string

Il codice CRS o la stringa WKT predefiniti che specificano il sistema di riferimento dei coordinate di qualsiasi geometria per cui non è stato specificato un sistema. Se il campo viene lasciato vuoto, il valore predefinito sarà EPSG:4326: https://epsg.io/4326. Solo per origini CSV/TFRecord.

geodesic

boolean

La strategia predefinita per l'interpretazione degli spigoli nella geometria che non ne hanno uno specificato diversamente. Se è false, i bordi sono dritti nella proiezione. Se true, i bordi sono curvi per seguire il percorso più breve sulla superficie della Terra. Se non viene specificato, il valore predefinito è false se "crs" è un sistema di coordinate proiettato. Solo per origini CSV/TFRecord.

primaryGeometryColumn

string

La colonna della geometria da utilizzare come geometria principale di una riga quando sono presenti più colonne della geometria.

Se viene lasciato vuoto ed esiste più di una colonna di geometria, viene utilizzata la prima colonna di geometria trovata. Solo per origini CSV/TFRecord.

xColumn

string

Il nome della colonna della coordinata x numerica per dedurre la geometria del punto. Se viene specificata anche la colonna y e entrambe le colonne contengono valori numerici, verrà creata una colonna di geometria punto con i valori x,y nel sistema di coordinate specificato in "crs". Se viene lasciato vuoto e "crs" non specifica un sistema di coordinate proiettato, il valore predefinito è "longitude". Se lasciato vuoto e "crs" specifica un sistema di coordinate proiettato, il valore predefinito è "" e non viene generata alcuna geometria punto.

Una colonna della geometria dei punti generata avrà il nome {xColumn}_{yColumn}_N, dove N viene aggiunto in modo che {xColumn}_{yColumn}_N sia univoco se esiste già una colonna denominata {xColumn}_{yColumn}. Solo per origini CSV/TFRecord.

yColumn

string

Il nome della colonna della coordinata y numerica per dedurre la geometria del punto. Se viene specificata anche la colonna x e entrambe le colonne contengono valori numerici, verrà creata una colonna di geometria punto con i valori x,y nel sistema di coordinate specificato in "crs". Se viene lasciato vuoto e "crs" non specifica un sistema di coordinate proiettato, il valore predefinito è "latitudine". Se lasciato vuoto e "crs" specifica un sistema di coordinate proiettato, il valore predefinito è "" e non viene generata alcuna geometria punto.

Una colonna della geometria dei punti generata avrà il nome {xColumn}_{yColumn}_N, dove N viene aggiunto in modo che {xColumn}_{yColumn}_N sia univoco se esiste già una colonna denominata {xColumn}_{yColumn}. Solo per origini CSV/TFRecord.

dateFormat

string

Un formato con cui analizzare i campi che codificano le date. Il pattern di formato deve essere come descritto all'indirizzo http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html. Se viene lasciato vuoto, le date verranno importate come stringhe. Solo per origini CSV/TFRecord.

csvDelimiter

string

Durante l'importazione dei file CSV, un singolo carattere utilizzato come delimitatore tra i valori delle colonne in una riga. Se non viene specificato, il valore predefinito è ",". Solo per le origini CSV.

csvQualifier

string

Durante l'importazione dei file CSV, un carattere che racchiude i valori delle colonne (noto anche come "carattere di virgolette"). Se non viene specificato, il valore predefinito è "". Solo per le origini CSV.

Se un valore di colonna non è racchiuso tra qualificatori, gli spazi iniziali e finali vengono tagliati. Ad esempio: ..., test,... <== questo valore non è qualificato diventa il valore di stringa: "test" <== gli spazi vengono rimossi

where: ...," test",... <== questo valore È qualificato con virgolette diventa il valore della stringa: " test" <== lo spazio rimane!