نقطة نهاية dataLayers بيانات مشفرة كملفات GeoTIFF، والتي يمكن استخدامها في أي مناطق نظام المعلومات (GIS) لتصميم الأنظمة الشمسية.
تحتوي كل سلسلة في استجابة dataLayers على عنوان URL، يمكنك استخدامها لجلب GeoTIFF المقابل. وتكون عناوين URL صالحة لمدة تصل إلى ساعة بعد يتم إنشاؤها من طلب طبقات البيانات الأصلية. يمكن أن تكون ملفات GeoTIFF لمدة تصل إلى 30 يومًا.
باستثناء طبقة RGB، فإن ملفات GeoTIFF لا يتم عرضها بشكل صحيح مع عارض الصور، لأنّ المحتوى هو بيانات مرمّزة بدلاً من صور بنموذج أحمر أخضر أزرق. GeoTIFF لا يمكن أيضًا استخدامها مباشرةً كصورة تراكب باستخدام واجهة برمجة تطبيقات JavaScript للخرائط.
يصف الجدول التالي كل طبقة بالتفصيل.
| طبقة | عمق البكسل | الدقة | الوصف |
|---|---|---|---|
| نموذج السطح الرقمي (DSM) | عائم 32 بت | 0.1 م/بكسل | بيانات الارتفاع التي تمثل تضاريس سطح الأرض، بما في ذلك العناصر الطبيعية والمبنية. تظهر القيم بالأمتار فوق سطح البحر. المستوى. يتم تخزين المواقع غير الصالحة أو المناطق التي لا تتوفر لنا بيانات بها 9999-. |
| RGB | 8 بت | 0.1 م/بكسل 0.25 م/بكسل 0.5 م/بكسل 1 متر/بكسل |
صورة جوية للمنطقة يحتوي ملف صور GeoTIFF على
ثلاث نطاقات تتوافق مع قيم الأحمر والأخضر والأزرق لتشكيل
قيمة RGB بسعة 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 يومًا (كحد أقصى) من الشهر. وبالتالي، يتطلب فك ترميز بيانات اليوم والوقت والشهر فهم البت والشريط والنقطة النقطية التي تقوم بتحليلها.
على سبيل المثال، لتحديد ما إذا كان موقع معين في الإحداثيات (س، ص) قد رأى الأحد الساعة 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))