REST Resource: dataLayers

المرجع: DataLayers

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

تمثيل 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 لصورة بيانات ذات نموذج أحمر أخضر أزرق (صورة جوية) للمنطقة
maskUrl

string

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

string

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

string

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

string

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

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

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

بشكل رسمي: بالاستناد إلى month (من 1 إلى 12) وday (شهر واحد كحد أقصى، و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 تمت معالجة الصور الأساسية وبيانات DSM بسرعة 0.1 م/بكسل.
MEDIUM تمت معالجة الصور الأساسية وبيانات DSM بسرعة 0.25 م/بكسل.
LOW تمت معالجة الصور الأساسية وبيانات DSM بسرعة 0.5 م/بكسل.

الطُرق

get

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