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