REST Resource: dataLayers

তথ্যসূত্র: ডেটালেয়ার্স

একটি অঞ্চলের সৌরশক্তি সম্পর্কে তথ্য। প্রকৃত তথ্য অনুরোধকৃত অঞ্চলটি কভার করে এমন বেশ কয়েকটি GeoTIFF ফাইলে থাকে, যার জন্য এই বার্তায় URL রয়েছে: DataLayers বার্তার প্রতিটি স্ট্রিংয়ে একটি URL থাকে যেখান থেকে সংশ্লিষ্ট GeoTIFF আনা যেতে পারে। এই URLগুলি তৈরি হওয়ার কয়েক ঘন্টা পরে বৈধ থাকে। বেশিরভাগ GeoTIFF ফাইলের রেজোলিউশন 0.1m/pixel, তবে মাসিক ফ্লাক্স ফাইলটি 0.5m/pixel এবং প্রতি ঘন্টার শেড ফাইলগুলি 1m/pixel। যদি GetDataLayersRequest এ একটি pixelSizeMeters মান নির্দিষ্ট করা থাকে, তাহলে GeoTIFF ফাইলগুলিতে সর্বনিম্ন রেজোলিউশন সেই মান হবে।

JSON উপস্থাপনা 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
ক্ষেত্র
imageryDate

object ( Date )

এই অঞ্চলের উৎস চিত্র (যা থেকে অন্যান্য সমস্ত তথ্য সংগ্রহ করা হয়েছে) কখন নেওয়া হয়েছিল। এটি অবশ্যই কিছুটা আনুমানিক, কারণ চিত্রগুলি এক দিনেরও বেশি সময় ধরে নেওয়া হতে পারে।

imageryProcessedDate

object ( Date )

এই চিত্রটির প্রক্রিয়াকরণ সম্পন্ন হলে।

dsmUrl

string

অঞ্চলের DSM (ডিজিটাল সারফেস মডেল) এর একটি চিত্রের URL। মানগুলি EGM96 জিওয়েড (অর্থাৎ সমুদ্রপৃষ্ঠ) থেকে মিটারে। অবৈধ অবস্থানগুলি (যেখানে আমাদের কাছে ডেটা নেই) -9999 হিসাবে সংরক্ষণ করা হয়।

rgbUrl

string

অঞ্চলের RGB ডেটার (বিমান বা উপগ্রহের ছবি) একটি ছবির URL।

maskUrl

string

বিল্ডিং মাস্ক ছবির URL: প্রতি পিক্সেলের জন্য একটি বিট যা নির্দেশ করে যে সেই পিক্সেলটি ছাদের অংশ বলে বিবেচিত হবে কিনা।

annualFluxUrl

string

অঞ্চলের বার্ষিক ফ্লাক্স ম্যাপের (ছাদে বার্ষিক সূর্যালোক) URL। মান হল kWh/kW/বছর। এটি আনমাস্কড ফ্লাক্স : ফ্লাক্স প্রতিটি অবস্থানের জন্য গণনা করা হয়, কেবল ছাদ নির্মাণের জন্য নয়। অবৈধ অবস্থানগুলি -9999 হিসাবে সংরক্ষণ করা হয়: আমাদের কভারেজ এলাকার বাইরের অবস্থানগুলি অবৈধ হবে এবং কভারেজ এলাকার ভিতরের কয়েকটি অবস্থান, যেখানে আমরা ফ্লাক্স গণনা করতে পারিনি, তাও অবৈধ হবে।

monthlyFluxUrl

string

অঞ্চলের মাসিক প্রবাহ মানচিত্রের (ছাদে সূর্যালোক, মাস অনুসারে বিভক্ত) URL। মান হল kWh/kW/বছর। এই URL দ্বারা নির্দেশিত GeoTIFF-এ জানুয়ারি...ডিসেম্বরের ক্রমানুসারে বারোটি ব্যান্ড থাকবে।

hourlyShadeUrls[]

string

জানুয়ারী...ডিসেম্বর অনুসারে, ঘন্টাভিত্তিক ছায়ার জন্য বারোটি URL। প্রতিটি GeoTIFF-তে দিনের ২৪ ঘন্টার সাথে সঙ্গতিপূর্ণ ২৪টি ব্যান্ড থাকবে। প্রতিটি পিক্সেল হল একটি ৩২ বিট পূর্ণসংখ্যা, যা সেই মাসের (সর্বোচ্চ) ৩১ দিনের সাথে সঙ্গতিপূর্ণ; ১ বিটের অর্থ হল সংশ্লিষ্ট অবস্থানটি সেই মাসের সেই দিন, সেই ঘন্টা, সেই দিনে সূর্য দেখতে সক্ষম। অবৈধ অবস্থানগুলি -৯৯৯৯ হিসাবে সংরক্ষণ করা হয় (যেহেতু এটি নেতিবাচক, এর বিট ৩১ সেট আছে, এবং কোনও বৈধ মানের বিট ৩১ সেট থাকতে পারে না যা মাসের ৩২ তম দিনের সাথে সঙ্গতিপূর্ণ)।

