Method: projects.assets.getPixels

একটি ইমেজ সম্পদ থেকে পিক্সেল নিয়ে আসে। এই কাস্টম পদ্ধতিটি কলকারীকে একটি চিত্র থেকে পিক্সেলের একটি নির্বিচারে টাইলের অনুরোধ করতে দেয়, ঐচ্ছিকভাবে ব্যান্ড এবং মানচিত্র অভিক্ষেপ নির্দিষ্ট করে। মুখোশযুক্ত বা অনুপস্থিত ডেটা শূন্য হিসাবে এনকোড করা হবে।

অনুরোধগুলি পিক্সেলে অনুরোধের মাত্রা, অনুরোধ করা ইমেজ ব্যান্ডের সংখ্যা এবং প্রতিটি ব্যান্ডের জন্য পিক্সেল প্রতি বাইটের সংখ্যা হিসাবে গণনা করা, প্রতি অনুরোধে 48MB সীমাহীন ডেটাতে সীমাবদ্ধ। অনুরোধগুলি সর্বাধিক 32K পিক্সেল উভয় মাত্রা এবং সর্বাধিক 1024 ব্যান্ডে সীমাবদ্ধ। এই সীমা অতিক্রম করার অনুরোধের ফলে একটি ত্রুটি কোড 400 (BAD_REQUEST) হবে৷

সফল হলে, প্রতিক্রিয়া বডিতে অনুরোধের fileFormat ক্ষেত্রে নির্দিষ্ট এনকোডিং-এ অনুরোধ করা পিক্সেল ডেটা থাকে।

HTTP অনুরোধ

POST https://earthengine.googleapis.com/v1beta/{name=projects/*/assets/**}:getPixels

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

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

পরামিতি
name

string

প্রয়োজন। ছবির সম্পদের নাম যেখান থেকে পিক্সেল পাওয়া যাবে। name "projects/*/assets/**" ফরম্যাটের (যেমন, "projects/earthengine-legacy/assets/users/[USER]/[ASSET]")। সমস্ত ব্যবহারকারীর মালিকানাধীন সম্পদ "আর্থেঞ্জিন-লেগ্যাসি" প্রকল্পের অধীনে রয়েছে (যেমন, "প্রকল্প/আর্থেঞ্জিন-লেগেসি/সম্পদ/ব্যবহারকারী/ফু/বার")। অন্যান্য সমস্ত সম্পদ "আর্থেঞ্জিন-পাবলিক" প্রকল্পের অধীনে রয়েছে (যেমন, "প্রকল্প/আর্থেঞ্জিন-পাবলিক/সম্পদ/ল্যান্ডস্যাট")।

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

  • earthengine.assets.get

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
ক্ষেত্র
fileFormat

enum ( ImageFileFormat )

আউটপুট ফাইল বিন্যাস যেখানে পিক্সেল মান ফেরত দিতে হবে।

grid

object ( PixelGrid )

পিক্সেল গ্রিড বর্ণনা করে যে প্যারামিটারগুলি ডেটা আনতে হবে৷ ডেটার নেটিভ পিক্সেল গ্রিডে ডিফল্ট।

region

object ( Struct format)

যদি উপস্থিত থাকে, ডেটার যে অঞ্চলটি ফেরত দিতে হবে, একটি GeoJSON জ্যামিতি বস্তু হিসাবে নির্দিষ্ট করা হয়েছে (RFC 7946 দেখুন)। যেহেতু প্রত্যাবর্তিত চিত্রটি সর্বদা আয়তক্ষেত্রাকার হয়, তাই আউটপুট স্থানাঙ্ক সিস্টেমে প্রদত্ত জ্যামিতির বাউন্ডিং বক্সটি আসলে ব্যবহার করা হবে। যদি grid.dimensions ও নির্দিষ্ট করা থাকে তাহলে গ্রিড অবশেষে অনুরোধকৃত আকারে পুনঃস্কেল করা হবে।

bandIds[]

string

উপস্থিত থাকলে, ব্যান্ডের একটি নির্দিষ্ট সেট উল্লেখ করে যেখান থেকে পিক্সেল পেতে হবে। ব্যান্ডগুলি আইডি দ্বারা চিহ্নিত করা হয়, যেমনটি একটি ইমেজব্যান্ড প্রোটোর id ক্ষেত্র দ্বারা নির্দেশিত হয়।

visualizationOptions

object ( VisualizationOptions )

যদি উপস্থিত থাকে, ভিজ্যুয়ালাইজেশন অপশনের একটি সেট অপরিশোধিত ডেটা ফেরত দেওয়ার পরিবর্তে ডেটার একটি 8-বিট RGB ভিজ্যুয়ালাইজেশন তৈরি করতে প্রয়োগ করতে হবে।

workloadTag

string

এই গণনা ট্র্যাক করতে ব্যবহারকারীর সরবরাহকৃত ট্যাগ৷

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া একটি জেনেরিক HTTP প্রতিক্রিয়া যার বিন্যাস পদ্ধতি দ্বারা সংজ্ঞায়িত করা হয়।

অনুমোদনের সুযোগ

নিম্নলিখিত 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 .