REST Resource: projects.assets

Risorsa: EarthEngineAsset

Informazioni su un asset Earth Engine.

Rappresentazione JSON
{
  "type": enum (Type),
  "name": string,
  "id": string,
  "updateTime": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string,
  "featureCount": string,
  "quota": {
    object (FolderQuota)
  },
  "tilesets": [
    {
      object (Tileset)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cloudStorageLocation": {
    object (CloudStorageLocation)
  },
  "featureViewAssetLocation": {
    object (FeatureViewLocation)
  }
  // End of mutually exclusive fields.
}
Campi
type

enum (Type)

Il tipo di asset.

name

string

Il nome della risorsa. name ha il formato "projects/*/assets/**" (ad es. "projects/earthengine-legacy/assets/users//").

id

string

ID della risorsa. Equivalente a name senza il prefisso "projects/*/assets/" (ad es. "users//"). Tieni presente che questo valore viene utilizzato solo a scopo di visualizzazione. Non deve essere utilizzato come input per un'altra operazione. Utilizza invece name.

updateTime

string (Timestamp format)

L'ora dell'ultima modifica dell'asset.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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".

properties

object (Struct format)

Proprietà chiave/valore associate alla risorsa.

startTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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 in un mese o un anno, questo timestamp corrisponde alla fine dell'intervallo (escluso).

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. 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".

geometry

object (Struct format)

L'impronta spaziale associata all'asset, se presente, come oggetto di geometria GeoJSON (vedi RFC 7946).

bands[]

object (ImageBand)

Informazioni sulle bande di dati dell'asset immagine. Omesso per gli asset non immagine.

sizeBytes

string (int64 format)

Le dimensioni di un asset foglia (ad es. un'immagine) in byte.

featureCount

string (int64 format)

Il numero di funzionalità nell'asset, se applicabile.

quota

object (FolderQuota)

Le informazioni sulla quota associate alla risorsa cartella, se presenti. Restituiti per gli asset delle cartelle di proprietà dell'utente di primo livello (ad es. "users/*" o "projects/*").

tilesets[]

object (Tileset)

I tileset che supportano questa immagine. Presente solo per le immagini esterne, i cui pixel vengono recuperati da uno spazio di archiviazione non di proprietà di Earth Engine.

Informazioni su dove e come vengono archiviate le tessere raster. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Deprecato. Utilizza invece ImportExternalImage. Per maggiori dettagli, visita la pagina https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff.

featureViewAssetLocation

object (FeatureViewLocation)

La posizione di questa FeatureView in EE.

Fine dei campi che si escludono a vicenda.

CloudStorageLocation

La posizione di un asset su Cloud Storage.

Rappresentazione JSON
{
  "uris": [
    string
  ]
}
Campi
uris[]

string

Gli URI dei dati. Sono supportati solo gli URI Google Cloud Storage. Ogni URI deve essere specificato nel seguente formato: "gs://bucket-id/object-id". Al momento è supportato un solo URI. Se viene specificato più di un URI, viene restituito un errore INALID_ARGUMENT.

FeatureViewLocation

Un asset FeatureView EE.

Rappresentazione JSON
{
  "assetOptions": {
    object (FeatureViewOptions)
  }
}
Campi
assetOptions

object (FeatureViewOptions)

Opzioni di importazione per gli asset FeatureView.

FeatureViewOptions

Opzioni di importazione per gli asset FeatureView.

Rappresentazione JSON
{
  "featureViewAttributes": [
    {
      object (FeatureViewAttribute)
    }
  ],
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  }
}
Campi
featureViewAttributes[]

object (FeatureViewAttribute)

Attributi nell'asset FeatureView, che comprendono uno schema per l'asset. Questi sono gli attributi che possono avere le funzionalità di questo asset. Ogni attributo ha un nome e un tipo.

ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

Parametri del tempo di importazione di FeatureView.

FeatureViewAttribute

Un attributo FeatureView e il relativo tipo.

Rappresentazione JSON
{
  "name": string,
  "type": enum (Type)
}
Campi
name

string

Nome dell'attributo.

type

enum (Type)

Il tipo di attributo.

Tipo

Questi tipi sono un mirror di quelli trovati in geo/enterprise/layers/public/data_source_schema.proto.

Enum
TYPE_UNSPECIFIED Tipo non specificato.
INTEGER Un valore intero a 64 bit.
BOOLEAN Valore booleano True/False.
DOUBLE Un numero con rappresentazione in virgola mobile a precisione doppia.
STRING Una stringa di lunghezza illimitata.
DATE_TIME Una data/ora, rappresentata come un numero intero a 64 bit con segno in microsecondi dall'epoca e che supporta quindi il periodo di tempo dal 290.308 a.C. al 294.247 d.C.

FeatureViewIngestionTimeParameters

Parametri del tempo di importazione di FeatureView. Questi parametri devono essere specificati al momento dell'importazione e non possono essere aggiornati al volo per una FeatureView.

Rappresentazione JSON
{
  "thinningOptions": {
    object (ThinningOptions)
  },
  "rankingOptions": {
    object (RankingOptions)
  }
}
Campi
thinningOptions

object (ThinningOptions)

Il numero massimo di rettangoli di selezione delle funzionalità che possono intersecare un riquadro. Questo numero deve essere non negativo.

rankingOptions

object (RankingOptions)

Opzioni per assegnare ranghi di ordine Z e ranghi di diradamento alle funzionalità.

ThinningOptions

Opzioni di assottigliamento che controllano la densità con cui vengono visualizzate le funzionalità per riquadro.

Rappresentazione JSON
{
  "maxFeaturesPerTile": integer,
  "thinningStrategy": enum (ThinningStrategy)
}
Campi
maxFeaturesPerTile

integer

Il numero massimo di rettangoli di selezione delle funzionalità che possono intersecare un riquadro. Questo numero deve essere non negativo.

thinningStrategy

enum (ThinningStrategy)

La strategia di riduzione delle funzionalità da utilizzare.

ThinningStrategy

Strategia di assottigliamento per le funzionalità.

Enum
UNKNOWN_THINNING_STRATEGY Strategia di assottigliamento sconosciuta.
GLOBALLY_CONSISTENT Quando viene eseguita la semplificazione a un determinato LOD, la semplificazione coerente a livello globale significa che se una funzionalità viene rimossa dalla semplificazione, verranno rimosse anche tutte le altre funzionalità con un ranking di semplificazione uguale o peggiore.
HIGHER_DENSITY

Quando esegui l'assottigliamento, cerca di avvicinarti il più possibile al limite maxFeaturesPerTile per ogni riquadro. Preferiremo le funzionalità con un ranking migliore rispetto a quelle con un ranking peggiore, ma a volte scarteremo le funzionalità con un ranking migliore se ciò ci aiuta a ottenere una densità di funzionalità più elevata.

Garantiamo che la strategia sia deterministica e che l'insieme delle funzionalità post-assottigliamento sia un superset di quelle generate dall'assottigliamento coerente a livello globale.

RankingOptions

Opzioni di classificazione per l'ordine Z e l'assottigliamento.

Rappresentazione JSON
{
  "zOrderRankingRule": {
    object (RankingRule)
  },
  "thinningRankingRule": {
    object (RankingRule)
  }
}
Campi
zOrderRankingRule

object (RankingRule)

Regola di classificazione per assegnare ranghi dell'ordine Z alle funzionalità.

thinningRankingRule

object (RankingRule)

Regola di classificazione per assegnare i ranghi di assottigliamento alle funzionalità.

RankingRule

Regole di ranking che controllano il modo in cui le funzionalità vengono classificate per l'assottigliamento e l'ordine Z.

Rappresentazione JSON
{
  "rankByOneThingRule": [
    {
      object (RankByOneThingRule)
    }
  ]
}
Campi
rankByOneThingRule[]

object (RankByOneThingRule)

Un elenco ordinato di zero o più regole di classificazione per un elemento (ad esempio un attributo), che vengono utilizzate come chiavi di classificazione primaria, secondaria e così via per impostare thinning_rank in ogni RankedFeature.

RankByOneThingRule

Una singola regola di ranking per controllare il ranking per l'assottigliamento e l'ordine Z.

Rappresentazione JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "rankByAttributeRule": {
    object (RankByAttributeRule)
  },
  "rankByMinVisibleLodRule": {
    object (RankByMinVisibleLodRule)
  },
  "rankByGeometryTypeRule": {
    object (RankByGeometryTypeRule)
  },
  "rankByMinZoomLevelRule": {
    object (RankByMinZoomLevelRule)
  }
  // End of mutually exclusive fields.
  "direction": enum (Direction)
}
Campi
Il tipo di regola di ranking da utilizzare. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
rankByAttributeRule

