Przesyłanie pliku manifestu obrazu

Jeśli potrzebujesz większej elastyczności podczas przesyłania obrazów do Google Earth Engine (EE) niż ta, którą zapewnia interfejs edytora kodu lub polecenie upload narzędzia wiersza poleceń „earthengine”, możesz opisać przesyłanie obrazu za pomocą pliku JSON, który jest nazywany „plikiem manifestu”, i użyć polecenia upload image --manifest narzędzia wiersza poleceń.

Pełny przykład znajdziesz w tym notatniku Colab, który pokazuje, jak przesłać kafelki obrazu jako pojedynczy zasób za pomocą pliku manifestu.

Konfiguracja jednorazowa

  1. Przesyłanie plików manifestu działa tylko w przypadku plików znajdujących się w Google Cloud Storage. Aby zacząć korzystać z Google Cloud Storage, utwórz projekt Google Cloud, jeśli jeszcze go nie masz. Pamiętaj, że konfiguracja wymaga podania karty kredytowej do celów rozliczeniowych. Samo EE nie pobiera obecnie żadnych opłat, ale przenoszenie plików do Google Cloud Storage przed przesłaniem ich do EE wiąże się z niewielkimi kosztami. W przypadku typowych rozmiarów przesyłanych danych (dziesiątki lub setki gigabajtów) koszt będzie dość niski.
  2. W projekcie włącz interfejs Cloud Storage API i utwórz zasobnik.
  3. Zainstaluj klienta Earth Engine w Pythonie. Zawiera on narzędzie wiersza poleceń earthengine, którego użyjemy do przesłania danych.
  4. W przypadku automatycznego przesyłania możesz użyć konta usługi Google Cloud powiązanego z Twoim projektem. Do testowania nie potrzebujesz konta usługi, ale gdy będziesz mieć chwilę, zapoznaj się z informacjami o tym, jak z niego korzystać.

Bardzo duże pliki źródłowe (100 GB lub więcej) mogą być przesyłane szybciej, jeśli zostaną podzielone na kilka kafelków.

identyfikatory i nazwy zasobów,

W przypadku zasobów należących do projektu w chmurze używaj tej konwencji nazw zasobów: projects/some-project-id/assets/some-asset-id.

Więcej informacji o nazwach zasobów w przypadku starszych projektów i zasobów należących do użytkowników

W przypadku starszych projektów nazwa zasobu w pliku manifestu musi się nieco różnić od identyfikatora zasobu widocznego w innych miejscach w Earth Engine. Aby przesłać zasoby, których identyfikatory zasobów zaczynają się od users/some_user lub projects/some_project, nazwa zasobu w pliku manifestu musi zawierać ciąg projects/earthengine-legacy/assets/ dodany przed identyfikatorem. Na przykład identyfikator zasobu EE users/username/my_geotiff należy przesłać pod nazwą projects/earthengine-legacy/assets/users/username/my_geotiff.

Tak, oznacza to, że identyfikatory takie jak projects/some_projects/some_asset są konwertowane na nazwy, w których projects jest wymienione dwukrotnie: projects/earthengine-legacy/assets/projects/some_projects/some_asset. Może to być mylące, ale jest konieczne, aby zachować zgodność ze standardami interfejsu Google Cloud API.

Korzystanie z plików manifestu

Podstawowy plik manifestu jest widoczny w poniższym bloku kodu. Przesyła plik o nazwie small.tif z zasobnika Google Cloud Storage o nazwie gs://earthengine-test.

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://earthengine-test/small.tif"
          ]
        }
      ]
    }
  ]
}

Aby go użyć, zapisz go w pliku o nazwie manifest.json i uruchom:

earthengine upload image --manifest /path/to/manifest.json

