درباره فایل های GeoTIFF

نقطه پایانی dataLayers داده‌هایی را که به صورت فایل‌های GeoTIFF کدگذاری شده‌اند، برمی‌گرداند که می‌توانند در هر برنامه سیستم اطلاعات جغرافیایی (GIS) برای طراحی سیستم‌های خورشیدی استفاده شوند.

هر رشته در پاسخ dataLayers حاوی یک URL است که می توانید از آن برای واکشی GeoTIFF مربوطه استفاده کنید. URL ها تا یک ساعت پس از تولید از درخواست لایه های داده اصلی معتبر هستند. فایل های GeoTIFF را می توان تا 30 روز ذخیره کرد.

به استثنای لایه RGB، فایل‌های GeoTIFF به درستی با نمایشگر تصویر نمایش داده نمی‌شوند، زیرا محتوا به جای تصاویر RGB، داده‌های کدگذاری شده است. فایل‌های GeoTIFF نیز نمی‌توانند مستقیماً به‌عنوان تصویر همپوشانی با Maps Javascript API استفاده شوند.

جدول زیر هر لایه را با جزئیات توضیح می دهد.

لایه	عمق پیکسل	قطعنامه	توضیحات
مدل سطح دیجیتال (DSM)	شناور 32 بیتی	0.1 متر بر پیکسل	داده های ارتفاعی که نشان دهنده توپوگرافی سطح زمین، از جمله ویژگی های طبیعی و ساخته شده است. مقادیر بر حسب متر بالاتر از سطح دریا می باشد. مکان‌های نامعتبر یا مناطقی که داده‌ای نداریم، به‌عنوان -9999 ذخیره می‌شوند.
RGB	8 بیتی	0.1 متر بر پیکسل 0.25 متر بر پیکسل 0.5 متر بر پیکسل 1 متر بر پیکسل	تصویر هوایی از منطقه فایل تصویری GeoTIFF شامل سه باند مربوط به مقادیر قرمز، سبز و آبی است تا مقدار RGB 24 بیتی را برای هر پیکسل تشکیل دهد. به طور پیش فرض، وضوح پیکسل 0.1 متر بر پیکسل است.
ماسک ساختمانی	1 بیتی	0.1 متر بر پیکسل	یک بیت در هر پیکسل نشان می دهد که آیا آن پیکسل به عنوان بخشی از پشت بام در نظر گرفته می شود.
شار سالانه	شناور 32 بیتی	0.1 متر بر پیکسل	نقشه شار سالانه یا نور سالانه خورشید بر روی پشت بام‌های منطقه. مقادیر kWh/kW/year هستند. Flux برای هر مکان محاسبه می شود، نه فقط برای ساخت پشت بام ها. مکان‌های نامعتبر، یا مناطقی که نتوانستیم شار را محاسبه کنیم، به‌عنوان -9999 ذخیره می‌شوند. مکان‌های خارج از منطقه تحت پوشش ما نامعتبر هستند. توجه: این شار بدون نقاب است.
شار ماهانه	شناور 32 بیتی	0.5 متر بر پیکسل	نقشه شار ماهانه (نور خورشید روی پشت بام ها به تفکیک ماه) منطقه. مقادیر kWh/kW/year هستند. فایل تصویری GeoTIFF به ترتیب شامل 12 باند مربوط به ژانویه تا دسامبر است.
سایه ساعتی	عدد صحیح 32 بیتی	1 متر بر پیکسل	12 URL برای نقشه های سایه ساعتی مربوط به ژانویه تا دسامبر، به ترتیب. هر فایل GeoTIFF شامل 24 باند، مربوط به 24 ساعت روز است. هر پیکسل یک عدد صحیح 32 بیتی است که مربوط به (تا) 31 روز آن ماه است. بیت 1 به این معنی است که مکان مربوطه می تواند خورشید را در آن روز، در آن ساعت، در آن ماه ببیند. مکان‌های نامعتبر به‌عنوان -9999 ذخیره می‌شوند و دارای بیت 31 هستند، زیرا مربوط به روز 32 ماه است و بنابراین نامعتبر است.

رسترهای سایه ساعتی را رمزگشایی کنید

داده های سایه ساعتی در شطرنجی های چند باندی کدگذاری می شوند. برای کسب اطلاعات بیشتر در مورد اصول شطرنجی، به مفاهیم API خورشیدی مراجعه کنید.