object (RankByAttributeRule)

Classifica in base al valore dell'attributo della funzionalità.

rankByMinVisibleLodRule
(deprecated)

object (RankByMinVisibleLodRule)

Classifica in base al livello di dettaglio minimo in cui la geometria della funzionalità è visibile per la prima volta. Una funzionalità con dei punti è sempre visibile a tutti i livelli di dettaglio. Deprecato: utilizza invece rankByMinZoomLevelRule.

rankByGeometryTypeRule

object (RankByGeometryTypeRule)

Classifica per tipo di geometria. Precedenza dei tipi, da alta a bassa: poligono, polilinea, punto, nessuno. Nelle funzionalità con più tipi, la priorità più alta ha la precedenza.

rankByMinZoomLevelRule

object (RankByMinZoomLevelRule)

Classifica in base al livello di zoom minimo a cui la geometria della funzionalità è visibile per la prima volta. Una funzionalità con dei punti è sempre visibile a tutti i livelli di dettaglio.

Fine dei campi che si escludono a vicenda.
direction

enum (Direction)

Indica se il ranking in base a questo elemento deve essere ASCENDING (valori più bassi per primi, ovvero più importanti) o DESCENDING (valori più alti per primi, ovvero più importanti). In altre parole, ASCENDING significa utilizzare direttamente l'ordinamento descritto nella documentazione del sottomessaggio RankByAttributeRule (o altro), mentre DESCENDING significa invertire l'ordinamento.

