REST Resource: dataLayers

المَرجع: DataLayers

معلومات حول إمكانية توليد الطاقة الشمسية في منطقة معيّنة يتم تضمين البيانات الفعلية في عدد من ملفات GeoTIFF التي تغطي المنطقة المطلوبة، والتي تحتوي هذه الرسالة على عناوين URL لها: يحتوي كل سلسلة في الرسالة DataLayers على عنوان URL يمكن من خلاله جلب ملف GeoTIFF المقابل. تكون عناوين URL هذه صالحة لبضع ساعات بعد إنشائها. تتوفّر معظم ملفات GeoTIFF بدقة 0.1 متر/بكسل، ولكن ملف التدفق الشهري يتوفّر بدقة 0.5 متر/بكسل، وملفات الظل كل ساعة تتوفّر بدقة 1 متر/بكسل. إذا تم تحديد قيمة pixelSizeMeters في GetDataLayersRequest، ستكون درجة الدقة الدنيا في ملفات GeoTIFF هي تلك القيمة.

تمثيل JSON 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
الحقول
imageryDate

object (Date)

تاريخ التقاط الصور المصدر (التي يتم استخلاص جميع البيانات الأخرى منها) في هذه المنطقة ويكون هذا التقدير تقريبيًا إلى حدّ ما، لأنّه قد تم التقاط الصور على مدار أكثر من يوم واحد.
imageryProcessedDate

object (Date)

الوقت الذي اكتملت فيه معالجة هذه الصور
dsmUrl

string

تمثّل هذه السمة عنوان URL لصورة نموذج السطح الرقمي (DSM) للمنطقة. تكون القيم بالأمتار فوق مجسم EGM96 الجيوديسي (أي مستوى سطح البحر). يتم تخزين المواقع الجغرافية غير الصالحة (التي لا تتوفّر لدينا بيانات عنها) بالقيمة -9999.
rgbUrl

string

تمثّل هذه السمة عنوان URL لصورة بيانات RGB (صورة جوية) للمنطقة.
maskUrl

string

تمثّل هذه السمة عنوان URL لصورة قناع المبنى: بت واحد لكل بكسل يحدّد ما إذا كان هذا البكسل يُعدّ جزءًا من سطح المبنى أم لا.
annualFluxUrl

string

تمثّل هذه السمة عنوان URL لخريطة التدفق السنوي (ضوء الشمس السنوي على الأسطح) للمنطقة. القيم هي كيلوواط ساعة/كيلوواط/السنة. هذا هو الفيض غير المحجوب: يتم احتساب الفيض لكل موقع جغرافي، وليس فقط لأسطح المباني. يتم تخزين المواقع الجغرافية غير الصالحة بالقيمة -9999: ستكون المواقع الجغرافية خارج نطاق التغطية غير صالحة، كما أنّ بعض المواقع الجغرافية داخل نطاق التغطية، حيث لم نتمكّن من حساب التدفق، ستكون أيضًا غير صالحة.
monthlyFluxUrl

string

عنوان URL لخريطة التدفق الشهري (ضوء الشمس على الأسطح، مقسّمًا حسب الشهر) للمنطقة القيم هي كيلوواط ساعة/كيلوواط/السنة. سيحتوي ملف GeoTIFF الذي يشير إليه عنوان URL هذا على اثني عشر نطاقًا، تتوافق مع الأشهر من كانون الثاني (يناير) إلى كانون الأول (ديسمبر)، بالترتيب.
hourlyShadeUrls[]

string

اثنا عشر عنوان URL لدرجة الظل كل ساعة، بما يتوافق مع أشهر السنة من يناير إلى ديسمبر، بالترتيب سيحتوي كل ملف GeoTIFF على 24 نطاقًا، تتوافق مع ساعات اليوم الـ 24. كل بكسل هو عدد صحيح 32 بت، ويتوافق مع (ما يصل إلى) 31 يومًا من ذلك الشهر؛ يعني 1 بت أنّ الموقع الجغرافي المقابل يمكنه رؤية الشمس في ذلك اليوم، وفي تلك الساعة، وفي ذلك الشهر. يتم تخزين المواقع الجغرافية غير الصالحة بالقيمة ‎-9999 (بما أنّ هذه القيمة سالبة، يتم ضبط البت 31، ولا يمكن أن تحتوي أي قيمة صالحة على البت 31 لأنّ ذلك سيتوافق مع اليوم الثاني والثلاثين من الشهر).