هنگامی که درخواستی برای داده‌های سایه ساعتی ارائه می‌کنید، می‌توانید حداکثر 12 شطرنجی، یکی برای هر ماه از سال تقویم (ژانویه تا دسامبر) دریافت کنید. هر شطرنجی از 24 لایه یا نوار تشکیل شده است که مربوط به 24 ساعت روز است.

هر باند با ماتریسی از سلول ها یا پیکسل ها نشان داده می شود. هر پیکسل دارای عمق 32 بیت است که مربوط به (حداکثر) 31 روز ماه است. بنابراین رمزگشایی روز، زمان و ماه داده های سایه نیازمند درک بیت، باند و شطرنجی است که شما در حال تجزیه و تحلیل هستید.

به عنوان مثال، برای تشخیص اینکه آیا یک مکان مشخص در مختصات (x، y) خورشید را در ساعت 4:00 بعد از ظهر روز 22 ژوئن دیده است یا خیر، موارد زیر را انجام دهید:

1. یک درخواست لایه داده برای همه لایه ها برای مکان (x, y) ایجاد کنید.
2. از آنجایی که ماه ژوئن ششمین ماه سال است، ششمین URL را در لیست hourlyShadeUrls واکشی کنید.
3. باندهای ساعتی در 24 ساعت ارائه می شود. برای دریافت اطلاعات ساعت 16:00 (16:00)، کانال هفدهم را جستجو کنید.
4. شاخص بیت (روز) از 0. برای دریافت اطلاعات روز 22 ژوئن، بیت 21 را بخوانید.
5. بیت ها داده های دودویی را ارائه می دهند که نشان می دهد آیا آن مکان خورشید را در تاریخ و زمان معین دیده است یا خیر. اگر بیت 1 باشد، مکان خورشید را دید. اگر بیت 0 باشد، محل سایه را دید.

کد زیر مراحل بالا را خلاصه می کند:

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

توجه: داده های سایه ساعتی بر اساس منطقه زمانی منطقه ای مکان درخواستی است. داده‌های سایه ساعتی همچنین فرض می‌کنند که روزهای کبیسه وجود ندارد و ساعت تابستانی وجود ندارد. تمام روزها 24 ساعت در نظر گرفته می شود و ظهر همیشه "زمان استاندارد" ظهر (12:00) است.

،

نقطه پایانی dataLayers داده‌هایی را که به صورت فایل‌های GeoTIFF کدگذاری شده‌اند، برمی‌گرداند که می‌توانند در هر برنامه سیستم اطلاعات جغرافیایی (GIS) برای طراحی سیستم‌های خورشیدی استفاده شوند.

هر رشته در پاسخ dataLayers حاوی یک URL است که می توانید از آن برای واکشی GeoTIFF مربوطه استفاده کنید. URL ها تا یک ساعت پس از تولید از درخواست لایه های داده اصلی معتبر هستند. فایل های GeoTIFF را می توان تا 30 روز ذخیره کرد.

به استثنای لایه RGB، فایل‌های GeoTIFF به درستی با نمایشگر تصویر نمایش داده نمی‌شوند، زیرا محتوا به جای تصاویر RGB، داده‌های کدگذاری شده است. فایل‌های GeoTIFF نیز نمی‌توانند مستقیماً به‌عنوان تصویر همپوشانی با Maps Javascript API استفاده شوند.

جدول زیر هر لایه را با جزئیات توضیح می دهد.

