Membuat ID yang dapat digunakan untuk merender gambar "thumbnail".
Ini digunakan bersama dengan thumbnails.getPixels. Panggilan ke thumbnails.create memberikan ekspresi dan beberapa opsi output. Hasil thumbnails.create adalah ID yang mewakili gambar yang merupakan hasil dari mengevaluasi ekspresi tersebut dan menerapkan opsi tersebut. Selanjutnya, panggilan ke thumbnails.getPixels dapat dilakukan untuk mendapatkan data gambar untuk seluruh gambar yang dihasilkan. ID akan berlaku selama jangka waktu sedang (beberapa jam).
Kasus penggunaan yang paling umum untuk pasangan endpoint ini adalah memberikan ekspresi kompleks melalui POST ke thumbnails.create, lalu mengambil gambar yang dikomputasi melalui GET ke thumbnails.getPixels. Proses dua bagian ini memungkinkan penggunaan dalam lebih banyak situasi daripada ComputePixels. Secara khusus: - hasil ComputePixels perlu di-unwrapping untuk mendapatkan byte gambar yang dienkode. Hasil thumbnails.getPixels dapat ditampilkan langsung oleh browser. - ComputePixels hanya dapat dipanggil oleh pengguna yang diotorisasi, menggunakan token OAuth dengan cakupan yang tepat. thumbnails.create memiliki batasan yang sama, tetapi thumbnails.getPixels dapat dipanggil dengan URL yang berisi kunci API, sehingga URL yang memanggilnya dapat digunakan secara lebih luas.
Hasil evaluasi ekspresi harus memenuhi beberapa persyaratan yang wajar untuk format gambar yang diminta. Secara khusus, format JPEG atau PNG mengharuskan adanya satu atau tiga band output, dan memotong nilai yang berada di luar rentang 0-255.
Deskripsi "thumbnail" tidak menyiratkan batasan pada ukuran gambar yang dihitung: batasan yang sama seperti ComputePixels berlaku untuk thumbnails.create/thumbnails.getPixels. Permintaan dibatasi hingga 48 MB dalam data yang tidak dikompresi per permintaan, yang dihitung sebagai produk dari dimensi permintaan dalam piksel, jumlah band gambar yang diminta, dan jumlah byte per piksel untuk setiap band. Permintaan juga dibatasi maksimal 32K piksel di salah satu dimensi dan maksimal 1024 band. Permintaan yang melebihi batas ini akan menghasilkan kode error 400 (BAD_REQUEST).
Permintaan HTTP
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*}/thumbnails
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter | |
|---|---|
parent |
Wajib. Induk koleksi thumbnail (misalnya, "projects/*"). Otorisasi memerlukan izin IAM berikut pada resource
|
Parameter kueri
| Parameter | |
|---|---|
workloadTag |
Tag yang diberikan pengguna untuk melacak komputasi ini. |
Isi permintaan
Isi permintaan memuat instance Thumbnail.
Isi respons
Jika berhasil, isi respons memuat instance Thumbnail yang baru dibuat.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
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
Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.