(Plik gs://earthengine-test/small.tif istnieje i jest publicznie dostępny do odczytu – możesz go użyć do testowania).

Zbiory kafelków

Nieco skomplikowana struktura pliku manifestu JSON jest konieczna, aby zapewnić wystarczającą elastyczność w rozwiązywaniu typowego problemu z przesyłaniem: jak opisać wszystkie możliwe sposoby łączenia pikseli z wielu plików źródłowych w jeden zasób. Istnieją 2 niezależne sposoby grupowania plików:

  • Mozaiki. Czasami wiele plików reprezentuje wiele kafelków (na przykład każdy kafelek to kwadrat o wymiarach 1 x 1 stopień). Takie pliki muszą zostać połączone (scalone) w to samo pasmo w zasobie EE.
  • Oddzielne pasma. Czasami kilka plików reprezentuje kilka pasm. Such files must be stacked together as bands in an EE asset.

(Może się zdarzyć, że trzeba będzie użyć obu sposobów jednocześnie, ale jest to rzadka sytuacja).

Aby opisać te opcje, pliki manifestu wprowadzają pojęcie zestawu kafelków. Pojedynczy zbiór kafelków odpowiada pojedynczemu źródłu GDAL. Z tego powodu wszystkie źródła w jednym zbiorze kafelków muszą mieć tę samą strukturę GDAL (liczbę i typ pasm, projekcję, transformację, brakującą wartość). Źródło GDAL może mieć wiele zakresów, więc jeden zbiór kafelków może zawierać dane dla wielu zakresów EE.

W przypadku przetwarzania mozaikowego plik manifestu będzie wyglądać tak:

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/N30W22.tif"
          ]
        },
        {
          "uris": [
            "gs://bucket/N31W22.tif"
          ]
        }
      ]
    }
  ]
}

W przypadku oddzielnych pasm plik manifestu będzie wyglądał tak (musisz też dodać sekcję bands, jak wyjaśniono poniżej):

{
  "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"
          ]
        }
      ]
    }
  ]
}

Pamiętaj, że w przypadku oddzielnych pasm musimy nadać każdemu zbiorowi kafelków inny identyfikator, w celu uniknięcia wątpliwości. Identyfikator zbioru kafelków może być dowolnym ciągiem znaków – te ciągi nie są przechowywane w przesłanym zasobie. Identyfikatory zbiorów kafelków są używane tylko podczas pozyskiwania, aby odróżnić od siebie zbiory kafelków ułożone w stos.

Pasma

Drugą ważną koncepcją jest dopasowywanie plików źródłowych do pasm zasobów EE. Można to zrobić w sekcji bands pliku manifestu.

Sekcję bands można pominąć. W takim przypadku pasma są tworzone najpierw z plików w pierwszym zbiorze kafelków, potem z następnego zbioru kafelków itd. Domyślnie pasma mają nazwy „b1”, „b2” itd. Aby zastąpić domyślne nazwy pasm, na końcu dodaj sekcję „bands”, na przykład:

{
  "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
    }
  ]
}

Liczba pasm EE musi być taka sama jak łączna liczba pasm we wszystkich zbiorach kafelków.

Jeśli nie chcesz przetwarzać wszystkich pasm z pliku, możesz użyć pola tilesetBandIndex, aby wskazać, które pasma GDAL mają zostać przetworzone. Pierwsze pasmo ma tilesetBandIndex o wartości 0.

Przykład:

Załóżmy, że plik źródłowy ma 4 pasma: „tmin”, „tmin_error”, „tmax”, „tmax_error”. Chcemy pozyskać tylko „tmin” i „tmax”. Odpowiednie sekcje pliku manifestu będą wyglądać tak:

{
  "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"
    }
  ]
}

Paski maski

Maskowanie pasm jest kontrolowane przez komponent maskBands pliku manifestu. Obsługiwane są 3 możliwe konfiguracje masek (ale zawsze zakłada się, że pasmo maski jest ostatnim pasmem w określonym pliku).

  1. Maska dla wszystkich pasm danych w tym samym pliku.
  2. Maska dla wszystkich pasm danych pochodzących ze wszystkich pozostałych plików.
  3. Maska dla niektórych pasm danych.

1. Najczęstszym przypadkiem jest pojedynczy plik GeoTIFF, którego ostatnie pasmo jest używane jako maska dla pozostałych pasm. Działa to tylko w przypadku plików GeoTIFF typu Byte. Użyj tego pliku manifestu:

{
  "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. Aby użyć maski GeoTIFF jako maski dla wszystkich pasm w innym pliku GeoTIFF, użyj tego pliku manifestu:

{
  "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. Aby użyć pliku GeoTIFF jako maski dla określonego pasma w innym pliku, użyj tego pliku manifestu (różnica w porównaniu z poprzednim przypadkiem polega na tym, że pole bandIds w maskBands jest ustawione):

{
  "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"]
    }
  ]
}

W ostatnim przykładzie pracujemy z 2 pasmami ze zbioru kafelków data_tileset, ale stosujemy maskę tylko do jednego z nich (data_band), zgodnie z polem bandIds jedynego podanego obiektu listy maskBands.