قد يكون من المفيد تقديم مثال. إذا أردت معرفة ما إذا كانت نقطة ما (في الموقع الجغرافي لوحدة البكسل (x, y)) قد تعرّضت لأشعة الشمس في الساعة 4 مساءً يوم 22 يونيو، عليك إجراء ما يلي:

  1. استرجاع عنوان URL السادس في هذه القائمة (المتوافق مع شهر يونيو)
  2. ابحث عن القناة رقم 17 (المقابلة للساعة 4 بعد الظهر).
  3. قراءة قيمة 32 بت في (x, y)
  4. قراءة البت 21 من القيمة (الموافق لليوم الثاني والعشرين من الشهر)
  5. إذا كانت هذه الوحدة 1، يعني ذلك أنّ هذا الموقع شهد الشمس في الساعة 4 مساءً يوم 22 يونيو.

بشكل أكثر رسمية: إذا كان لدينا month (من 1 إلى 12) وday (من 1 إلى الحد الأقصى للشهر؛ يضم شهر فبراير 28 يومًا) وhour (من 0 إلى 23)، فإنّ الظل/الشمس في ذلك الشهر/اليوم/الساعة في الموضع (x, y) هو البت

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

حيث يمثّل (x, y) الفهرسة المكانية، ويشير [month - 1] إلى جلب عنوان URL month - 1 (الفهرسة تبدأ من الصفر)، ويمثّل [hour] الفهرسة في القنوات، وتعني النتيجة النهائية غير الصفرية "مشمس". لا توجد أيام كبيسة، ولا يتم تطبيق التوقيت الصيفي (جميع الأيام مدتها 24 ساعة، ويكون وقت الظهيرة دائمًا "التوقيت العادي").
imageryQuality

enum (ImageryQuality)

جودة الصور في النتيجة

التاريخ

تمثّل هذه السمة تاريخ تقويم كاملاً أو جزئيًا، مثل تاريخ الميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو لا أهمية لهما. التاريخ نسبي بالنسبة إلى التقويم الغريغوري. يمكن أن يمثّل ذلك أحد ما يلي:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
  • الشهر واليوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية)
  • سنة بمفردها، مع شهر ويوم بقيمة صفر
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة ائتمان).

الأنواع ذات الصلة:

تمثيل JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

سنة التاريخ يجب أن يكون الرقم بين 1 و9999، أو 0 لتحديد تاريخ بدون سنة.
month

integer

الشهر من السنة يجب أن يكون الرقم بين 1 و12، أو 0 لتحديد سنة بدون شهر ويوم.
day

integer

اليوم من الشهر يجب أن يكون الرقم بين 1 و31 وأن يكون صالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر لا يكون فيه اليوم مهمًا.

ImageryQuality

جودة الصور المستخدَمة لاحتساب بعض نتائج واجهة برمجة التطبيقات

ملاحظة: بغض النظر عن مستوى جودة الصور، تكون دقة مخرجات DSM دائمًا 0.1 متر/وحدة بكسل، وتكون دقة مخرجات التدفق الشهرية دائمًا 0.5 متر/وحدة بكسل، وتكون دقة مخرجات الظل كل ساعة دائمًا 1 متر/وحدة بكسل.

عمليات التعداد
IMAGERY_QUALITY_UNSPECIFIED لا تتوفّر معلومات عن الجودة.
HIGH يتم استخلاص بيانات الطاقة الشمسية من الصور الجوية الملتقَطة على ارتفاع منخفض ومعالجتها بدقة 0.1 متر/بكسل.
MEDIUM يتم استخلاص بيانات الطاقة الشمسية من صور جوية محسّنة تم التقاطها على ارتفاعات عالية ومعالجتها بدقة 0.25 متر/بكسل.
BASE يتم استخراج بيانات الطاقة الشمسية من صور الأقمار الصناعية المحسّنة التي تتم معالجتها بدقة 0.25 متر/بكسل.

الطُرق

get

 الحصول على معلومات عن الأشعة الشمسية في منطقة محيطة بموقع جغرافي