Tworzy identyfikator, który można wykorzystać do renderowania obrazu „miniatura”.
Jest on używany w połączeniu z atrybutem GetThumbnailPixels. Wywołanie funkcji thumbnails.create udostępnia wyrażenie i niektóre opcje wyjścia. Wynik funkcji thumbnails.create to identyfikator, który reprezentuje obraz będący wynikiem oceny tego wyrażenia i zastosowania tych opcji. Następnie można wywołać metodę GetThumbnailPixels, aby uzyskać dane obrazu dla całego wynikowego obrazu. Dokument tożsamości będzie ważny przez pewien czas (kilka godzin).
Najczęstszym zastosowaniem tej pary punktów końcowych jest podanie złożonego wyrażenia za pomocą metody POST na adres thumbnails.create, a następnie pobranie obliczonych obrazów za pomocą metody GET na adres GetThumbnailPixels. Ten dwuetapowy proces pozwala na wykorzystanie w większej liczbie sytuacji niż ComputePixels. W szczególności: – wynik funkcji ComputePixels musi zostać odwinięty, aby uzyskać zakodowane bajty obrazu. Wynik funkcji GetThumbnailPixels może być wyświetlany bezpośrednio przez przeglądarkę. – ComputePixels może wywołać tylko autoryzowany użytkownik, używając tokena OAuth o odpowiednim zakresie. thumbnails.create ma takie samo ograniczenie, ale GetThumbnailPixels może być wywoływany za pomocą adresu URL zawierającego klucz interfejsu API, więc adresy URL wywołujące tę funkcję mogą być używane szerzej.
Wynik oceny wyrażenia musi spełniać określone wymagania dotyczące żądanego formatu obrazu. W szczególności formaty JPEG lub PNG wymagają 1 lub 3 pasm wyjściowych oraz wartości przycinania, które wykraczają poza zakres 0–255.
Opis „miniatura” nie oznacza ograniczenia rozmiaru obliczonych obrazów: do thumbnails.create/GetThumbnailPixels mają zastosowanie te same ograniczenia co do ComputePixels. Żądania są ograniczone do 48 MB nieskompresowanych danych na żądanie, obliczanych jako iloczyn wymiarów żądania w pikselach, liczby żądanych pasm obrazu i liczby bajtów na piksel dla każdego pasma. Żądania są też ograniczone do maksymalnie 32 tys. pikseli w każdym wymiarze i maksymalnie 1024 pasm. Żądania przekraczające te limity będą skutkować kodem błędu 400 (BAD_REQUEST).
Żądanie HTTP
POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/thumbnails
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry | |
|---|---|
parent |
Wymagany. Nadrzędny element kolekcji miniatur (np. „projects/*)”. Autoryzacja wymaga tych uprawnień IAM w przypadku określonego zasobu:
|
Parametry zapytania
| Parametry | |
|---|---|
workloadTag |
Tag dostarczony przez użytkownika do śledzenia tego obliczenia. |
Treść żądania
Treść żądania zawiera wystąpienie elementu Thumbnail.
Treść odpowiedzi
Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję Thumbnail.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/earthengine.readonlyhttps://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/cloud-platform.read-only
Więcej informacji znajdziesz w OAuth 2.0 Overview.