Pamiętaj, że jako pasmo maski używane jest tylko ostatnie pasmo zbioru kafelków wymienionego w maskBands.

Zasady dotyczące piramid finansowych

Gdy Earth Engine tworzy piramidy obrazów podczas pozyskiwania, musi wielokrotnie zmniejszać siatki 2 x 2 piksele do pojedynczego piksela, przekształcając w jakiś sposób wartość piksela. Domyślnie wartości pikseli są uśredniane, co jest właściwym rozwiązaniem w większości przypadków, gdy pasmo rastrowe reprezentuje mniej więcej ciągłe dane. Istnieją jednak 2 sytuacje, w których poleganie na wartości domyślnej da nieprawidłowe wyniki. W takich przypadkach należy ustawić pole pyramidingPolicy w definicji pasma (jeśli nie jest ustawione, domyślnie przyjmuje wartość „MEAN”).

W przypadku klasyfikacji obrazów rastrowych (np. klasyfikacji pokrycia terenu) najbardziej logicznym sposobem tworzenia piramidy pikseli jest wykorzystanie większości z 4 wartości do wygenerowania kolejnej. Można to zrobić za pomocą zasady piramidy „MODE”:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/landcover.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "landcover",
      "pyramidingPolicy": "MODE"
    }
  ]
}

W przypadku pasm rastrowych, w których nie ma sensu używać wartości „MEAN” ani „MODE” (np. pikseli spakowanych bitowo), należy użyć zasady piramidy „SAMPLE”. „SAMPLE” zawsze przyjmuje wartość piksela w lewym górnym rogu każdej siatki 2 x 2. W poniższym przykładzie pasmu reprezentującemu zmienną ciągłą („NDVI”) przypisano zasadę piramidy „MEAN”, a pasmu „QA” danych – zasadę „SAMPLE”.

{
  "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"
    }
  ]
}

Czas rozpoczęcia i zakończenia

Wszystkie zasoby powinny mieć określony czas rozpoczęcia i zakończenia, aby zapewnić więcej kontekstu dla danych, zwłaszcza jeśli są one zawarte w kolekcjach. Te pola nie są wymagane, ale zdecydowanie zalecamy ich używanie, gdy tylko jest to możliwe.

Czas rozpoczęcia i zakończenia zwykle oznacza czas obserwacji, a nie czas utworzenia pliku źródłowego.

Dla uproszczenia czas zakończenia jest traktowany jako granica wykluczająca. Na przykład w przypadku zasobów obejmujących dokładnie 1 dzień jako czas rozpoczęcia i zakończenia użyj północy 2 kolejnych dni (np. 1980-01-31T00:00:00 i 1980-02-01T00:00:00). Jeśli zasób nie ma czasu trwania, ustaw czas zakończenia taki sam jak czas rozpoczęcia. Przedstawiaj godziny w plikach manifestu jako ciągi znaków ISO 8601. Aby uprościć wartości dat, zalecamy założenie, że czas zakończenia jest wykluczony (np. północ następnego dnia w przypadku zasobów dziennych).

Przykład:

{
  "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"
}

Informacje o strukturze pliku manifestu

Poniższa struktura JSON zawiera wszystkie możliwe pola manifestu przesyłania obrazu. Definicje pól znajdziesz w sekcji Definicje pól pliku manifestu poniżej.

{
  "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>
  }
}

Definicje pól pliku manifestu

nazwa

string

