REST Resource: dataLayers

المرجع: DataLayers

معلومات عن إمكانات توليد الطاقة الشمسية في إحدى المناطق. ويتم تضمين البيانات الفعلية في عدد من ملفات GeoTIFF التي تغطي المنطقة المطلوبة، والتي تحتوي هذه الرسالة على عناوين URL لها: تحتوي كل سلسلة في رسالة DataLayers على عنوان URL يمكن جلب GeoTIFF منه منه. تكون عناوين URL هذه صالحة لبضع ساعات بعد إنشائها. تبلغ دقة معظم ملفات GeoTIFF 1.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 لصورة بيانات نموذج أحمر أخضر أزرق (صورة من الجو) للمنطقة.
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 من الشهر).

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

  1. جلب عنوان URL السادس في هذه القائمة (المتوافق مع حزيران/يونيو).
  2. ابحث عن القناة السابعة عشرة (في الساعة 4 مساءً).
  3. قراءة قيمة 32 بت في (س، ص).
  4. قراءة البت 21 من القيمة (يقابل الثاني والعشرين من الشهر).
  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] في القنوات، بينما تشير النتيجة النهائية بقيمة غير صفرية إلى "مشمس". ولا توجد أيام كبيسة، ولا يوجد DST (تكون كل الأيام 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

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