Method: projects.image.import

Importa un'immagine.

Richiesta HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image: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.imports.create

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

object (ImageManifest)

Il file manifest dell'immagine.
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.

ImageManifest

Descrive in che modo il servizio EarthEngine deve comporre un'immagine da un insieme di file.

Rappresentazione JSON 
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "tilesets": [
    {
      object (Tileset)
    }
  ],
  "bands": [
    {
      object (TilesetBand)
    }
  ],
  "maskBands": [
    {
      object (TilesetMaskBand)
    }
  ],
  "footprint": {
    object (PixelFootprint)
  },
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "startTime": string,
  "endTime": string,
  "skipMetadataRead": boolean,
  "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.
tilesets[]

object (Tileset)

I set di riquadri. Ogni set di tessere deve avere un ID univoco.
bands[]

object (TilesetBand)

I cinturini. L'ordine delle bande dell'asset corrisponde a quello di bands.
maskBands[]

object (TilesetMaskBand)

Le bande della maschera.
footprint

object (PixelFootprint)

L'impronta in coordinate in pixel (non in coordinate lat/lng). Se vuoto, l'impronta è per impostazione predefinita l'intera immagine. Consulta PixelGrid per una descrizione più dettagliata delle coordinate dei pixel.
missingData

object (MissingData)

I valori che non rappresentano dati in tutte le bande dell'immagine. Si applica a tutti i gruppi che non specificano un proprio missingData.
pyramidingPolicy

enum (PyramidingPolicy)

Le norme relative al sistema piramidale. Se non specificato, per impostazione predefinita viene applicato il criterio MEDIA. Si applica a tutti i gruppi che non specificano un proprio pyramidingPolicy.
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".
skipMetadataRead

boolean

Indica se saltare la lettura dei metadati dai file utilizzando GDAL. Quando questo campo è true, i set di tessere devono contenere metadati GDAL completi: tipo di dati, sistema di riferimento, trasformazione, dimensioni del file e nessun valore di dati.
memo

string

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

TilesetBand

Rappresenta una singola banda proveniente da un set di tessere.

Rappresentazione JSON 
{
  "id": string,
  "tilesetId": string,
  "tilesetBandIndex": integer,
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy)
}
Campi
id

string

L'ID del gruppo.
tilesetId

string

L'ID del set di tessere corrispondente alla banda.
tilesetBandIndex

integer

L'indice della banda a partire da zero del set di tessere corrispondente alla banda. Ad esempio, se è 1, i pixel della banda sono i pixel della banda all'indice 1 del set di tessere (in ImageManifest.tilesets) con ID tilesetId.
missingData

object (MissingData)

I valori che non rappresentano dati nella banda. Se MissingData è impostato senza values, qualsiasi valore nodata presente per i file corrispondenti a questo TilesetBand verrà ignorato.
pyramidingPolicy

enum (PyramidingPolicy)

Le norme relative al sistema piramidale.

TilesetMaskBand

Rappresenta una singola banda di maschera proveniente da un set di tessere.

Rappresentazione JSON 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
Campi
tilesetId

string

L'ID del set di riquadri corrispondente alla banda della maschera. L'ultima banda del set di riquadri viene sempre utilizzata come banda della maschera.
bandIds[]

string

Gli ID delle bande a cui si applica la banda della maschera. Se è vuoto, la banda della maschera viene applicata a tutte le bande dell'asset. Ogni banda può avere una sola banda maschera corrispondente. Se una di queste bande ha una maschera interna, la maschera interna viene ignorata a favore di questa banda maschera.

PixelFootprint

Una impronta di tutti i pixel validi di un'immagine.

Rappresentazione JSON 
{
  "points": [
    {
      object (GridPoint)
    }
  ],
  "bandId": string
}
Campi
points[]

object (GridPoint)

Un anello che forma l'esterno di un poligono semplice che deve contenere i centri di tutti i pixel validi dell'immagine. Deve essere un anello lineare: l'ultimo punto deve essere uguale al primo. Le coordinate si trovano nella proiezione della banda specificata da bandId.

Nota: utilizza coordinate non intere, come il centro di ogni pixel, perché l'impronta viene considerata inclusa in un pixel se e solo se il pixel (un rettangolo 1x1) interseca l'impronta. Per evitare di selezionare accidentalmente i pixel vicini, non utilizzare coordinate con valori interi, perché sono i confini tra i pixel. Se disegni l'impronta lungo i centri dei pixel, eviti di includere pixel indesiderati, che possono causare errori quando i pixel previsti sono adiacenti a un confine della mappa, come l'antimeridiano o un polo.

Ad esempio, per un'immagine 2 x 2 con tutti e quattro i pixel validi, di seguito è riportato un possibile anello: [{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}]
bandId

string

L'ID della banda il cui sistema di riferimento cartografico definisce le coordinate dell'impronta. Se è vuoto, viene utilizzata la prima banda.

GridPoint

Un punto o un vettore bidimensionale.

Rappresentazione JSON 
{
  "x": number,
  "y": number
}
Campi
x

number

Il valore della coordinata x.
y

number

Il valore della coordinata y.