REST Resource: dataLayers

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

object ( Date )

زمانی که تصویر منبع (که تمام داده های دیگر از آن استخراج شده اند) در این منطقه گرفته شد. لزوماً تا حدودی تقریبی است، زیرا ممکن است تصاویر بیش از یک روز گرفته شده باشند.

object ( Date )

زمانی که پردازش روی این تصویر تکمیل شد.

string

نشانی اینترنتی تصویری از DSM (مدل سطح دیجیتال) منطقه. مقادیر بر حسب متر بالاتر از ژئوئید EGM96 (یعنی سطح دریا) هستند. مکان های نامعتبر (جایی که داده نداریم) به عنوان -9999 ذخیره می شوند.

string

نشانی اینترنتی تصویری از داده های RGB (عکس هوایی) منطقه.

string

URL برای تصویر ماسک ساختمان: یک بیت در هر پیکسل نشان می دهد که آیا آن پیکسل بخشی از یک پشت بام در نظر گرفته می شود یا خیر.

string

نشانی اینترنتی نقشه شار سالانه (نور خورشید سالانه روی پشت بام ها) منطقه. مقادیر kWh/kW/year هستند. این شار بدون نقاب است: شار برای هر مکان محاسبه می‌شود، نه فقط پشت بام ساختمان. مکان‌های نامعتبر به‌عنوان -9999 ذخیره می‌شوند: مکان‌های خارج از منطقه تحت پوشش ما نامعتبر خواهند بود، و چند مکان در داخل منطقه تحت پوشش، که نتوانستیم شار را محاسبه کنیم، نیز نامعتبر خواهند بود.

string

نشانی اینترنتی نقشه شار ماهانه (نور خورشید روی پشت بام ها، تفکیک شده بر اساس ماه) منطقه. مقادیر kWh/kW/year هستند. GeoTIFF که توسط این URL به آن اشاره شده است به ترتیب شامل دوازده باند مربوط به ژانویه...دسامبر خواهد بود.

string

به ترتیب دوازده URL برای سایه ساعتی، مربوط به ژانویه...دسامبر. هر GeoTIFF شامل 24 باند، مربوط به 24 ساعت روز است. هر پیکسل یک عدد صحیح 32 بیتی است که مربوط به (تا) 31 روز آن ماه است. a 1 bit به این معنی است که مکان مربوطه می تواند خورشید را در آن روز، آن ساعت، آن ماه ببیند. مکان‌های نامعتبر به‌عنوان 9999- ذخیره می‌شوند (از آنجایی که این منفی است، بیت 31 تنظیم شده است، و هیچ مقدار معتبری نمی‌تواند بیت 31 را تنظیم کند که مطابق با روز 32 ماه باشد).

یک مثال ممکن است مفید باشد. اگر می خواهید بدانید که آیا نقطه ای (در مکان پیکسل (x، y)) خورشید را در ساعت 4 بعد از ظهر روز 22 ژوئن دیده است، باید:

1. ششمین URL در این لیست (مرتبط با ژوئن) را واکشی کنید.
2. کانال هفدهم (مطابق با ساعت 16) را جستجو کنید.
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] به واکشی نشانی اینترنتی month - 1 اشاره دارد (نمایه سازی از صفر)، [hour] نمایه سازی در کانال ها است، و نتیجه نهایی غیر صفر به معنای "آفتابی" است. . هیچ روز کبیسه وجود ندارد و DST وجود ندارد (تمام روزها 24 ساعت طول می کشد؛ ظهر همیشه ظهر "زمان استاندارد" است).

enum ( ImageryQuality )

کیفیت تصویر نتیجه

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

سال تاریخ. برای تعیین تاریخ بدون سال باید از 1 تا 9999 یا 0 باشد.

integer

ماه از یک سال. باید از 1 تا 12 یا 0 باشد تا یک سال بدون ماه و روز مشخص شود.

integer

روز یک ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا 0 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد.