Method: projects.locations.thumbnails.create

একটি আইডি তৈরি করে যা একটি "থাম্বনেল" চিত্র রেন্ডার করতে ব্যবহার করা যেতে পারে।

এটি GetThumbnailPixels এর সাথে ব্যবহার করা হয়। thumbnails.create এ একটি কল একটি অভিব্যক্তি এবং কিছু আউটপুট বিকল্প প্রদান করে। thumbnails.create এর ফলাফল হল একটি আইডি যা এমন একটি চিত্রকে উপস্থাপন করে যা সেই অভিব্যক্তিটির মূল্যায়ন এবং সেই বিকল্পগুলি প্রয়োগ করার ফলাফল। পরবর্তীকালে, GetThumbnailPixels এ কল করে সমগ্র ফলাফলের চিত্রের জন্য ইমেজ ডেটা পেতে পারে। আইডি একটি মাঝারি সময়ের জন্য বৈধ হবে (কয়েক ঘন্টা)।

এন্ডপয়েন্টের এই জোড়ার জন্য সবচেয়ে সাধারণ ব্যবহারের ক্ষেত্রে হল thumbnails.create এ একটি POST-এর মাধ্যমে একটি জটিল অভিব্যক্তি প্রদান করা, এবং তারপর GET থেকে GetThumbnailPixels এর মাধ্যমে গণনা করা ছবি আনা। এই দুই-অংশের প্রক্রিয়াটি ComputePixels চেয়ে বেশি পরিস্থিতিতে ব্যবহারের অনুমতি দেয়। বিশেষ করে: - এনকোড করা ইমেজ বাইট পেতে ComputePixels এর ফলাফলকে খুলে ফেলা দরকার। GetThumbnailPixels এর ফলাফল সরাসরি ব্রাউজার দ্বারা প্রদর্শিত হতে পারে। - ComputePixels শুধুমাত্র একটি অনুমোদিত ব্যবহারকারী দ্বারা কল করা যেতে পারে, একটি সঠিকভাবে-স্কোপড OAuth টোকেন ব্যবহার করে। thumbnails.create এরও একই সীমাবদ্ধতা রয়েছে, কিন্তু GetThumbnailPixels একটি API কী সমন্বিত URL দিয়ে আবাহন করা যেতে পারে, তাই এটিকে আহ্বানকারী URLগুলি আরও বিস্তৃতভাবে ব্যবহার করা যেতে পারে।

অভিব্যক্তি মূল্যায়নের ফলাফলকে অনুরোধ করা চিত্র বিন্যাসের জন্য কিছু যুক্তিসঙ্গত প্রয়োজনীয়তা পূরণ করতে হবে। বিশেষ করে, JPEG বা PNG ফরম্যাটের জন্য এক বা তিনটি আউটপুট ব্যান্ড এবং ক্লিপ মান 0-255 রেঞ্জের বাইরে থাকা প্রয়োজন।

"থাম্বনেইল" বর্ণনাটি গণনা করা চিত্রের আকারের উপর একটি সীমাবদ্ধতা বোঝায় না: ComputePixels যেমন thumbnails.create / GetThumbnailPixels এ প্রযোজ্য একই সীমাবদ্ধতা। অনুরোধগুলি পিক্সেলে অনুরোধের মাত্রা, অনুরোধ করা ইমেজ ব্যান্ডের সংখ্যা এবং প্রতিটি ব্যান্ডের জন্য পিক্সেল প্রতি বাইটের সংখ্যা হিসাবে গণনা করা, প্রতি অনুরোধে 48MB সীমাহীন ডেটাতে সীমাবদ্ধ। অনুরোধগুলি সর্বাধিক 32K পিক্সেল উভয় মাত্রা এবং সর্বাধিক 1024 ব্যান্ডে সীমাবদ্ধ। এই সীমা অতিক্রম করার অনুরোধের ফলে একটি ত্রুটি কোড 400 (BAD_REQUEST) হবে৷

HTTP অনুরোধ

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

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
parent

string

প্রয়োজন। থাম্বনেইল সংগ্রহের মূল (যেমন, "প্রকল্প/*")।

অনুমোদনের জন্য নির্দিষ্ট রিসোর্স parent নিম্নলিখিত IAM অনুমতি প্রয়োজন:

  • 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 .

