נקודת הקצה dataLayers מחזירה נתונים שמקודדים כקובצי GeoTIFF, שאפשר להשתמש בהם בכל אפליקציה של מערכת מידע גיאוגרפי (GIS) כדי לתכנן מערכות סולאריות.
כל מחרוזת בתגובה של dataLayers מכילה כתובת URL, שאפשר להשתמש בה כדי לאחזר את קובץ ה-GeoTIFF התואם. כתובות ה-URL תקפות למשך שעה אחת בלבד אחרי שהן נוצרות מהבקשה המקורית של שכבות הנתונים. אפשר לאחסן קבצי GeoTIFF למשך עד 30 ימים.
מלבד שכבת ה-RGB, קובצי GeoTIFF לא מוצגים בצורה נכונה בתוכנת הצגת תמונות, כי התוכן הוא נתונים מקודדים ולא תמונות RGB. בנוסף, אי אפשר להשתמש בקובצי GeoTIFF ישירות כתמונה שכבת-על באמצעות Maps Javascript API.
בטבלה הבאה מפורט תיאור של כל שכבה.
| שכבה | עומק פיקסלים | רזולוציה | תיאור |
|---|---|---|---|
| מודלים דיגיטליים של פני השטח (DSM) | מספר ממשי (float) ב-32 ביט | 0.1 מ'/פיקסל | נתוני גובה שמייצגים את הטופוגרפיה של פני כדור הארץ, כולל תכונות טבעיות ומבנים. הערכים מוצגים במטרים מעל פני הים. מיקומים לא חוקיים או אזורים שבהם אין לנו נתונים מאוחסנים כ-9999-. |
| RGB | 8 סיביות | 0.1 מ'/פיקסל 0.25 מ'/פיקסל 0.5 מ'/פיקסל 1 מ'/פיקסל |
תמונה אווירית של האזור. קובץ התמונות בפורמט GeoTIFF מכיל שלושה פסים שתואמים לערכי אדום, ירוק וכחול, כדי ליצור ערך RGB של 24 ביט לכל פיקסל. ברירת המחדל של רזולוציית הפיקסלים היא 0.1 מ' לפיקסל. |
| מסכה של בניין | 1-bit | 0.1 מ'/פיקסל | ביט אחד לכל פיקסל, שמציין אם הפיקסל נחשב כחלק מחלפת גג. |
| תנועה שנתית | מספר ממשי (float) ב-32 ביט | 0.1 מ'/פיקסל | מפת הזרימה השנתית, או כמות אור השמש השנתית על הגגות, של האזור.
הערכים הם קוט"ש/kW/שנה. הזרימה מחושבת לכל מיקום, ולא רק לגגות של מבנים. מיקומים לא חוקיים או אזורים שבהם לא הצלחנו לחשב את הזרימה מאוחסנים כ-9999. מיקומים מחוץ לאזור הכיסוי שלנו לא חוקיים. הערה: זהו flux ללא אנונימיזציה. |
| תנועה חודשית | מספר ממשי (float) ב-32 ביט | 0.5 מ'/פיקסל | מפת הזרימה החודשית (אור שמש על גגות, פירוט לפי חודש) של האזור. הערכים הם קוט"ש/kW/שנה. קובץ התמונות בפורמט GeoTIFF מכיל 12 פסים שמייצגים את החודשים בינואר עד דצמבר, לפי הסדר. |
| צל שעתי | מספר שלם (integer) ב-32 ביט | 1 מ'/פיקסל | 12 כתובות URL למפות צל שעתיות שתואמות לינואר עד דצמבר, לפי הסדר. כל קובץ GeoTIFF מכיל 24 פסים, בהתאם ל-24 השעות ביום. כל פיקסל הוא מספר שלם של 32 ביט, שתואם ל-31 הימים (עד) באותו חודש. ביט אחד (1) מציין שהמיקום התואם יכול לראות את השמש באותו יום, בשעה הזו, באותו חודש. מיקומים לא חוקיים נשמרים כ--9999, והביט 31 מוגדר, כי הוא תואם ליום ה-32 בחודש ולכן הוא לא חוקי. |
פענוח של רסטר שעתי של צל
נתוני ההצללה השעתיים מקודדים ברצפי רסטר עם כמה פסים. מידע נוסף על מושגי יסוד של רסטר זמין במאמר מושגי Solar API.
כששולחים בקשה לנתוני צל שעתיים, אפשר לקבל עד 12 רסטר, אחד לכל חודש בשנה הקלנדרית (ינואר עד דצמבר). כל רסטר מורכב מ-24 שכבות, או רצועות, שתואמות ל-24 השעות ביום.
כל פס מיוצג על ידי מטריצה של תאים, או פיקסלים. לכל פיקסל יש עומק של 32 ביט, שתואם ל-31 הימים (מקסימום) בחודש. לכן, כדי לפענח את היום, השעה והחודש של נתוני ההצללה, צריך להבין את הביט, את הפס ואת הרסטור שאותם מנתחים.
לדוגמה, כדי לבדוק אם השמש זרחה בשעה 16:00 ב-22 ביוני במיקום מסוים בקואורדינטות (x, y), מבצעים את הפעולות הבאות:
- שולחים בקשה לשכבות נתונים לכל השכבות במיקום (x, y).
- מאחר שחודש יוני הוא החודש השישי בשנה, צריך לאחזר את כתובת ה-URL השישית ברשימת
hourlyShadeUrls. - טווחי השעות מוצגים לפי שעון 24 שעות. כדי לקבל נתונים לגבי השעה 16:00, צריך לחפש את הערוץ ה-17.
- האינדקס של הביטים (הימים) מתחיל ב-0. כדי לקבל נתונים לגבי היום ה-22 ביוני, קוראים את הפיט 21.
- הביטים מספקים נתונים בינאריים שמציינים אם השמש זרחה במיקום הזה בתאריך ובשעה הנתונים. אם הבייט הוא 1, המיקום ראה שמש. אם הבייט הוא 0, המשמעות היא שהמיקום היה מוצל.
הקוד הבא מסכם את השלבים שלמעלה:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))