একটি উদাহরণ কার্যকর হতে পারে। যদি আপনি জানতে চান যে একটি বিন্দু (পিক্সেল অবস্থানে (x, y)) ২২শে জুন বিকেল ৪টায় সূর্য দেখেছিল কিনা, তাহলে আপনি:

  1. এই তালিকার ষষ্ঠ URL টি আনুন (জুন মাসের সাথে সম্পর্কিত)।
  2. ১৭তম চ্যানেলটি দেখুন (বিকাল ৪টা পর্যন্ত)।
  3. (x, y) এ 32-বিট মান পড়ুন।
  4. মানের বিট ২১ পড়ুন (মাসের ২২ তারিখের সাথে সম্পর্কিত)।
  5. যদি সেই বিটটি ১ হয়, তাহলে সেই স্থানটি ২২ জুন বিকেল ৪টায় সূর্য দেখেছিল।

আরও আনুষ্ঠানিকভাবে: month (১-১২), day (১...মাস সর্বোচ্চ; ফেব্রুয়ারিতে ২৮ দিন থাকে) এবং hour (০-২৩) দেওয়া হলে, (x, y) অবস্থানে সেই মাস/দিন/ঘন্টার জন্য ছায়া/সূর্য হল বিট

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

যেখানে (x, y) হল স্থানিক সূচীকরণ, [month - 1] হল month - 1 প্রথম URL (শূন্য থেকে সূচীকরণ) আনা, [hour] হল চ্যানেলগুলিতে সূচীকরণ করা, এবং একটি চূড়ান্ত অ-শূন্য ফলাফলের অর্থ "রৌদ্রোজ্জ্বল"। কোনও লিপ ডে নেই, এবং DST এর অস্তিত্ব নেই (সমস্ত দিন 24 ঘন্টা দীর্ঘ; দুপুর সর্বদা "মানক সময়" দুপুর)।

imageryQuality

enum ( ImageryQuality )

ফলাফলের চিত্রের মান।

তারিখ

একটি পূর্ণাঙ্গ বা আংশিক ক্যালেন্ডার তারিখ প্রতিনিধিত্ব করে, যেমন জন্মদিন। দিনের সময় এবং সময় অঞ্চল হয় অন্য কোথাও নির্দিষ্ট করা আছে অথবা তাৎপর্যপূর্ণ নয়। তারিখটি গ্রেগরিয়ান ক্যালেন্ডারের সাথে সম্পর্কিত। এটি নিম্নলিখিতগুলির মধ্যে একটি প্রতিনিধিত্ব করতে পারে:

  • একটি পূর্ণ তারিখ, যেখানে বছর, মাস এবং দিনের মান শূন্য নয়।
  • একটি মাস এবং একটি দিন, যেখানে একটি শূন্য বছর (উদাহরণস্বরূপ, একটি বার্ষিকী)।
  • একটি শূন্য মাস এবং একটি শূন্য দিন সহ একটি নিজস্ব বছর।
  • একটি বছর এবং একটি মাস, শূন্য দিন সহ (উদাহরণস্বরূপ, একটি ক্রেডিট কার্ডের মেয়াদ শেষ হওয়ার তারিখ)।

সম্পর্কিত প্রকার:

JSON উপস্থাপনা 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ক্ষেত্র
year

integer

তারিখের বছর। ১ থেকে ৯৯৯৯ পর্যন্ত হতে হবে, অথবা বছর ছাড়া তারিখ উল্লেখ করতে ০ হতে হবে।

month

integer

বছরের মাস। ১ থেকে ১২ পর্যন্ত হতে হবে, অথবা মাস এবং দিন ছাড়া বছর নির্দিষ্ট করতে ০ হতে হবে।

day

integer

মাসের দিন। ১ থেকে ৩১ পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা একটি বছর নির্দিষ্ট করার জন্য ০ হতে হবে, অথবা এমন একটি বছর এবং মাস যেখানে দিনটি গুরুত্বপূর্ণ নয়।

চিত্রাবলীগুণমান

কিছু API ফলাফল গণনা করতে ব্যবহৃত চিত্রের মান।

দ্রষ্টব্য: চিত্রের মানের স্তর নির্বিশেষে, DSM আউটপুটগুলির রেজোলিউশন সর্বদা 0.1 মি/পিক্সেল থাকে, মাসিক ফ্লাক্স আউটপুটগুলির রেজোলিউশন সর্বদা 0.5 মি/পিক্সেল থাকে এবং প্রতি ঘন্টায় শেড আউটপুটগুলির রেজোলিউশন সর্বদা 1 মি/পিক্সেল থাকে।

এনামস
IMAGERY_QUALITY_UNSPECIFIED কোন গুণ জানা নেই।
HIGH সৌর তথ্য কম উচ্চতায় ধারণ করা এবং ০.১ মি/পিক্সেল গতিতে প্রক্রিয়াজাত করা আকাশের চিত্র থেকে নেওয়া হয়েছে।
MEDIUM সৌর তথ্য উচ্চ-উচ্চতায় ধারণ করা উন্নত আকাশ চিত্র থেকে প্রাপ্ত এবং 0.25 মি/পিক্সেল গতিতে প্রক্রিয়াজাত করা হয়েছে।
BASE সৌর তথ্য ০.২৫ মি/পিক্সেল গতিতে প্রক্রিয়াজাত উন্নত উপগ্রহ চিত্র থেকে নেওয়া হয়েছে।

পদ্ধতি

get

 কোনও স্থানের আশেপাশের অঞ্চলের সৌরশক্তির তথ্য সংগ্রহ করে।