لایه	عمق پیکسل	قطعنامه	توضیحات
مدل سطح دیجیتال (DSM)	شناور 32 بیتی	0.1 متر بر پیکسل	داده های ارتفاعی که نشان دهنده توپوگرافی سطح زمین، از جمله ویژگی های طبیعی و ساخته شده است. مقادیر بر حسب متر بالاتر از سطح دریا می باشد. مکان‌های نامعتبر یا مناطقی که داده‌ای نداریم، به‌عنوان -9999 ذخیره می‌شوند.
RGB	8 بیتی	0.1 متر بر پیکسل 0.25 متر بر پیکسل 0.5 متر بر پیکسل 1 متر بر پیکسل	تصویر هوایی از منطقه فایل تصویری GeoTIFF شامل سه باند مربوط به مقادیر قرمز، سبز و آبی است تا مقدار RGB 24 بیتی را برای هر پیکسل تشکیل دهد. به طور پیش فرض، وضوح پیکسل 0.1 متر بر پیکسل است.
ماسک ساختمانی	1 بیتی	0.1 متر بر پیکسل	یک بیت در هر پیکسل نشان می دهد که آیا آن پیکسل به عنوان بخشی از پشت بام در نظر گرفته می شود.
شار سالانه	شناور 32 بیتی	0.1 متر بر پیکسل	نقشه شار سالانه یا نور سالانه خورشید بر روی پشت بام‌های منطقه. مقادیر kWh/kW/year هستند. Flux برای هر مکان محاسبه می شود، نه فقط برای ساخت پشت بام ها. مکان‌های نامعتبر، یا مناطقی که نتوانستیم شار را محاسبه کنیم، به‌عنوان -9999 ذخیره می‌شوند. مکان‌های خارج از منطقه تحت پوشش ما نامعتبر هستند. توجه: این شار بدون نقاب است.
شار ماهانه	شناور 32 بیتی	0.5 متر بر پیکسل	نقشه شار ماهانه (نور خورشید روی پشت بام ها به تفکیک ماه) منطقه. مقادیر kWh/kW/year هستند. فایل تصویری GeoTIFF به ترتیب شامل 12 باند مربوط به ژانویه تا دسامبر است.
سایه ساعتی	عدد صحیح 32 بیتی	1 متر بر پیکسل	12 URL برای نقشه های سایه ساعتی مربوط به ژانویه تا دسامبر، به ترتیب. هر فایل GeoTIFF شامل 24 باند، مربوط به 24 ساعت روز است. هر پیکسل یک عدد صحیح 32 بیتی است که مربوط به (تا) 31 روز آن ماه است. بیت 1 به این معنی است که مکان مربوطه می تواند خورشید را در آن روز، در آن ساعت، در آن ماه ببیند. مکان‌های نامعتبر به‌عنوان -9999 ذخیره می‌شوند و دارای بیت 31 هستند، زیرا مربوط به روز 32 ماه است و بنابراین نامعتبر است.

رسترهای سایه ساعتی را رمزگشایی کنید

داده های سایه ساعتی در شطرنجی های چند باندی کدگذاری می شوند. برای کسب اطلاعات بیشتر در مورد اصول شطرنجی، به مفاهیم API خورشیدی مراجعه کنید.

هنگامی که درخواستی برای داده‌های سایه ساعتی ارائه می‌کنید، می‌توانید حداکثر 12 شطرنجی، یکی برای هر ماه از سال تقویم (ژانویه تا دسامبر) دریافت کنید. هر شطرنجی از 24 لایه یا نوار تشکیل شده است که مربوط به 24 ساعت روز است.

هر باند با ماتریسی از سلول ها یا پیکسل ها نشان داده می شود. هر پیکسل دارای عمق 32 بیت است که مربوط به (حداکثر) 31 روز ماه است. بنابراین رمزگشایی روز، زمان و ماه داده های سایه نیازمند درک بیت، باند و شطرنجی است که شما در حال تجزیه و تحلیل هستید.

به عنوان مثال، برای تشخیص اینکه آیا یک مکان مشخص در مختصات (x، y) خورشید را در ساعت 4:00 بعد از ظهر روز 22 ژوئن دیده است یا خیر، موارد زیر را انجام دهید:

1. یک درخواست لایه داده برای همه لایه ها برای مکان (x, y) ایجاد کنید.
2. از آنجایی که ماه ژوئن ششمین ماه سال است، ششمین URL را در لیست hourlyShadeUrls واکشی کنید.
3. باندهای ساعتی در 24 ساعت ارائه می شود. برای دریافت اطلاعات ساعت 16:00 (16:00)، کانال هفدهم را جستجو کنید.
4. شاخص بیت (روز) از 0. برای دریافت اطلاعات روز 22 ژوئن، بیت 21 را بخوانید.
5. بیت ها داده های دودویی را ارائه می دهند که نشان می دهد آیا آن مکان خورشید را در تاریخ و زمان معین دیده است یا خیر. اگر بیت 1 باشد، مکان خورشید را دید. اگر بیت 0 باشد، محل سایه را دید.

کد زیر مراحل بالا را خلاصه می کند:

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

توجه: داده های سایه ساعتی بر اساس منطقه زمانی منطقه ای مکان درخواستی است. داده‌های سایه ساعتی همچنین فرض می‌کنند که روزهای کبیسه وجود ندارد و ساعت تابستانی وجود ندارد. تمام روزها 24 ساعت در نظر گرفته می شود و ظهر همیشه "زمان استاندارد" ظهر (12:00) است.