RankByAttributeRule

Classifica in base al valore dell'attributo della funzionalità.

Rappresentazione JSON
{
  "attributeName": string
}
Campi
attributeName

string

Classifica in base al valore dell'attributo con il nome specificato. Si tratta principalmente dell'ordinamento naturale dei valori del tipo specificato, con alcune sottigliezze e chiarimenti: - per gli attributi interi, i valori più bassi precedono quelli più alti - per gli attributi doppi, i valori più bassi precedono quelli più alti con NaN considerato inferiore a tutti gli altri valori, incluso meno infinito - per gli attributi booleani, false è considerato precedente a true - per gli attributi date_time, i valori precedenti precedono quelli successivi - gli attributi stringa sono classificati in ordine lessicografico - un attributo il cui valore non è stato impostato è considerato avere il valore predefinito del tipo specificato (0 per gli interi, false per i booleani e così via).

RankByMinVisibleLodRule

Questo tipo non contiene campi.

Classifica in base al livello di dettaglio minimo in cui la geometria della funzionalità è visibile per la prima volta. Una funzionalità con dei punti è sempre visibile a tutti i livelli di dettaglio.

RankByGeometryTypeRule

Questo tipo non contiene campi.

Classifica per tipo di geometria. Precedenza dei tipi, da alta a bassa: poligono, polilinea, punto, nessuno. Nelle funzionalità con più tipi, la priorità più alta ha la precedenza.

RankByMinZoomLevelRule

Questo tipo non contiene campi.

Classifica in base al livello di zoom minimo a cui la geometria della funzionalità è visibile per la prima volta. Una funzionalità con dei punti è sempre visibile a tutti i livelli di dettaglio.

Direzione

Se ordinare un elenco dal valore più basso a quello più alto (ASCENDING) o dal valore più alto a quello più basso (DESCENDING).

Enum
DIRECTION_UNSPECIFIED Nessuna direzione di ranking specificata.
ASCENDING Ordine crescente.
DESCENDING Ordine decrescente.

Tipo

Tipi di asset.

Enum
TYPE_UNSPECIFIED Non specificato.
IMAGE Immagine.
IMAGE_COLLECTION Raccolta di immagini.
TABLE Tabella.
FOLDER Cartella.
CLASSIFIER Classificatore.
FEATURE_VIEW Asset FeatureView.

ImageBand

Informazioni su una singola banda di dati di un asset immagine.