Nazwa zasobu, który ma zostać utworzony. name ma format „projects/*/assets/**” (np. „projects/earthengine-legacy/assets/users/USER/ASSET”).

tilesets

list

Lista słowników definiujących właściwości zbiorów kafelków. Więcej informacji znajdziesz w tych polach elementu słownika tilesets.

tilesets[i].dataType

string

Określa numeryczny typ danych. Domyślny typ to ten, który zgłasza GDAL. W takim przypadku nie trzeba go definiować.

Typ danych Wartość
Nie określono "DATA_TYPE_UNSPECIFIED"
8-bitowa liczba całkowita ze znakiem "INT8"
8-bitowa liczba całkowita bez znaku "UINT8"
16-bitowa liczba całkowita ze znakiem "INT16"
16-bitowa liczba całkowita bez znaku "UINT16"
32-bitowa liczba całkowita ze znakiem "INT32"
32-bitowa liczba całkowita bez znaku "UINT32"
32-bitowy format zmiennoprzecinkowy "FLOAT32"
64-bitowa liczba zmiennoprzecinkowa "FLOAT64"

tilesets[i].id

string

Identyfikator zbioru kafelków. Musi być unikalny wśród zbiorów kafelków określonych w pliku manifestu zasobu. Ten identyfikator jest odrzucany podczas przetwarzania. Służy on tylko do łączenia zbioru kafelków z pasmem. Pusty ciąg znaków jest prawidłowym identyfikatorem.

tilesets[i].crs

string

Układ współrzędnych siatki pikseli, określony w miarę możliwości jako standardowy kod (np. kod EPSG), a w przeciwnym razie w formacie WKT.

tilesets[i].sources

list

Lista słowników definiujących właściwości pliku graficznego i jego plików pomocniczych. Więcej informacji znajdziesz w tych polach elementu słownika sources.

tilesets[i].sources[j].uris

list

Lista identyfikatorów URI danych do pozyskania. Obsługiwane są tylko identyfikatory URI obiektów w Google Cloud Storage. Każdy identyfikator URI musi być podany w tym formacie: gs://bucket-id/object-id. Obiekt główny powinien być pierwszym elementem listy, a obiekty dodatkowe powinny być wymienione po nim. Każdy identyfikator URI jest poprzedzony prefiksem ImageManifest.uriPrefix, jeśli jest ustawiony.

tilesets[i].sources[j].affineTransform

dictionary

Opcjonalne przekształcenie afiniczne. Należy go podać tylko wtedy, gdy dane z uris (w tym z plików pomocniczych) nie wystarczają do umieszczenia pikseli. Podawany jako słownik z tymi kluczami: „scaleX”, „shearX”, „translateX”, „shearY”, „scaleY”, „translateY”. Więcej informacji znajdziesz w tym artykule.

Przykładowe klucze i wartości:

{
  "scaleX": 0.1,
  "shearX": 0.0,
  "translateX": -180.0,
  "shearY": 0.0,
  "scaleY": -0.1,
  "translateY": 90.0
}

zespoły

list

Lista słowników definiujących właściwości pojedynczego pasma pochodzącego ze zbioru kafelków. Zwróć uwagę, że kolejność pasm zasobu jest taka sama jak kolejność bands. Więcej informacji znajdziesz w tych polach elementu słownika bands.

bands[i].id

string

Identyfikator (nazwa) zespołu.

bands[i].tilesetId

string

Identyfikator zbioru kafelków odpowiadającego pasmu.

bands[i].tilesetBandIndex

int32

Indeks pasma rozpoczynający się od 0 ze zbioru kafelków odpowiadającego pasmu.

bands[i].missingData.values

list

Lista wartości (typu double), które reprezentują brak danych w paśmie.

bands[i].pyramidingPolicy

string

Zasady dotyczące piramid finansowych. Więcej informacji znajdziesz tutaj. Dostępne opcje:

  • „MEAN” (domyślna),
  • "MODE"
  • "SAMPLE"

maskBands

list

Lista słowników definiujących właściwości pojedynczego pasma maski pochodzącego ze zbioru kafelków. Można podać maksymalnie 1 pasmo maski. Więcej informacji znajdziesz w tych polach elementu słownika maskBands.

maskBands[i].tilesetId

string

Identyfikator zbioru kafelków odpowiadającego pasmu maski. Ostatnie pasmo zbioru kafelków jest zawsze używane jako pasmo maski.

maskBands[i].bandIds

list of strings

Lista identyfikatorów pasm, do których ma zastosowanie pasmo maski. Jeśli to pole jest puste, pasmo maski jest stosowane do wszystkich pasm w zasobie. Każde pasmo może mieć tylko 1 odpowiadające mu pasmo maski.

ślad stopy

dictionary

Słownik definiujący właściwości obszaru wszystkich prawidłowych pikseli na obrazie. Jeśli to pole jest puste, domyślnym obszarem jest cały obraz. Więcej informacji znajdziesz w tych polach elementu słownika footprint.

footprint.points

list

Lista punktów definiujących obszar wszystkich prawidłowych pikseli na obrazie. Punkt jest definiowany przez słownik z kluczami „x” i „y” o wartościach zmiennoprzecinkowych. Lista punktów opisuje pierścień, który tworzy zewnętrzną część prostego wielokąta, który musi zawierać środki wszystkich prawidłowych pikseli obrazu. Musi to być pierścień liniowy: ostatni punkt musi być taki sam jak pierwszy. Współrzędne są w projekcji pasma określonego przez bandId.

Uwaga: używaj współrzędnych niecałkowitych, takich jak środek każdego piksela, ponieważ footprint jest traktowany jako zawierający piksel, jeśli piksel (prostokąt 1 x 1) przecina się z obszarem. Aby uniknąć przypadkowego wybrania sąsiednich pikseli, nie używaj współrzędnych o wartościach całkowitych, ponieważ są to granice między pikselami. Rysowanie obrysu wzdłuż środków pikseli zapobiega uwzględnianiu niezamierzonych pikseli, co może powodować błędy, gdy zamierzone piksele przylegają do granicy mapy, takiej jak antymerydian lub biegun.

Na przykład w przypadku obrazu 2 x 2 ze wszystkimi 4 prawidłowymi pikselami jeden z możliwych pierścieni wygląda tak:

[
  {
    "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

Identyfikator pasma, którego układ CRS definiuje współrzędne odbicia. Jeśli pole jest puste, używane jest pierwsze pasmo.

missingData.values

list

Lista wartości (typu double), które reprezentują brak danych we wszystkich pasmach obrazu. Dotyczy wszystkich pasm, które nie określają własnego missingData.

pyramidingPolicy

string

Zasady dotyczące piramid finansowych. Jeśli nie zostanie określona, domyślnie stosowana jest zasada „MEAN”. Dotyczy wszystkich pasm, które nie mają własnych ustawień. Więcej informacji znajdziesz tutaj. Dostępne opcje:

  • „MEAN” (domyślna),
  • "MODE"
  • "SAMPLE"

uriPrefix

string

Opcjonalny prefiks dodawany do wszystkich elementów uris zdefiniowanych w pliku manifestu.

startTime

integer

Sygnatura czasowa powiązana z zasobem (jeśli jest dostępna). Zwykle odpowiada to czasowi, w którym zostało zrobione zdjęcie satelitarne. W przypadku zasobów, które odpowiadają przedziałowi czasu, np. średnim wartościom z miesiąca lub roku, ta sygnatura czasowa odpowiada początkowi tego przedziału. Podawany w sekundach i (opcjonalnie) nanosekundach od początku epoki (1970-01-01). Przyjmuje się, że jest to strefa czasowa UTC.

endTime

integer

W przypadku zasobów, które odpowiadają przedziałowi czasu, np. średnim wartościom w ciągu miesiąca lub roku, ta sygnatura czasowa odpowiada końcowi tego przedziału (bez uwzględniania go). Podawany w sekundach i (opcjonalnie) nanosekundach od początku epoki (1970-01-01). Przyjmuje się, że jest to strefa czasowa UTC.

właściwości

dictionary

Dowolny słownik par klucz-wartość. Klucze muszą być ciągami znaków, a wartości mogą być liczbami lub ciągami znaków. Wartości list nie są jeszcze obsługiwane w przypadku zasobów przesłanych przez użytkowników.

Ograniczenia

Rozmiar pliku manifestu JSON

Maksymalny rozmiar pliku manifestu JSON to 10 MB. Jeśli masz wiele plików do przesłania, zastanów się, jak zmniejszyć liczbę znaków potrzebnych do opisania zbioru danych. Możesz na przykład użyć pola uriPrefix, aby nie trzeba było podawać ścieżki zasobnika Google Cloud dla każdego identyfikatora URI na liście uris. Jeśli konieczne jest dalsze zmniejszenie rozmiaru, spróbuj skrócić nazwy plików.

Format pliku graficznego

Każdy plik graficzny musi być obrazem TIFF. Jeśli w pliku manifestu nie określono układu współrzędnych, plik musi być plikiem GeoTIFF z osadzonym układem współrzędnych.

Pliki TIFF można kompresować za pomocą DEFLATE, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP lub ZSTD.

Zalecenia dotyczące przesyłania dużych plików:

  • Najlepszy wybór: ZSTD zapewnia dobrą równowagę między szybkością a kompresją.
  • Unikaj: LZMA może działać bardzo wolno mimo dobrej kompresji.
  • Nieskompresowane pliki: będą większe i będą się dłużej przesyłać.
  • Kompresja stratna (np. JPEG): może zmieniać wartości pikseli. Używaj kompresji bezstratnej (np. DEFLATE, LZMA, LZW, ZSTD), chyba że rozumiesz potencjalny wpływ na dane.