تُعرِض نقطة نهاية dataLayers البيانات المُرمّزة كملفات GeoTIFF، والتي يمكن استخدامها في أي تطبيق لنظام معلومة جغرافية (GIS) لتصميم الأنظمة الشمسية.
تحتوي كل سلسلة في استجابة dataLayers على عنوان URL يمكنك استخدامه لجلب ملف GeoTIFF المقابل. تكون عناوين URL صالحة لمدة تصل إلى ساعة بعد إنشائها من طلب طبقات البيانات الأصلي. يمكن تخزين ملفات GeoTIFF لمدة تصل إلى 30 يومًا.
باستثناء طبقة RGB، لا يتم عرض ملفات GeoTIFF بشكل صحيح باستخدام عارض الصور، لأنّ المحتوى هو بيانات مُشفَّرة بدلاً من صور RGB. لا يمكن أيضًا استخدام ملفات GeoTIFF مباشرةً كصورة مركبة باستخدام واجهة برمجة تطبيقات JavaScript لخرائط Google.
يصف الجدول التالي كل طبقة بالتفصيل.
| طبقة | عمق البكسل | الدقة | الوصف |
|---|---|---|---|
| نموذج السطح الرقمي (DSM) | قيمة عائمة 32 بت | 0.1 متر/بكسل | بيانات الارتفاع التي تمثّل التضاريس على سطح الأرض، بما في ذلك العناصر الطبيعية والمصنوعة يتم التعبير عن القيم بالمتْر فوق سطح البحر. يتم تخزين المواقع الجغرافية غير الصالحة أو المناطق التي لا تتوفّر لدينا بيانات عنها على النحو التالي: -9999. |
| RGB | 8 بت | 0.1 متر/بكسل 0.25 متر/بكسل 0.5 متر/بكسل 1 متر/بكسل |
صورة جوية للمنطقة يحتوي ملف صور GeoTIFF على
ثلاث نطاقات تتوافق مع قيم الأحمر والأخضر والأزرق لتشكيل
قيمة RGB بسعة 24 بت لكل بكسل. تكون درجة دقة البكسل تلقائيًا 0.1 متر/بكسل. |
| قناع المبنى | 1 بت | 0.1 متر/بكسل | بت واحد لكل بكسل يشير إلى ما إذا كان هذا البكسل يُعدّ جزءًا من سطح. |
| التدفق السنوي | قيمة عائمة 32 بت | 0.1 متر/بكسل | خريطة التدفق السنوي أو ضوء الشمس السنوي على الأسطح في المنطقة
يتم التعبير عن القيم بالكيلوواط ساعة/كيلوواط في السنة. يتم احتساب التدفق لكل موقع جغرافي، وليس فقط على أسطح المباني. يتم تخزين المواقع الجغرافية غير الصالحة أو المناطق التي لم نتمكّن فيها من احتساب معدّل التدفق على أنّها -9999. إنّ المواقع الجغرافية خارج نطاق التغطية غير صالحة. ملاحظة: هذا هو التدفق غير المقنَّع. |
| التدفق الشهري | قيمة عائمة 32 بت | 0.5 متر/بكسل | خريطة التدفق الشهري (ضوء الشمس على الأسطح، مقسّمة حسب الشهر) للمنطقة يتم التعبير عن القيم بالكيلوواط ساعة لكل كيلوواط في السنة. يحتوي ملف صور GeoTIFF على 12 نطاقًا متسلسلًا من كانون الثاني (يناير) إلى كانون الأول (ديسمبر). |
| التظليل كل ساعة | عدد صحيح 32 بت | 1 متر/بكسل | 12 عنوان URL لخرائط التظليل كل ساعة من كانون الثاني (يناير) إلى كانون الأول (ديسمبر) بترتيب تصاعدي يحتوي كل ملف GeoTIFF على 24 نطاقًا، تتوافق مع 24 ساعة في اليوم. كلّ بكسل هو عدد صحيح 32 بت، يمثّل (ما يصل إلى) 31 يومًا من ذلك الشهر. ويعني الرمز 1 بت أنّ الموقع الجغرافي المعني يمكنه رؤية الشمس في ذلك اليوم وفي تلك الساعة وفي ذلك الشهر. يتم تخزين المواقع الجغرافية غير الصالحة على أنّها -9999 ويتم ضبط الرقّم الثنائي 31، لأنّه يتوافق مع اليوم 32 من الشهر وبالتالي يكون غير صالح. |
فك ترميز ملفات Rasters للظل كل ساعة
يتم ترميز بيانات الظل بالساعة في ملفات البيانات النقطية المتعدّدة النطاقات. للاطّلاع على مزيد من المعلومات حول أساسيات ملفّات raster، يُرجى الاطّلاع على مفاهيم Solar API.
عند تقديم طلب للحصول على بيانات الظل كل ساعة، يمكنك الحصول على ما يصل إلى 12 شبكة أساسية، واحدة لكل شهر من السنة التقويمية (من كانون الثاني/يناير إلى كانون الأول/ديسمبر). يتألّف كلّ ملف Raster من 24 طبقة أو شريحة تتوافق مع الساعات الـ 24 في اليوم.
يتم تمثيل كل نطاق من خلال مصفوفة من الخلايا أو الوحدات البكسيلية. يحتوي كل بكسل على عمق يبلغ 32 بتًا، ما يتوافق مع 31 يومًا (الحد الأقصى) في الشهر. وبالتالي، فإنّ فك ترميز بيانات الظل لليوم والوقت والشهر يتطلّب معرفة البت والشريحة والشبكة المركّبة التي يتم تحليلها.
على سبيل المثال، لتحديد ما إذا كان موقع معيّن بالإحداثيات (س، ص) قد رأى الشمس عند الساعة 4:00 مساءً في 22 حزيران (يونيو)، اتّبِع الخطوات التالية:
- قدِّم طلبًا لطبقات البيانات لجميع الطبقات للموقع الجغرافي (x, y).
- بما أنّ شهر حزيران (يونيو) هو الشهر السادس من السنة، ابحث عن عنوان URL السادس في قائمة
hourlyShadeUrls. - يتم عرض النطاقات الزمنية بالساعة على مدار 24 ساعة. للحصول على بيانات الساعة 4:00 مساءً (16:00)، ابحث عن القناة 17.
- يبدأ فهرس الوحدات (الأيام) من 0. للحصول على بيانات عن يوم 22 حزيران (يونيو)، اقرأ الرقّم الثنائي 21.
- تقدّم الوحدات بيانات ثنائية تشير إلى ما إذا كان هذا الموقع الجغرافي قد شهد شمسًا في التاريخ والوقت المحدّدَين. إذا كان القيمة 1، يعني ذلك أنّ الموقع الجغرافي شهد ظهور الشمس. إذا كان العنصر 0، يعني ذلك أنّ الموقع الجغرافي شهد ظلامًا.
يلخِّص الرمز البرمجي التالي الخطوات أعلاه:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))