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 يحتوي على مفتاح واجهة برمجة التطبيقات، وبالتالي يمكن استخدام عناوين URL التي تستدعيه على نطاق أوسع.

يجب أن تستوفي نتيجة تقييم التعبير بعض المتطلبات المعقولة لتنسيق الصورة المطلوب. على وجه الخصوص، يتطلب تنسيق JPEG أو PNG أن يكون هناك نطاق واحد أو ثلاثة نطاقات إخراج، وأن يتم اقتصاص القيم التي تقع خارج النطاق من 0 إلى 255.

لا يشير الوصف "صورة مصغّرة" إلى فرض قيود على حجم الصورة المحسوبة: تنطبق القيود نفسها على ComputePixels على thumbnails.create/thumbnails.getPixels. تقتصر الطلبات على 48 ميغابايت من البيانات غير المضغوطة لكل طلب، ويتم احتسابها على أنّها حاصل ضرب سمات الطلب بالبكسل وعدد نطاقات الصورة المطلوبة وعدد وحدات البايت لكل بكسل لكل نطاق. تقتصر الطلبات أيضًا على 32 ألف بكسل كحد أقصى في أي من الأبعاد و1024 نطاقًا كحد أقصى. سيؤدي تجاوز هذه الحدود القصوى إلى ظهور رمز الخطأ 400 (BAD_REQUEST).

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. العنصر الرئيسي لمجموعة الصور المصغّرة (مثل "projects/*").

يتطلب التفويض إذن 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.