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