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 على أي قيمة صالحة لأنّ ذلك سيتوافق مع اليوم 32 من الشهر).

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

  1. استرجاع عنوان URL السادس في هذه القائمة (المرتبط بشهر حزيران/يونيو)
  2. ابحث عن القناة 17 (التي تقابل الساعة 4 مساءً).
  3. قراءة القيمة 32 بت في (x, y)
  4. قراءة الرقّم الثنائي 21 من القيمة (الموافق لليوم 22 من الشهر)
  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 متر لكل بكسل.
LOW يتم الحصول على بيانات الطاقة الشمسية من صور الأقمار الصناعية المحسّنة التي تمت معالجتها بدقة 0.25 متر لكل بكسل.

الطُرق

get

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