Method: projects.thumbnails.create

شناسه‌ای ایجاد می‌کند که می‌توان از آن برای ارائه یک تصویر "تصویر کوچک" استفاده کرد.

این در ارتباط با thumbnails.getPixels استفاده می شود. فراخوانی به thumbnails.create یک عبارت و برخی گزینه های خروجی را ارائه می دهد. نتیجه thumbnails.create یک شناسه است که تصویری را نشان می‌دهد که نتیجه ارزیابی آن عبارت و اعمال آن گزینه‌ها است. متعاقباً، می‌توان با thumbnails.getPixels تماس گرفت تا داده‌های تصویر را برای کل تصویر حاصل به دست آورد. شناسه برای یک دوره متوسط ​​(چند ساعت) معتبر خواهد بود.

رایج ترین مورد استفاده برای این جفت نقطه پایانی ارائه یک عبارت پیچیده از طریق یک POST برای thumbnails.create و سپس واکشی تصویر محاسبه شده از طریق یک GET به thumbnails.getPixels است. این فرآیند دو قسمتی امکان استفاده در موقعیت‌های بیشتری را نسبت به ComputePixels فراهم می‌کند. به طور خاص: - نتیجه ComputePixels باید باز شود تا بایت های تصویر کدگذاری شده به دست آید. نتیجه thumbnails.getPixels را می توان مستقیماً توسط مرورگر نمایش داد. - ComputePixels فقط می توان توسط یک کاربر مجاز با استفاده از یک نشانه OAuth با محدوده مناسب فراخوانی کرد. thumbnails.create همین محدودیت را دارد، اما thumbnails.getPixels می‌توان با یک URL حاوی یک کلید API فراخوانی کرد، بنابراین URLهایی که آن را فراخوانی می‌کنند می‌توانند به طور گسترده‌تری استفاده شوند.

نتیجه ارزیابی عبارت باید برخی از الزامات معقول را برای قالب تصویر درخواستی برآورده کند. به طور خاص، فرمت JPEG یا PNG مستلزم آن است که یک یا سه باند خروجی وجود داشته باشد، و مقادیری را که خارج از محدوده 0-255 هستند، کلیپ کند.

توصیف "تصویر کوچک" به معنای محدودیت در اندازه تصویر محاسبه شده نیست: همان محدودیت هایی که ComputePixels برای thumbnails.create / thumbnails.getPixels اعمال می شود. درخواست‌ها به 48 مگابایت در داده‌های فشرده‌نشده در هر درخواست محدود می‌شوند که به‌عنوان حاصل ضرب ابعاد درخواست در پیکسل، تعداد باندهای تصویر درخواستی و تعداد بایت‌ها در هر پیکسل برای هر باند محاسبه می‌شود. درخواست ها همچنین به حداکثر 32K پیکسل در هر بعد و حداکثر 1024 باند محدود می شوند. درخواست های بیش از این محدودیت ها منجر به کد خطای 400 (BAD_REQUEST) می شود.

درخواست HTTP

POST https://earthengine.googleapis.com/v1beta/{parent=projects/*}/thumbnails

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
parent

string

مورد نیاز. والد مجموعه تصاویر کوچک (به عنوان مثال، "پروژه ها/*").

مجوز نیاز به مجوز IAM زیر در parent منبع مشخص شده دارد:

  • earthengine.thumbnails.create

پارامترهای پرس و جو

پارامترها
workloadTag

string

برچسب ارائه شده توسط کاربر برای ردیابی این محاسبات.

درخواست بدن

بدنه درخواست شامل یک نمونه از Thumbnail است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از Thumbnail است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .