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 |
L'ID o il numero del progetto della piattaforma Google Cloud che deve essere considerato il consumatore di servizi per questa richiesta. Il formato è L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"tableManifest": {
object ( |
Campi | |
---|---|
tableManifest |
Il file manifest della tabella. |
description |
Un nome leggibile dell'attività. |
overwrite |
Indica se consentire la sovrascrittura di una risorsa esistente. |
requestId |
Una stringa univoca utilizzata per rilevare le richieste duplicate. Se lo stesso utente effettua più richieste con lo stesso |
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 ( |
Campi | |
---|---|
name |
Il nome dell'asset da creare. |
properties |
Proprietà aggiuntive della risorsa. I nomi delle proprietà "system:time_start" e "system:time_end" sono stati ritirati. Utilizza invece i campi |
uriPrefix |
Il prefisso facoltativo anteposto a tutti i |
sources[] |
Le origini che compongono questa tabella. |
startTime |
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: |
endTime |
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: |
csvColumnDataTypeOverrides |
Utilizza invece columnDataTypeOverrides. Un oggetto contenente un elenco di coppie |
columnDataTypeOverrides |
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 |
memo |
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[] |
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 |
charset |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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! |