REST Resource: 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) نقشه شار سالانه (میزان تابش نور خورشید سالانه بر روی پشت بام‌ها) منطقه. مقادیر بر حسب کیلووات ساعت بر کیلووات ساعت بر سال است. این شار بدون پوشش است: شار برای هر مکان محاسبه می‌شود، نه فقط پشت بام ساختمان‌ها. مکان‌های نامعتبر به صورت -۹۹۹۹ ذخیره می‌شوند: مکان‌های خارج از منطقه پوشش ما نامعتبر خواهند بود و چند مکان داخل منطقه پوشش، که نتوانستیم شار را در آنها محاسبه کنیم، نیز نامعتبر خواهند بود.

monthlyFluxUrl

string

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

hourlyShadeUrls[]

string

دوازده URL برای سایه ساعتی، مربوط به ژانویه...دسامبر، به ترتیب. هر GeoTIFF شامل ۲۴ باند خواهد بود که مربوط به ۲۴ ساعت روز است. هر پیکسل یک عدد صحیح ۳۲ بیتی است که مربوط به (حداکثر) ۳۱ روز آن ماه است؛ بیت ۱ به این معنی است که مکان مربوطه قادر به دیدن خورشید در آن روز، آن ساعت، آن ماه است. مکان‌های نامعتبر به صورت -۹۹۹۹ ذخیره می‌شوند (از آنجایی که این منفی است، بیت ۳۱ روی آن تنظیم شده است و هیچ مقدار معتبری نمی‌تواند بیت ۳۱ را تنظیم کند زیرا این بیت مربوط به سی و دومین روز ماه خواهد بود).

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

  1. ششمین آدرس اینترنتی (مطابق با ماه ژوئن) را دریافت کنید.
  2. کانال هفدهم (مطابق با ساعت ۴ بعد از ظهر) را جستجو کنید.
  3. مقدار ۳۲ بیتی را در (x, y) بخوانید.
  4. بیت ۲۱ از مقدار (مطابق با بیست و دوم ماه) را بخوانید.
  5. اگر آن بیت ۱ باشد، آنگاه آن نقطه خورشید را در ساعت ۴ بعد از ظهر ۲۲ ژوئن دیده است.

به طور رسمی‌تر: با توجه به 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 ساعته هستند؛ ظهر همیشه "زمان استاندارد" ظهر است).

imageryQuality

enum ( ImageryQuality )

کیفیت تصاویر حاصل.

تاریخ

نشان دهنده یک تاریخ تقویمی کامل یا جزئی، مانند تاریخ تولد است. زمان روز و منطقه زمانی یا در جای دیگری مشخص شده‌اند یا اهمیت چندانی ندارند. تاریخ نسبت به تقویم میلادی است. این می‌تواند یکی از موارد زیر را نشان دهد:

  • یک تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر.
  • یک ماه و یک روز، با یک سال صفر (مثلاً یک سالگرد).
  • یک سال به تنهایی، با یک ماه صفر و یک روز صفر.
  • یک سال و یک ماه، با یک روز صفر (برای مثال، تاریخ انقضای کارت اعتباری).

انواع مرتبط:

نمایش JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
فیلدها
year

integer

سال تاریخ. باید از ۱ تا ۹۹۹۹ باشد، یا برای مشخص کردن تاریخ بدون سال، ۰ باشد.

month

integer

ماه سال. باید از ۱ تا ۱۲ باشد، یا برای مشخص کردن سال بدون ماه و روز، ۰ باشد.

day

integer

روز ماه. باید از ۱ تا ۳۱ باشد و برای سال و ماه معتبر باشد، یا ۰ برای مشخص کردن یک سال به تنهایی یا یک سال و ماه که روز در آن مهم نیست.

کیفیت تصویر

کیفیت تصویر مورد استفاده برای محاسبه‌ی برخی از نتایج API.

توجه: صرف نظر از سطح کیفیت تصویر، خروجی‌های DSM همیشه دارای وضوح ۰.۱ متر بر پیکسل، خروجی‌های شار ماهانه همیشه دارای وضوح ۰.۵ متر بر پیکسل و خروجی‌های سایه ساعتی همیشه دارای وضوح ۱ متر بر پیکسل هستند.

انوم‌ها
IMAGERY_QUALITY_UNSPECIFIED هیچ کیفیتی مشخص نیست.
HIGH داده‌های خورشیدی از تصاویر هوایی گرفته شده در ارتفاع پایین و پردازش شده با وضوح ۰.۱ متر بر پیکسل به دست می‌آیند.
MEDIUM داده‌های خورشیدی از تصاویر هوایی بهبود یافته‌ای که در ارتفاع بالا گرفته شده و با وضوح ۰.۲۵ متر بر پیکسل پردازش شده‌اند، استخراج می‌شوند.
BASE داده‌های خورشیدی از تصاویر ماهواره‌ای بهبود یافته که با وضوح ۰.۲۵ متر بر پیکسل پردازش شده‌اند، استخراج شده‌اند.

روش‌ها

get

 اطلاعات خورشیدی را برای منطقه‌ای اطراف یک مکان دریافت می‌کند.