لمحة عن ملفات GeoTIFF

تعرض نقطة نهاية dataLayers البيانات المشفرة في ملفات GeoTIFF، والتي يمكن استخدامها في أي تطبيق من تطبيقات نظام المعلومات الجغرافية (GIS) لتصميم الأنظمة الشمسية.

تحتوي كل سلسلة في استجابة dataLayers على عنوان URL، والذي يمكنك استخدامه لاسترجاع GeoTIFF المقابل. تكون عناوين URL صالحة لمدة تصل إلى ساعة بعد إنشائها من طلب طبقات البيانات الأصلية. يمكن تخزين ملفات GeoTIFF لمدة تصل إلى 30 يومًا.

باستثناء طبقة نموذج أحمر أخضر أزرق، لا يتم عرض ملفات GeoTIFF بشكل صحيح مع عارض الصور، لأن المحتوى عبارة عن بيانات مرمّزة وليس صور نموذج أحمر أخضر أزرق. ولا يمكن أيضًا استخدام ملفات GeoTIFF مباشرةً كصورة تراكب باستخدام واجهة برمجة تطبيقات JavaScript للخرائط.

يصف الجدول التالي كل طبقة بالتفصيل.

طبقة	عمق البكسل	درجة الدقّة	الوصف
نموذج السطح الرقمي (DSM)	عدد عائم 32 بت	0.1 م/بكسل	بيانات الارتفاع التي تمثّل التضاريس السطحية لسطح الأرض، بما في ذلك العناصر الطبيعية والمباني تقع القيم على بُعد أمتار فوق مستوى سطح البحر. يتم تخزين المواقع الجغرافية غير الصالحة أو المناطق التي لا تتوفّر لدينا بيانات بشأنها على شكل -9999.
نموذج أحمر أخضر أزرق	8 بت	0.1 م/بكسل 0.25 م/بكسل 0.5 م/بكسل 1 م/بكسل	صورة جوية للمنطقة يحتوي ملف صور GeoTIFF على ثلاثة نطاقات متوافقة مع القيم الحمراء والخضراء والزرقاء في شكل قيمة نموذج أحمر أخضر أزرق 24 بت لكل بكسل. تبلغ درجة دقة البكسل تلقائيًا 0.1 متر/بكسل.
قناع بناء	وحدة بت واحدة	0.1 م/بكسل	وحدة بت لكل بكسل تشير إلى ما إذا كانت وحدات البكسل تعتبر جزءًا من سطح أم لا.
التدفق السنوي	عدد عائم 32 بت	0.1 م/بكسل	خريطة التدفّق السنوية، أو ضوء الشمس السنوي على الأسطح، للمنطقة القيم هي كيلوواط ساعة/كيلوواط/سنة. يتم احتساب تدفق التدفّق لكل موقع جغرافي، وليس فقط لأسطح المباني. أما المواقع الجغرافية غير الصالحة أو المناطق التي لم نتمكّن من حساب التدفق من خلالها، يتم تخزينها على شكل -9999. أما المواقع الجغرافية خارج منطقة التغطية، فهي غير صالحة. ملاحظة: هذا هو التدفّق غير المقنع.
التدفّق الشهري	عدد عائم 32 بت	0.5 م/بكسل	خريطة التدفّق الشهرية (أشعة الشمس على الأسطح، مقسّمة حسب الشهر) للمنطقة. القيم هي كيلوواط ساعة/كيلوواط/سنة. يحتوي ملف صور GeoTIFF على 12 نطاقًا بالترتيب من كانون الثاني (يناير) إلى كانون الأول (ديسمبر).
ظلال ساعة	عدد صحيح 32 بت	1 م/بكسل	12 عنوان URL لخرائط الظل بالساعة، حسب الفترة من كانون الثاني (يناير) إلى كانون الأول (ديسمبر)، بالترتيب. يحتوي كل ملف GeoTIFF على 24 نطاقًا، بما يتوافق مع 24 ساعة من اليوم. ويمثِّل كل بكسل عددًا صحيحًا بحجم 32 بت، ويقابل (حتى) 31 يومًا من ذلك الشهر. وتعني البت 1 أنّ الموقع الجغرافي المقابل يمكنه رؤية الشمس في يوم محدّد، وفي تلك الساعة، وفي ذلك الشهر. يتم تخزين المواقع الجغرافية غير الصالحة على شكل -9999، وقد تم ضبط البت 31 عليها بما يتناسب مع اليوم الثاني والثلاثين من الشهر، وبالتالي فهي غير صالحة.

فك ترميز الصور النقطية للظل كل ساعة

يتم ترميز بيانات الظل كل ساعة بتخطيطات نقطية متعددة النطاقات. لمعرفة المزيد حول الأساسيات النقطية، راجع مفاهيم واجهة برمجة التطبيقات الشمسية.

عند تقديم طلب للحصول على بيانات الظل كل ساعة، يمكنك تلقي ما يصل إلى 12 صورة نقطية، واحد لكل شهر من السنة التقويمية (من يناير إلى ديسمبر). وتتكون كل صورة نقطية من 24 طبقة أو نطاقات تقابل 24 ساعة من اليوم.

يتم تمثيل كل نطاق بمصفوفة من الخلايا، أو وحدات بكسل. يبلغ عمق كل بكسل 32 بت، أي ما يعادل (الحد الأقصى) 31 يومًا من الشهر. لذلك، يتطلب فك ترميز بيانات الظل اليوم والوقت والشهر فهم البت والنطاق والنسبة النقطية التي تقوم بتحليلها.

على سبيل المثال، لتحديد ما إذا كان موقع ما على الإحداثيات (س، ص) قد شاهد الشمس في الساعة 4:00 مساءً في 22 حزيران (يونيو)، قم بما يلي:

1. تقديم طلب طبقات بيانات لجميع طبقات الموقع (س، ص).
2. بما أنّ شهر حزيران (يونيو) هو الشهر السادس من السنة، يمكنك جلب عنوان URL السادس من قائمة hourlyShadeUrls.
3. ويتم تقديم أحزمة الساعة بتنسيق 24 ساعة. للحصول على بيانات الساعة 4:00 مساءً (16:00)، ابحث عن القناة السابعة عشرة.
4. فهرس وحدات البت (الأيام) من 0. للحصول على البيانات الخاصة بيوم 22 يونيو، اقرأ البت 21.
5. توفر وحدات البت بيانات ثنائية تشير إلى ما إذا كان هذا الموقع الجغرافي قد رأى الشمس في التاريخ والوقت المحدَّدين. إذا كانت قيمة البت 1، فهذا يعني أن الموقع الجغرافي رأى الشمس. إذا كان البت هو 0، فهذا يعني أن الموقع رأى الظل.

تلخص التعليمة البرمجية التالية الخطوات المذكورة أعلاه:

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))