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