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

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

rgbUrl

string

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

maskUrl

string

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

annualFluxUrl

string

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

monthlyFluxUrl

string

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

hourlyShadeUrls[]

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

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

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

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

Enums
IMAGERY_QUALITY_UNSPECIFIED کیفیتی مشخص نیست
HIGH تصاویر زیربنایی و داده های DSM با سرعت 0.1 متر بر پیکسل پردازش شدند.
MEDIUM تصاویر زیربنایی و داده های DSM با 0.25 متر بر پیکسل پردازش شدند.
LOW تصاویر زیربنایی و داده‌های DSM با سرعت 0.5 متر بر پیکسل پردازش شدند.

روش ها

get

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