Rappresentazione JSON
{
  "id": string,
  "dataType": {
    object (PixelDataType)
  },
  "grid": {
    object (PixelGrid)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "missingData": {
    object (MissingData)
  }
}
Campi
id

string

L'ID della band.

dataType

object (PixelDataType)

Il tipo numerico della banda.

grid

object (PixelGrid)

La griglia a pixel del cinturino.

pyramidingPolicy

enum (PyramidingPolicy)

La policy di piramidazione della band.

missingData

object (MissingData)

I valori che indicano i dati mancanti.

PixelDataType

Specifica il tipo numerico dei pixel in una banda di immagine.

Rappresentazione JSON
{
  "precision": enum (Precision),
  "range": {
    object (DoubleRange)
  },
  "dimensionsCount": integer
}
Campi
precision

enum (Precision)

La precisione numerica del tipo.

range

object (DoubleRange)

L'intervallo del tipo numerico, se presente. In genere assente per i tipi in virgola mobile.

dimensionsCount

integer

Il numero di dimensioni in un tipo di dati con valori di array o zero per indicare un tipo scalare ordinario.

Precisione

Specifica la precisione di un tipo di dati numerici.

Enum
PRECISION_UNSPECIFIED Non specificato.
INT Il tipo di dati ha una precisione intera. Tieni presente che questo potrebbe rappresentare numeri interi di dimensioni diverse.
FLOAT Il tipo di dati ha una precisione a virgola mobile a 32 bit.
DOUBLE Il tipo di dati ha una precisione a virgola mobile (double) a 64 bit.

MissingData

Un elenco di valori che rappresentano l'assenza di dati.

Rappresentazione JSON
{
  "values": [
    number
  ]
}
Campi
values[]

number

Valori che non rappresentano dati.

FolderQuota

Descrive l'utilizzo e i limiti attuali di una cartella di primo livello.

Rappresentazione JSON
{
  "sizeBytes": string,
  "maxSizeBytes": string,
  "assetCount": string,
  "maxAssets": string
}
Campi
sizeBytes

string (int64 format)

Le dimensioni della cartella in byte.

maxSizeBytes

string (int64 format)

La dimensione massima della cartella in byte.

assetCount

string (int64 format)

Il numero di asset archiviati nella cartella.

maxAssets

string (int64 format)

Il numero massimo di asset che possono essere archiviati nella cartella.

Tileset

Un insieme di ImageSources a cui è possibile fare riferimento con un ID univoco.

Rappresentazione JSON
{
  "id": string,
  "sources": [
    {
      object (ImageSource)
    }
  ],
  "dataType": enum (DataType),
  "crs": string
}
Campi
id

string

L'ID del tileset. Deve essere univoco tra i tileset specificati in ImageManifest. Questo ID viene ignorato durante la fase di elaborazione e viene utilizzato solo per collegare un tileset a una banda. La stringa vuota è un ID valido.

sources[]

object (ImageSource)

Le origini che compongono questo tileset.

dataType

enum (DataType)

Un tipo di dati facoltativo per la banda. Se specificato, non viene eseguito alcun controllo per verificare che il tipo di ogni file di input corrisponda. dataType deve corrispondere al tipo di ogni file di input, tranne nei casi in cui il tipo di input è ambiguo (ad es. Byte può essere INT8 o UINT8).

crs

string

Il sistema di riferimento delle coordinate della griglia di pixel, specificato come codice standard, se possibile, e in formato WKT altrimenti.

ImageSource

Un file immagine e i relativi file collaterali.

Rappresentazione JSON
{
  "uris": [
    string
  ],
  "affineTransform": {
    object (AffineTransform)
  },
  "dimensions": {
    object (GridDimensions)
  }
}
Campi
uris[]

string

Gli URI dei dati da importare. Al momento sono supportati solo gli URI 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, seguito dai sidecar. Se impostato, ogni URI è preceduto da ImageManifest.uri_prefix.

affineTransform

object (AffineTransform)

Una trasformazione affine facoltativa. Deve essere specificato solo se i dati di uris (inclusi eventuali file collaterali) non sono sufficienti per posizionare i pixel.

dimensions

object (GridDimensions)

Dimensioni raster in pixel. Utilizzato solo quando è impostato "skipMetadataRead".

DataType

Specifica il tipo di dati numerici.

Enum
DATA_TYPE_UNSPECIFIED Non specificato.
INT8 Numero intero con segno a 8 bit.
UINT8 Numero intero non firmato a 8 bit.
INT16 Numero intero con segno a 16 bit.
UINT16 Numero intero senza segno a 16 bit.
INT32 Numero intero con segno a 32 bit.
UINT32 Numero intero non firmato a 32 bit.
FLOAT Virgola mobile a 32 bit.
DOUBLE Virgola mobile a 64 bit.

Metodi

copy

Copia un asset.

create

Crea una risorsa.

delete

Elimina un asset.

get

Recupera informazioni dettagliate su un asset.

getIamPolicy

Recupera la policy di controllo dell'accesso per una risorsa.

getPixels

Recupera i pixel da un asset immagine.

listAssets

Elenca qualsiasi asset contenitore, ad esempio una cartella o una raccolta.

listFeatures

Elenca le funzionalità in un asset tabella.

move

Sposta un asset.

patch

Aggiorna un asset.

setIamPolicy

Imposta la policy di controllo dell'accesso sulla risorsa specificata.

testIamPermissions

Restituisce le autorizzazioni di cui dispone un chiamante per la risorsa specificata.