Wenn Sie beim Hochladen von Bildern in Google Earth Engine (EE) mehr Flexibilität benötigen, als die Code-Editor-Benutzeroberfläche oder der Befehl upload des earthengine-Befehlszeilentools bieten, können Sie einen Bildupload mithilfe einer JSON-Datei, die als „Manifest“ bezeichnet wird, und des Befehls upload image --manifest des Befehlszeilentools beschreiben.
Ein vollständiges Beispiel finden Sie in diesem Colab-Notebook. Dort wird gezeigt, wie Bildkacheln mithilfe eines Manifests als einzelnes Asset hochgeladen werden.
Einmalige Einrichtung
- Manifest-Uploads funktionieren nur mit Dateien, die sich in Google Cloud Storage befinden. Wenn Sie Google Cloud Storage verwenden möchten, erstellen Sie ein Google Cloud-Projekt, falls Sie noch keines haben. Für die Einrichtung muss eine Kreditkarte für die Abrechnung angegeben werden. EE selbst berechnet derzeit keine Gebühren. Für die Übertragung von Dateien an Google Cloud Storage vor dem Hochladen in EE fallen jedoch geringe Kosten an. Bei typischen Upload-Datengrößen (Zehner- oder Hunderter-Gigabyte-Bereich) sind die Kosten recht niedrig.
- Aktivieren Sie die Cloud Storage API in Ihrem Projekt und erstellen Sie einen Bucket.
- Installieren Sie den Earth Engine-Python-Client. Es enthält das
earthengine-Befehlszeilentool, das wir zum Hochladen von Daten verwenden werden. - Für automatisierte Uploads können Sie ein mit Ihrem Projekt verknüpftes Google Cloud-Dienstkonto verwenden. Sie benötigen kein Dienstkonto für Tests, sollten sich aber bei Gelegenheit mit der Verwendung von Dienstkonten vertraut machen.
Sehr große Quelldateien (100 GB oder mehr) werden möglicherweise schneller hochgeladen, wenn sie in mehrere Kacheln aufgeteilt werden.
Asset-IDs und -Namen
Verwenden Sie für Assets, die zu einem Cloud-Projekt gehören, die folgende Konvention für Asset-Namen: projects/some-project-id/assets/some-asset-id.
Informationen zu Asset-Namen für Legacy-Projekte und Assets im Besitz von Nutzern
Bei älteren Legacy-Projekten muss sich der Asset-Name im Manifest geringfügig von der Asset-ID unterscheiden, die an anderer Stelle in Earth Engine sichtbar ist. Wenn Sie Assets hochladen möchten, deren Asset-IDs mit users/some_user oder projects/some_project beginnen, muss der Asset-Name im Manifest den String projects/earthengine-legacy/assets/ vor der ID enthalten. Beispiel: Die EE-Asset-ID users/username/my_geotiff sollte mit dem Namen projects/earthengine-legacy/assets/users/username/my_geotiff hochgeladen werden.
Ja, das bedeutet, dass IDs wie projects/some_projects/some_asset in Namen umgewandelt werden, in denen projects zweimal erwähnt wird: projects/earthengine-legacy/assets/projects/some_projects/some_asset.
Das ist zwar verwirrend, aber notwendig, um den Google Cloud API-Standards zu entsprechen.
Manifeste verwenden
Ein einfaches Manifest finden Sie im folgenden Codeblock. Es wird eine Datei mit dem Namen small.tif aus einem Google Cloud Storage-Bucket mit dem Namen gs://earthengine-test hochgeladen.
{
"name": "projects/some-project-id/assets/some-asset-id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://earthengine-test/small.tif"
]
}
]
}
]
}Wenn Sie es verwenden möchten, speichern Sie es in einer Datei mit dem Namen manifest.json und führen Sie Folgendes aus:
earthengine upload image --manifest /path/to/manifest.json
(Die Datei gs://earthengine-test/small.tif ist vorhanden und öffentlich lesbar. Sie können sie zum Testen verwenden.)
Tilesets
Die etwas komplizierte Manifeststruktur von JSON ist erforderlich, um genügend Flexibilität zu bieten, um eine häufige Herausforderung beim Hochladen zu bewältigen: wie alle möglichen Möglichkeiten beschrieben werden, Pixel aus mehreren Quelldateien in einem einzigen Asset zu kombinieren. Es gibt zwei unabhängige Möglichkeiten, Dateien zu gruppieren:
- Mosaike. Manchmal stellen mehrere Dateien mehrere Kacheln dar (z. B. ist jede Kachel ein 1x1-Grad-Quadrat). Solche Dateien müssen in einem EE-Asset zu einem Mosaik zusammengefügt werden.
- Separate Armbänder. Manchmal stellen mehrere Dateien mehrere Bänder dar. Solche Dateien müssen als Bänder in einem EE-Asset gestapelt werden.
(Beide Methoden müssen möglicherweise gleichzeitig verwendet werden, aber das ist selten.)
Zur Beschreibung dieser Optionen wird in Manifesten das Konzept eines Tilesets eingeführt. Ein einzelnes Tileset entspricht einer einzelnen GDAL-Quelle. Daher müssen alle Quellen in einem einzelnen Tileset dieselbe GDAL-Struktur haben (Anzahl und Typ der Bänder, Projektion, Transformation, fehlender Wert). Da eine GDAL-Quelle mehrere Bänder haben kann, kann ein Tileset Daten für mehrere EE-Bänder enthalten.
Für die Mosaikaufnahme sieht das Manifest so aus:
{
"name": "projects/some-project-id/assets/some-asset-id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://bucket/N30W22.tif"
]
},
{
"uris": [
"gs://bucket/N31W22.tif"
]
}
]
}
]
}Bei separaten Bändern sieht das Manifest so aus (Sie müssen auch einen bands-Abschnitt hinzufügen, wie unten erläutert):
{
"name": "projects/some-project-id/assets/some-asset-id",
"bands": ...,
"tilesets": [
{
"id": "tileset_for_band1",
"sources": [
{
"uris": [
"gs://bucket/band1.tif"
]
}
]
},
{
"id": "tileset_for_band2",
"sources": [
{
"uris": [
"gs://bucket/band2.tif"
]
}
]
}
]
}Bei separaten Bändern müssen wir jedem Tileset zur Klarstellung eine andere Tileset-ID zuweisen. Die Tileset-ID kann ein beliebiger String sein. Diese Strings werden nicht im hochgeladenen Asset gespeichert. Tileset-IDs werden nur bei der Aufnahme verwendet, um gestapelte Tilesets voneinander zu unterscheiden.
Bänder
Das zweite wichtige Konzept ist der Abgleich von Quelldateien mit EE-Asset-Bändern.
Dazu wird der Abschnitt bands des Manifests verwendet.
Der Abschnitt bands kann weggelassen werden. In diesem Fall werden die Bänder zuerst aus den Dateien im ersten Tileset, dann aus dem nächsten Tileset usw. erstellt.
Standardmäßig heißen die Bänder „b1“, „b2“ usw. Wenn Sie die Standardbandnamen überschreiben möchten, fügen Sie am Ende einen Abschnitt „bands“ ein, z. B.:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://bucket/rgb.tif"
]
}
]
}
],
"bands": [
{
"id": "R",
"tilesetBandIndex": 0
},
{
"id": "G",
"tilesetBandIndex": 1
},
{
"id": "B",
"tilesetBandIndex": 2
}
]
}Die Anzahl der EE-Bänder muss mit der Gesamtzahl der Bänder in allen Tilesets übereinstimmen.
Wenn Sie nicht alle Bänder aus einer Datei aufnehmen möchten, können Sie mit dem Feld tilesetBandIndex angeben, welche GDAL-Bänder aufgenommen werden sollen.
Das erste Band hat den tilesetBandIndex 0.
Beispiel:
Angenommen, die Quelldatei hat vier Bänder: „tmin“, „tmin_error“, „tmax“, „tmax_error“. Wir möchten nur „tmin“ und „tmax“ aufnehmen. Die relevanten Manifestabschnitte sehen so aus:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"id": "temperature",
"sources": [
{
"uris": [
"gs://bucket/temperature.tif"
]
}
]
}
],
"bands": [
{
"id": "tmin",
"tilesetBandIndex": 0,
"tilesetId": "temperature"
},
{
"id": "tmax",
"tilesetBandIndex": 2,
"tilesetId": "temperature"
}
]
}Maskenbänder
Die Bandmaskierung wird über die Komponente maskBands des Manifests gesteuert.
Es werden drei mögliche Maskenkonfigurationen unterstützt. Das Maskenband wird jedoch immer als das letzte Band in einer bestimmten Datei angenommen.
- Maske für alle Datenbänder in derselben Datei.
- Maske für alle Datenbänder aus allen anderen Dateien.
- Maske für einige Datenbänder.
1. Der häufigste Fall ist ein einzelnes GeoTIFF, dessen letztes Band als Maske für die anderen Bänder verwendet wird. Dies funktioniert nur für GeoTIFFs vom Typ „Byte“. Verwenden Sie das folgende Manifest:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"id": "data_tileset",
"sources": [
{
"uris": [
"gs://bucket/data_file.tif"
]
}
]
}
],
"bands": [
{
"id": "data_band",
"tilesetId": "data_tileset"
},
{
"id": "qa_band",
"tilesetId": "data_tileset"
}
],
"maskBands": [
{
"tilesetId": "data_tileset"
}
]
}2. Wenn Sie ein Masken-GeoTIFF als Maske für alle Bänder in einem anderen GeoTIFF verwenden möchten, verwenden Sie das folgende Manifest:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"id": "data_tileset",
"sources": [
{
"uris": [
"gs://bucket/data_file.tif"
]
}
]
},
{
"id": "mask_tileset",
"sources": [
{
"uris": [
"gs://bucket/mask_file.tif"
]
}
]
}
],
"bands": [
{
"id": "data_band",
"tilesetId": "data_tileset"
},
{
"id": "qa_band",
"tilesetId": "data_tileset"
}
],
"maskBands": [
{
"tilesetId": "mask_tileset"
}
]
}3. Wenn Sie ein GeoTIFF als Maske für ein bestimmtes Band in einer anderen Datei verwenden möchten, verwenden Sie das folgende Manifest. Der Unterschied zum vorherigen Fall besteht darin, dass das Feld bandIds in maskBands festgelegt ist:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"id": "data_tileset",
"sources": [
{
"uris": [
"gs://bucket/data_file.tif"
]
}
]
},
{
"id": "mask_tileset",
"sources": [
{
"uris": [
"gs://bucket/mask_file.tif"
]
}
]
}
],
"bands": [
{
"id": "data_band",
"tilesetId": "data_tileset"
},
{
"id": "qa_band",
"tilesetId": "data_tileset"
}
],
"maskBands": [
{
"tilesetId": "mask_tileset",
"bandIds": ["data_band"]
}
]
}Im letzten Beispiel arbeiten wir mit zwei Bändern aus dem Tileset data_tileset, wenden aber nur auf eines der Bänder (data_band) eine Maske an, wie im Feld bandIds des einzigen bereitgestellten maskBands-Listenobjekts angegeben.
Nur das letzte Band des in maskBands genannten Tilesets wird als Maskenband verwendet.
Richtlinie zu Schneeballsystemen
Wenn Earth Engine während der Aufnahme Bildpyramiden erstellt, müssen 2 × 2-Pixel-Raster wiederholt auf ein einzelnes Pixel reduziert werden, wobei der Pixelwert auf irgendeine Weise transformiert wird. Standardmäßig werden Pixelwerte gemittelt. Das ist in den meisten Fällen die richtige Vorgehensweise, wenn das Rasterband mehr oder weniger kontinuierliche Daten darstellt. Es gibt jedoch zwei Situationen, in denen die Verwendung des Standardwerts zu falschen Ergebnissen führt. In diesen Fällen muss das Feld pyramidingPolicy in der Banddefinition festgelegt werden. Wenn es nicht festgelegt ist, wird standardmäßig der Wert „MEAN“ angenommen.
Für die Klassifizierung von Rasterbildern (z. B. für die Klassifizierung der Landbedeckung) ist es am logischsten, die Mehrheit der vier Werte zu nehmen, um den nächsten zu erzeugen. Dazu wird die Pyramidenrichtlinie „MODE“ verwendet:
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://bucket/landcover.tif"
]
}
]
}
],
"bands": [
{
"id": "landcover",
"pyramidingPolicy": "MODE"
}
]
}Für Rasterbänder, bei denen weder „MEAN“ noch „MODE“ sinnvoll ist (z. B. bitgepackte Pixel), sollte die Pyramidenrichtlinie „SAMPLE“ verwendet werden. „SAMPLE“ nimmt immer den Wert des oberen linken Pixels aus jedem 2x2-Raster an. Im folgenden Beispiel wird die Pyramidenrichtlinie „MEAN“ einem Band zugewiesen, das eine kontinuierliche Variable („NDVI“) darstellt, und „SAMPLE“ dem „QA“-Band der Daten.
{
"name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://bucket/ndvi.tif"
]
}
]
}
],
"bands": [
{
"id": "NDVI",
"tilesetBandIndex": 0,
"pyramidingPolicy": "MEAN"
},
{
"id": "QA",
"tilesetBandIndex": 1,
"pyramidingPolicy": "SAMPLE"
}
]
}Beginn und Ende
Für alle Assets sollten Beginn und Ende angegeben werden, um den Daten mehr Kontext zu verleihen, insbesondere wenn sie in Sammlungen enthalten sind. Diese Felder sind nicht erforderlich, wir empfehlen jedoch dringend, sie nach Möglichkeit zu verwenden.
Start- und Endzeit beziehen sich in der Regel auf den Zeitpunkt der Beobachtung, nicht auf den Zeitpunkt, zu dem die Quelldatei erstellt wurde.
Die Endzeit wird der Einfachheit halber als exklusive Grenze behandelt. Verwenden Sie beispielsweise für Assets, die genau einen Tag umfassen, die Mitternacht von zwei aufeinanderfolgenden Tagen (z. B. 1980-01-31T00:00:00 und 1980-02-01T00:00:00) als Start- und Endzeit. Wenn das Asset keine Dauer hat, legen Sie die Endzeit auf die Startzeit fest. Stellen Sie Zeiten in Manifesten als ISO 8601-Strings dar. Wir empfehlen, davon auszugehen, dass die Endzeit exklusiv ist (z. B. Mitternacht des nächsten Tages für tägliche Assets), um die Datumswerte zu vereinfachen.
Beispiel:
{
"name": "projects/some-project-id/assets/some-asset-id",
"tilesets": [
{
"sources": [
{
"uris": [
"gs://bucket/img_20190612.tif"
]
}
]
}
],
"startTime": "1980-01-31T00:00:00Z",
"endTime": "1980-02-01T00:00:00Z"
}Referenz zur Manifeststruktur
Die folgende JSON-Struktur enthält alle möglichen Felder für das Manifest zum Hochladen von Bildern. Felddefinitionen finden Sie im folgenden Abschnitt zu Manifestfelddefinitionen.
{ "name": <string>, "tilesets": [ { "dataType": <string>, "id": <string>, "crs": <string>, "sources": [ { "uris": [ <stringn>> ], "affineTransform": { "scaleX": <double>, "shearX": <double>, "translateX": <double>, "shearY": <double>, "scaleY": <double>, "translateY": <double> } } ] } ], "bands": [ { "id": <string>, "tilesetId": <string>, "tilesetBandIndex": <int32>, "missingData": { "values": [<doublen>>] }, "pyramindingPolicy": <string> } ], "maskBands": [ { "tilesetId": <string>, "bandIds": [ <stringn>> ] } ], "footprint": { "points": [ { "x": <double>, "y": <doublen>> } ], "bandId": <string> }, "missingData": { "values": [<double>] }, "pyramidingPolicy": <string>, "uriPrefix": <string>, "startTime": { "seconds": <integer> }, "endTime": { "seconds": <integer> }, "properties": { <unspecified> } }
Felddefinitionen im Manifest
name
string
Der Name des zu erstellenden Assets.
name hat das Format „projects/*/assets/**“ (z. B. „projects/earthengine-legacy/assets/users/USER/ASSET“).
Tilesets
list
Eine Liste von Wörterbüchern, die Attribute für Kachelsätze definieren.
Weitere Informationen finden Sie in den folgenden Feldern des tilesets-Wörterbuchelements.
tilesets[i].dataType
string
Gibt den numerischen Datentyp der Daten an. Der Standardwert ist der von GDAL gemeldete Typ. In diesem Fall ist keine Definition erforderlich.
| Datentyp | Wert |
|---|---|
| Ohne Angabe | „DATA_TYPE_UNSPECIFIED“ |
| Vorzeichenbehaftete 8-Bit-Ganzzahl | "INT8" |
| Vorzeichenlose 8-Bit-Ganzzahl | "UINT8" |
| Vorzeichenbehaftete 16-Bit-Ganzzahl | "INT16" |
| Vorzeichenlose 16-Bit-Ganzzahl | "UINT16" |
| Vorzeichenbehaftete 32-Bit-Ganzzahl | "INT32" |
| Vorzeichenlose 32-Bit-Ganzzahl | "UINT32" |
| 32-Bit-Gleitkomma | "FLOAT32" |
| 64-Bit-Gleitkommazahl | "FLOAT64" |
tilesets[i].id
string
Die ID des Tilesets. Muss unter den im Asset-Manifest angegebenen Tilesets eindeutig sein. Diese ID wird während des Verarbeitungsschritts verworfen. Sie wird nur verwendet, um ein Tileset mit einem Band zu verknüpfen. Der leere String ist eine gültige ID.
tilesets[i].crs
string
Das Koordinatenreferenzsystem des Pixelrasters, das nach Möglichkeit als Standardcode (z. B. EPSG-Code) und andernfalls im WKT-Format angegeben wird.
tilesets[i].sources
list
Eine Liste von Wörterbüchern, die die Attribute einer Bilddatei und ihrer Sidecars definieren. Weitere Informationen finden Sie in den folgenden Feldern des sources-Wörterbuchelements.
tilesets[i].sources[j].uris
list
Eine Liste der URIs der aufzunehmenden Daten. Es werden nur Google Cloud Storage-URIs unterstützt. Jeder URI muss im folgenden Format angegeben werden: gs://bucket-id/object-id.
Das primäre Objekt sollte das erste Element der Liste sein, gefolgt von den Sidecars. Jedem URI wird ImageManifest.uriPrefix vorangestellt, falls festgelegt.
tilesets[i].sources[j].affineTransform
dictionary
Eine optionale affine Transformation. Sollte nur angegeben werden, wenn die Daten aus uris (einschließlich aller Sidecars) nicht ausreichen, um die Pixel zu platzieren.
Wird als Wörterbuch mit den folgenden Schlüsseln bereitgestellt: „scaleX“, „shearX“, „translateX“, „shearY“, „scaleY“, „translateY“.
Weitere Informationen finden Sie in dieser Referenz.
Beispielschlüssel und -werte:
{
"scaleX": 0.1,
"shearX": 0.0,
"translateX": -180.0,
"shearY": 0.0,
"scaleY": -0.1,
"translateY": 90.0
}bands
list
Eine Liste von Wörterbüchern, die die Eigenschaften eines einzelnen Bands aus einem Tileset definieren.
Die Bandreihenfolge des Assets entspricht der Reihenfolge von bands.
Weitere Informationen finden Sie in den folgenden Feldern des bands-Wörterbuchelements.
bands[i].id
string
Die ID (Name) des Bandes.
bands[i].tilesetId
string
Die ID des Tilesets, das dem Band entspricht.
bands[i].tilesetBandIndex
int32
Der nullbasierte Bandindex aus dem Tileset, das dem Band entspricht.
bands[i].missingData.values
list
Eine Liste von Werten (Typ „Double“), die keine Daten im Band darstellen.
bands[i].pyramidingPolicy
string
Die Pyramidenrichtlinie. Weitere Informationen Zu den Optionen gehören:
- „MEAN“ (Standard)
- „MODE“
- "SAMPLE"
maskBands
list
Eine Liste von Wörterbüchern, die die Eigenschaften eines einzelnen Maskenbands aus einem Tileset definieren.
Es darf maximal ein Maskenband angegeben werden.
Weitere Informationen finden Sie in den folgenden Feldern des maskBands-Wörterbuchelements.
maskBands[i].tilesetId
string
Die ID des Tilesets, das dem Maskenband entspricht. Das letzte Band des Tilesets wird immer als Maskenband verwendet.
maskBands[i].bandIds
list of strings
Liste der IDs von Bändern, auf die das Maskenband angewendet wird. Wenn das Feld leer ist, wird das Maskenband auf alle Bänder im Asset angewendet. Jedes Band darf nur ein entsprechendes Maskenband haben.
footprint
dictionary
Ein Dictionary, das die Eigenschaften der Grundfläche aller gültigen Pixel in einem Bild definiert.
Wenn dieses Feld leer ist, wird das gesamte Bild als Standard-Footprint verwendet. Weitere Informationen finden Sie in den folgenden footprint-Wörterbuchelementfeldern.
footprint.points
list
Eine Liste von Punkten, die die Grundfläche aller gültigen Pixel in einem Bild definieren. Ein Punkt wird durch ein Wörterbuch mit den Schlüsseln „x“ und „y“ definiert, die Gleitkommawerte haben. Eine Liste von Punkten, die einen Ring beschreiben, der die Außenseite eines einfachen Polygons bildet, das die Mittelpunkte aller gültigen Pixel des Bildes enthalten muss. Dies muss ein linearer Ring sein: Der letzte Punkt muss mit dem ersten übereinstimmen. Die Koordinaten befinden sich in der Projektion des durch bandId angegebenen Bands.
Hinweis: Verwenden Sie nicht ganzzahlige Koordinaten wie die Mitte jedes Pixels, da footprint ein Pixel enthält, wenn das Pixel (ein 1 × 1-Rechteck) die Grundfläche schneidet. Verwenden Sie keine ganzzahligen Koordinaten, da diese die Grenzen zwischen Pixeln darstellen. So vermeiden Sie, dass versehentlich benachbarte Pixel ausgewählt werden. Wenn Sie die Grundfläche entlang der Pixelmitten zeichnen, werden keine unbeabsichtigten Pixel einbezogen. Das kann zu Fehlern führen, wenn die beabsichtigten Pixel an eine Kartengrenze wie den Antimeridian oder einen Pol angrenzen.
Für ein 2x2-Bild mit allen vier gültigen Pixeln ist beispielsweise der folgende Ring möglich:
[
{
"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
}
]footprint.bandId
string
Die ID des Bands, dessen KBS die Koordinaten des Footprints definiert. Wenn leer, wird das erste Band verwendet.
missingData.values
list
Eine Liste von Werten (Typ „double“), die in allen Bändern des Bildes keine Daten darstellen. Gilt für alle Bänder, für die kein eigenes missingData angegeben ist.
pyramidingPolicy
string
Die Pyramidenrichtlinie. Wenn nicht angegeben, wird standardmäßig die Richtlinie „MEAN“ angewendet. Gilt für alle Bänder, für die keine eigene Strategie angegeben ist. Weitere Informationen Zu den Optionen gehören:
- „MEAN“ (Standard)
- „MODE“
- "SAMPLE"
uriPrefix
string
Ein optionales Präfix, das allen im Manifest definierten uris vorangestellt wird.
startTime
integer
Der mit dem Asset verknüpfte Zeitstempel, falls vorhanden. Dies entspricht in der Regel dem Zeitpunkt, zu dem ein Satellitenbild aufgenommen wurde. Bei Assets, die einem Zeitintervall entsprechen, z. B. Durchschnittswerte über einen Monat oder ein Jahr, entspricht dieser Zeitstempel dem Beginn dieses Intervalls. Wird in Sekunden und (optional) Nanosekunden seit der Epoche (01.01.1970) angegeben. Es wird davon ausgegangen, dass die UTC-Zeitzone verwendet wird.
endTime
integer
Bei Assets, die einem Zeitintervall entsprechen, z. B. Durchschnittswerte über einen Monat oder ein Jahr, entspricht dieser Zeitstempel dem Ende dieses Intervalls (exklusiv). Wird in Sekunden und (optional) Nanosekunden seit der Epoche (01.01.1970) angegeben. Es wird davon ausgegangen, dass die UTC-Zeitzone verwendet wird.
Properties
dictionary
Ein beliebiges flaches Dictionary mit Schlüssel/Wert-Paaren. Schlüssel müssen Strings sein und Werte können entweder Zahlen oder Strings sein. Listenwerte werden für von Nutzern hochgeladene Assets noch nicht unterstützt.
Beschränkungen
Größe des JSON-Manifests
Die maximale Größe der JSON-Manifestdatei beträgt 10 MB. Wenn Sie viele Dateien hochladen müssen, sollten Sie überlegen, wie Sie die Anzahl der Zeichen reduzieren können, die zur Beschreibung des Datasets erforderlich sind. Verwenden Sie beispielsweise das Feld uriPrefix, um den Google Cloud-Bucket-Pfad für jeden URI in der Liste uris nicht angeben zu müssen. Wenn die Größe weiter reduziert werden muss, versuchen Sie, die Dateinamen zu kürzen.
Bilddateiformat
Jede Bilddatei muss ein TIFF-Bild sein. Wenn das CRS nicht im Manifest angegeben ist, muss die Datei ein GeoTIFF mit einem eingebetteten CRS sein.
TIFF-Dateien können mit DEFLATE, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP oder ZSTD komprimiert werden.
Empfehlungen für das Hochladen großer Dateien:
- Beste Wahl: ZSTD bietet ein gutes Gleichgewicht zwischen Geschwindigkeit und Komprimierung.
- Vermeiden: LZMA kann trotz guter Komprimierung sehr langsam sein.
- Unkomprimierte Dateien: Dies führt zu größeren Dateien und längeren Uploadzeiten.
- Verlustbehaftete Komprimierung (z.B. JPEG): Pixelwerte können sich ändern. Verwenden Sie eine verlustfreie Komprimierung (z.B. DEFLATE, LZMA, LZW, ZSTD), es sei denn, Sie kennen die potenziellen Auswirkungen auf Ihre Daten.