Method: projects.image.import

Importiert ein Bild.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
project

string

Die Projekt-ID oder Projektnummer des Google Cloud-Projekts, das für diese Anfrage als Dienstnutzer behandelt werden soll. Format ist projects/{project-id}.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource project erforderlich:

  • earthengine.imports.create

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "imageManifest": {
    object (ImageManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
Felder
imageManifest

object (ImageManifest)

Das Bildmanifest.
description

string

Ein für Menschen lesbarer Name der Aufgabe.
overwrite

boolean

Gibt an, ob ein vorhandenes Asset überschrieben werden darf.
requestId

string

Ein eindeutiger String, mit dem doppelte Anfragen erkannt werden. Wenn derselbe Nutzer mehrere Anfragen mit derselben nicht leeren requestId stellt, kann nur eine dieser Anfragen einen langwierigen Vorgang starten. requestId darf die Zeichen a–z, A–Z, 0–9 oder „-“ enthalten. requestId darf maximal 60 Zeichen lang sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ImageManifest

Hier wird beschrieben, wie der EarthEngine-Dienst ein Bild aus einer Reihe von Dateien zusammenstellen soll.

JSON-Darstellung 
{
  "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
}
Felder
name

string

Der Name des zu erstellenden Assets. name hat das Format „projects/*/assets/**“ (z.B. „projects/earthengine-legacy/assets/users//“). Alle vom Nutzer erstellten Assets befinden sich im Projekt „earthengine-legacy“ (z.B. „projects/earthengine-legacy/assets/users/foo/bar“). Alle anderen Assets befinden sich im Projekt „earthengine-public“ (z.B. „projects/earthengine-public/assets/LANDSAT“).
properties

object (Struct format)

Zusätzliche Eigenschaften des Assets. Die Property-Namen „system:time_start“ und „system:time_end“ werden nicht mehr unterstützt. Verwenden Sie stattdessen die Felder startTime und endTime.
uriPrefix

string

Das optionale Präfix, das allen in diesem Manifest definierten uri vorangestellt wird.
tilesets[]

object (Tileset)

Die tilesets. Jeder Tileset muss eine eindeutige ID haben.
bands[]

object (TilesetBand)

Die Armbänder. Die Bandreihenfolge des Assets entspricht der Reihenfolge von bands.
maskBands[]

object (TilesetMaskBand)

Die Maskenbänder.
footprint

object (PixelFootprint)

Der Footprint in Pixelkoordinaten (nicht in Breiten-/Längengradkoordinaten). Wenn das Feld leer ist, entspricht der Footprint standardmäßig dem gesamten Bild. Eine ausführlichere Beschreibung von Pixelkoordinaten finden Sie unter PixelGrid.
missingData

object (MissingData)

Die Werte, die in allen Bändern des Bilds keine Daten darstellen. Gilt für alle Bänder, für die keine eigene missingData angegeben ist.
pyramidingPolicy

enum (PyramidingPolicy)

Die Richtlinie zu Pyramidensystemen. Wenn keine Angabe erfolgt, wird standardmäßig die Richtlinie „MITTELWERT“ angewendet. Gilt für alle Bänder, für die keine eigene pyramidingPolicy angegeben ist.
startTime

string (Timestamp format)

Der Zeitstempel, der mit dem Asset verknüpft ist, z.B. die Uhrzeit, zu der ein Satellitenbild aufgenommen wurde. Bei Assets, die einem bestimmten Zeitraum entsprechen, z. B. Durchschnittswerten über einen Monat oder ein Jahr, entspricht dieser Zeitstempel dem Beginn dieses Zeitraums.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Bei Assets, die einem bestimmten Zeitraum entsprechen, z. B. Durchschnittswerte über einen Monat oder ein Jahr, entspricht dieser Zeitstempel dem Ende dieses Zeitraums (exklusiv).

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
skipMetadataRead

boolean

Gibt an, ob das Lesen von Metadaten aus Dateien mit GDAL übersprungen werden soll. Wenn dieses Feld auf „True“ festgelegt ist, sollten Datasets vollständige GDAL-Metadaten enthalten: Datentyp, CRS, Transformation, Dateiabmessungen und keinen Datenwert.
memo

string

Freies Feld zum Speichern von Nutzernotizen. Wird bei der Datenaufnahme nicht verwendet.

TilesetBand

Stellt einen einzelnen Streifen aus einem Dataset dar.

JSON-Darstellung 
{
  "id": string,
  "tilesetId": string,
  "tilesetBandIndex": integer,
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy)
}
Felder
id

string

Die ID des Bandes.
tilesetId

string

Die ID des Rasterbildsatzes, der der Band entspricht.
tilesetBandIndex

integer

Der nullbasierte Bandindex aus dem Dataset, der dem Band entspricht. Wenn beispielsweise „1“ festgelegt ist, sind die Pixel des Bandes die Pixel des Bandes mit Index 1 des Datasets (in ImageManifest.tilesets) mit der ID tilesetId.
missingData

object (MissingData)

Die Werte, die keine Daten im Band darstellen. Wenn MissingData ohne values festgelegt ist, werden alle NoData-Werte für die Dateien, die dieser TilesetBand entsprechen, ignoriert.
pyramidingPolicy

enum (PyramidingPolicy)

Die Richtlinie zu Pyramidensystemen.

TilesetMaskBand

Stellt ein einzelnes Maskenband aus einem Raster dar.

JSON-Darstellung 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
Felder
tilesetId

string

Die ID des Tilesets, die dem Maskenband entspricht. Das letzte Band des Tilesets wird immer als Maskenband verwendet.
bandIds[]

string

Die IDs der Bänder, auf die das Maskenband angewendet wird. Wenn das Feld leer ist, wird das Maskierungsband auf alle Bänder im Asset angewendet. Jedes Band darf nur ein entsprechendes Maskenband haben. Wenn eines dieser Bänder eine interne Maske hat, wird die interne Maske zugunsten dieses Maskenbands ignoriert.

PixelFootprint

Ein Abdruck aller gültigen Pixel in einem Bild.

JSON-Darstellung 
{
  "points": [
    {
      object (GridPoint)
    }
  ],
  "bandId": string
}
Felder
points[]

object (GridPoint)

Ein Ring, der die Außenseite eines einfachen Polygons bildet und die Mittelpunkte aller gültigen Pixel des Bilds enthalten muss. Dies muss ein linearer Ring sein: Der letzte Punkt muss mit dem ersten übereinstimmen. Die Koordinaten sind in der Projektion des durch bandId angegebenen Bandes.

Hinweis: Verwenden Sie nicht ganzzahlige Koordinaten, z. B. den Mittelpunkt jedes Pixels, da ein Pixel nur dann zum Fußabdruck gehört, wenn es (als Rechteck mit einer Größe von 1 × 1) den Fußabdruck schneidet. Verwenden Sie keine Koordinaten mit Ganzzahlwerten, um versehentlich benachbarte Pixel auszuwählen, da dies die Grenzen zwischen Pixeln sind. Wenn Sie den Fußabdruck entlang der Pixelzentren zeichnen, werden unbeabsichtigte Pixel ausgeschlossen. Das kann zu Fehlern führen, wenn beabsichtigte Pixel an eine Kartengrenze wie den Antimeridian oder einen Pol angrenzen.

Für ein 2 × 2 Pixel großes Bild mit allen vier gültigen Pixeln ist beispielsweise Folgendes ein möglicher Ring: [{"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

Die ID der Band, deren CRS die Koordinaten des Fußabdrucks definiert. Wenn leer, wird das erste Band verwendet.

GridPoint

Ein zweidimensionaler Punkt oder Vektor.

JSON-Darstellung 
{
  "x": number,
  "y": number
}
Felder
x

number

Der Wert der X-Koordinate.
y

number

Der Wert der Y-Koordinate.