ডেটালেয়ার্স এন্ডপয়েন্টটি জিওটিআইএফএফ ফাইল হিসাবে এনকোড করা ডেটা ফেরত দেয়, যা সৌরজগৎ ডিজাইনের জন্য যেকোনো ভৌগোলিক তথ্য ব্যবস্থা (জিআইএস) অ্যাপ্লিকেশনে ব্যবহার করা যেতে পারে।
dataLayers প্রতিক্রিয়ার প্রতিটি স্ট্রিংয়ে একটি URL থাকে, যা আপনি সংশ্লিষ্ট GeoTIFF আনতে ব্যবহার করতে পারেন। মূল ডেটা স্তর অনুরোধ থেকে তৈরি হওয়ার পর URL গুলি এক ঘন্টা পর্যন্ত বৈধ থাকে। GeoTIFF ফাইলগুলি 30 দিন পর্যন্ত সংরক্ষণ করা যেতে পারে।
RGB লেয়ার বাদে, GeoTIFF ফাইলগুলি ইমেজ ভিউয়ারের সাথে সঠিকভাবে প্রদর্শিত হয় না, কারণ বিষয়বস্তু RGB ইমেজের পরিবর্তে এনকোডেড ডেটা। GeoTIFF ফাইলগুলি Maps Javascript API এর সাথে সরাসরি ওভারলে ইমেজ হিসাবে ব্যবহার করা যাবে না।
নিম্নলিখিত টেবিলে প্রতিটি স্তরের বিস্তারিত বর্ণনা দেওয়া হয়েছে।
| স্তর | পিক্সেল গভীরতা | রেজোলিউশন | বিবরণ |
|---|---|---|---|
| ডিজিটাল সারফেস মডেল (DSM) | ৩২-বিট ফ্লোট | ০.১ মি/পিক্সেল | পৃথিবীর ভূ-পৃষ্ঠের ভূ-প্রকৃতির প্রতিনিধিত্বকারী উচ্চতার তথ্য, যার মধ্যে প্রাকৃতিক এবং নির্মিত বৈশিষ্ট্য অন্তর্ভুক্ত। সমুদ্রপৃষ্ঠ থেকে মিটারে মান নির্ধারণ করা হয়েছে। অবৈধ অবস্থান, অথবা যেসব এলাকায় আমাদের কাছে ডেটা নেই, সেগুলি -৯৯৯৯ হিসাবে সংরক্ষণ করা হয়। |
| আরজিবি | ৮-বিট | ০.১ মি/পিক্সেল ০.২৫ মি/পিক্সেল | অঞ্চলের একটি আকাশ বা উপগ্রহ চিত্র। GeoTIFF চিত্র ফাইলে লাল, সবুজ এবং নীল মানের সাথে সম্পর্কিত তিনটি ব্যান্ড থাকে যাতে প্রতিটি পিক্সেলের জন্য 24-বিট RGB মান তৈরি হয়। ডিফল্টরূপে, পিক্সেল রেজোলিউশন 0.1 মি/পিক্সেল। |
| বিল্ডিং মাস্ক | ১-বিট | ০.১ মি/পিক্সেল | প্রতি পিক্সেলের জন্য একটি বিট নির্দেশ করে যে সেই পিক্সেলটি ছাদের অংশ হিসেবে বিবেচিত কিনা। |
| বার্ষিক প্রবাহ | ৩২-বিট ফ্লোট | ০.১ মি/পিক্সেল | অঞ্চলের বার্ষিক প্রবাহ মানচিত্র, অথবা ছাদে বার্ষিক সূর্যালোক। মান হল kWh/kW/বছর। শুধুমাত্র ছাদ নির্মাণের জন্য নয়, প্রতিটি অবস্থানের জন্য ফ্লাক্স গণনা করা হয়। অবৈধ অবস্থান, অথবা যেসব এলাকায় আমরা ফ্লাক্স গণনা করতে পারিনি, সেগুলো -৯৯৯৯ হিসেবে সংরক্ষণ করা হয়। আমাদের কভারেজ এলাকার বাইরের অবস্থানগুলি অবৈধ। দ্রষ্টব্য: এটি আনমাস্কড ফ্লাক্স। |
| মাসিক প্রবাহ | ৩২-বিট ফ্লোট | ০.৫ মি/পিক্সেল | অঞ্চলের মাসিক প্রবাহ মানচিত্র (ছাদের উপর সূর্যালোক, মাস অনুসারে বিভক্ত)। মান হল kWh/kW/বছর। GeoTIFF চিত্র ফাইলে জানুয়ারি - ডিসেম্বরের সাথে সম্পর্কিত 12টি ব্যান্ড রয়েছে, ক্রমানুসারে। |
| প্রতি ঘন্টায় ছায়া | ৩২-বিট পূর্ণসংখ্যা | ১ মি/পিক্সেল | জানুয়ারি - ডিসেম্বরের সাথে সম্পর্কিত ঘন্টাভিত্তিক ছায়া মানচিত্রের জন্য ১২টি URL, ক্রমানুসারে। প্রতিটি GeoTIFF ফাইলে ২৪টি ব্যান্ড থাকে, যা দিনের ২৪ ঘন্টার সাথে সামঞ্জস্যপূর্ণ। প্রতিটি পিক্সেল হল একটি ৩২ বিট পূর্ণসংখ্যা, যা সেই মাসের (সর্বোচ্চ) ৩১ দিনের সাথে সামঞ্জস্যপূর্ণ। ১ বিটের অর্থ হল সংশ্লিষ্ট অবস্থানটি সেই মাসের সেই দিনে, সেই সময়ে, সেই সময়ে সূর্য দেখতে সক্ষম। অবৈধ অবস্থানগুলি -9999 হিসাবে সংরক্ষণ করা হয় এবং বিট 31 সেট করা থাকে, কারণ এটি মাসের 32 তম দিনের সাথে সম্পর্কিত এবং তাই অবৈধ। |
ঘন্টাভিত্তিক শেড রাস্টার ডিকোড করুন
ঘন্টাভিত্তিক শেড ডেটা মাল্টিব্যান্ড রাস্টারগুলিতে এনকোড করা হয়। রাস্টারের মূল বিষয়গুলি সম্পর্কে আরও জানতে, সোলার এপিআই ধারণাগুলি দেখুন।
যখন আপনি প্রতি ঘণ্টায় শেড ডেটার জন্য অনুরোধ করেন, তখন আপনি সর্বাধিক ১২টি রাস্টার পেতে পারেন, ক্যালেন্ডার বছরের প্রতিটি মাসের জন্য (জানুয়ারী থেকে ডিসেম্বর) একটি করে। প্রতিটি রাস্টার ২৪টি স্তর বা ব্যান্ড দিয়ে গঠিত, যা দিনের ২৪ ঘন্টার সাথে সামঞ্জস্যপূর্ণ।
প্রতিটি ব্যান্ড কোষের একটি ম্যাট্রিক্স বা পিক্সেল দ্বারা প্রতিনিধিত্ব করা হয়। প্রতিটি পিক্সেলের গভীরতা 32 বিট, যা মাসের (সর্বোচ্চ) 31 দিনের সাথে মিলে যায়। তাই, শেড ডেটার দিন, সময় এবং মাসের ডিকোডিং করার জন্য, আপনি যে বিট, ব্যান্ড এবং রাস্টার বিশ্লেষণ করছেন তা বোঝা প্রয়োজন।
উদাহরণস্বরূপ, স্থানাঙ্কে (x, y) একটি নির্দিষ্ট অবস্থান ২২ জুন বিকেল ৪:০০ টায় সূর্য দেখেছে কিনা তা সনাক্ত করতে, নিম্নলিখিতগুলি করুন:
- অবস্থানের জন্য সকল স্তরের জন্য একটি ডেটা স্তর অনুরোধ তৈরি করুন (x, y)।
- যেহেতু জুন মাস বছরের ষষ্ঠ মাস, তাই
hourlyShadeUrlsতালিকার ষষ্ঠ URL টি আনুন। - ২৪ ঘন্টার মধ্যে ঘন্টাভিত্তিক ব্যান্ড দেওয়া হয়। বিকাল ৪:০০ (১৬:০০) এর তথ্য পেতে, ১৭তম চ্যানেলটি দেখুন।
- বিট (দিন) সূচক ০ থেকে। ২২শে জুনের তথ্য পেতে, বিট ২১ পড়ুন।
- বিটগুলি বাইনারি ডেটা প্রদান করে যা নির্দেশ করে যে নির্দিষ্ট তারিখ এবং সময়ে সেই অবস্থানটি সূর্য দেখেছিল কিনা। যদি বিট 1 হয়, তাহলে অবস্থানটি সূর্য দেখেছিল। যদি বিট 0 হয়, তাহলে অবস্থানটি ছায়া দেখেছিল।
নিম্নলিখিত কোডটি উপরের ধাপগুলির সারসংক্ষেপ তুলে ধরে:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))