,

একটি আইডি তৈরি করে যা একটি "থাম্বনেল" চিত্র রেন্ডার করতে ব্যবহার করা যেতে পারে।

এটি GetThumbnailPixels এর সাথে ব্যবহার করা হয়। thumbnails.create এ একটি কল একটি অভিব্যক্তি এবং কিছু আউটপুট বিকল্প প্রদান করে। thumbnails.create এর ফলাফল হল একটি আইডি যা এমন একটি চিত্রকে উপস্থাপন করে যা সেই অভিব্যক্তিটির মূল্যায়ন এবং সেই বিকল্পগুলি প্রয়োগ করার ফলাফল। পরবর্তীকালে, GetThumbnailPixels এ কল করে সমগ্র ফলাফলের চিত্রের জন্য ইমেজ ডেটা পেতে পারে। আইডি একটি মাঝারি সময়ের জন্য বৈধ হবে (কয়েক ঘন্টা)।

এন্ডপয়েন্টের এই জোড়ার জন্য সবচেয়ে সাধারণ ব্যবহারের ক্ষেত্রে হল thumbnails.create এ একটি POST-এর মাধ্যমে একটি জটিল অভিব্যক্তি প্রদান করা, এবং তারপর GET থেকে GetThumbnailPixels এর মাধ্যমে গণনা করা ছবি আনা। এই দুই-অংশের প্রক্রিয়াটি ComputePixels চেয়ে বেশি পরিস্থিতিতে ব্যবহারের অনুমতি দেয়। বিশেষ করে: - এনকোড করা ইমেজ বাইট পেতে ComputePixels এর ফলাফলকে খুলে ফেলা দরকার। GetThumbnailPixels এর ফলাফল সরাসরি ব্রাউজার দ্বারা প্রদর্শিত হতে পারে। - ComputePixels শুধুমাত্র একটি অনুমোদিত ব্যবহারকারী দ্বারা কল করা যেতে পারে, একটি সঠিকভাবে-স্কোপড OAuth টোকেন ব্যবহার করে। thumbnails.create এরও একই সীমাবদ্ধতা রয়েছে, কিন্তু GetThumbnailPixels একটি API কী সমন্বিত URL দিয়ে আবাহন করা যেতে পারে, তাই এটিকে আহ্বানকারী URLগুলি আরও বিস্তৃতভাবে ব্যবহার করা যেতে পারে।

অভিব্যক্তি মূল্যায়নের ফলাফলকে অনুরোধ করা চিত্র বিন্যাসের জন্য কিছু যুক্তিসঙ্গত প্রয়োজনীয়তা পূরণ করতে হবে। বিশেষ করে, JPEG বা PNG ফরম্যাটের জন্য এক বা তিনটি আউটপুট ব্যান্ড এবং ক্লিপ মান 0-255 রেঞ্জের বাইরে থাকা প্রয়োজন।

"থাম্বনেইল" বর্ণনাটি গণনা করা চিত্রের আকারের উপর একটি সীমাবদ্ধতা বোঝায় না: ComputePixels যেমন thumbnails.create / GetThumbnailPixels এ প্রযোজ্য একই সীমাবদ্ধতা। অনুরোধগুলি পিক্সেলে অনুরোধের মাত্রা, অনুরোধ করা ইমেজ ব্যান্ডের সংখ্যা এবং প্রতিটি ব্যান্ডের জন্য পিক্সেল প্রতি বাইটের সংখ্যা হিসাবে গণনা করা, প্রতি অনুরোধে 48MB সীমাহীন ডেটাতে সীমাবদ্ধ। অনুরোধগুলি সর্বাধিক 32K পিক্সেল উভয় মাত্রা এবং সর্বাধিক 1024 ব্যান্ডে সীমাবদ্ধ। এই সীমা অতিক্রম করার অনুরোধের ফলে একটি ত্রুটি কোড 400 (BAD_REQUEST) হবে৷

HTTP অনুরোধ

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

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
parent

string

প্রয়োজন। থাম্বনেইল সংগ্রহের মূল (যেমন, "প্রকল্প/*")।

অনুমোদনের জন্য নির্দিষ্ট রিসোর্স parent নিম্নলিখিত IAM অনুমতি প্রয়োজন:

  • 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 .