"Küçük resim" resmi oluşturmak için kullanılabilecek bir kimlik oluşturur.
Bu özellik GetThumbnailPixels ile birlikte kullanılır. thumbnails.create çağrısı, bir ifade ve bazı çıkış seçenekleri sağlar. thumbnails.create sonucu, bu ifadenin değerlendirilmesi ve bu seçeneklerin uygulanmasının sonucu olan bir resmi temsil eden bir kimliktir. Ardından, elde edilen görüntünün tamamının resim verilerini almak için GetThumbnailPixels çağrısı yapılabilir. Kimlik, orta düzeyde bir süre (birkaç saat) boyunca geçerli olur.
Bu uç nokta çiftinin en yaygın kullanım alanı, thumbnails.create adresine POST aracılığıyla karmaşık bir ifade sağlamak ve ardından hesaplanan resmi GetThumbnailPixels adresine GET aracılığıyla almaktır. İki bölümden oluşan bu işlem, ComputePixels'ten daha fazla durumda kullanılabilir. Özellikle: - Kodlanmış resim baytlarını almak için ComputePixels sonucunun sarmalanması gerekir. GetThumbnailPixels sonucu doğrudan bir tarayıcı tarafından görüntülenebilir. - ComputePixels yalnızca yetkili bir kullanıcı tarafından, uygun kapsamlı bir OAuth jetonu kullanılarak çağrılabilir. thumbnails.create aynı kısıtlamaya sahiptir ancak GetThumbnailPixels, API anahtarı içeren bir URL ile çağrılabilir. Bu nedenle, bu işlevi çağıran URL'ler daha geniş bir şekilde kullanılabilir.
İfadenin değerlendirilmesinin sonucu, istenen resim biçimiyle ilgili bazı makul koşulları karşılamalıdır. Özellikle JPEG veya PNG biçiminde bir veya üç çıkış bandı olması ve 0-255 aralığının dışındaki değerlerin kırpılması gerekir.
"Küçük resim" açıklaması, hesaplanan resmin boyutuyla ilgili bir kısıtlama anlamına gelmez: ComputePixels ile aynı kısıtlamalar thumbnails.create/GetThumbnailPixels için de geçerlidir. İstekler, istek başına sıkıştırılmamış veri olarak 48 MB ile sınırlıdır. Bu değer, istek boyutlarının piksel cinsinden çarpımı, istenen resim bantlarının sayısı ve her bant için piksel başına bayt sayısı olarak hesaplanır. İstekler, her iki boyutta da en fazla 32.000 piksel ve en fazla 1.024 bantla sınırlıdır. Bu sınırları aşan istekler 400 (BAD_REQUEST) hata koduyla sonuçlanır.
HTTP isteği
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/thumbnails
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler | |
|---|---|
parent |
Zorunlu. Küçük resim koleksiyonunun üst öğesi (ör. "projects/*"). Yetkilendirme, belirtilen kaynak
|
Sorgu parametreleri
| Parametreler | |
|---|---|
workloadTag |
Bu hesaplamayı izlemek için kullanıcı tarafından sağlanan etiket. |
İstek içeriği
İstek metni, Thumbnail öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılı olursa yanıt metni, yeni oluşturulmuş bir Thumbnail örneği içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
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
Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.