נקודת הקצה dataLayers מחזירה נתונים שקודדו כקובצי GeoTIFF, שניתן להשתמש בהם בכל של מערכת מידע (GIS) לתכנון מערכות סולאריות.
כל מחרוזת בתגובת dataLayer מכילה כתובת URL, שאותה אפשר שבו משתמשים כדי לאחזר את קובץ GeoTIFF המתאים. כתובות ה-URL תקפות למשך עד שעה אחרי הם נוצרים מהבקשה המקורית של שכבות הנתונים. קובצי GeoTIFF יכולים יישמרו למשך עד 30 ימים.
פרט לשכבת ה-RGB, קובצי GeoTIFF לא מוצגים כראוי עם צופה בתמונות, כי התוכן מקודד בנתונים ולא בתמונות RGB. GeoTIFF כמו כן, אי אפשר להשתמש בקבצים באופן ישיר כתמונת שכבת-על באמצעות Maps JavaScript API.
בטבלה הבאה תמצאו הסבר מפורט על כל שכבה.
| שכבה | עומק בפיקסלים | רזולוציה | תיאור |
|---|---|---|---|
| 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) ראה את יום ראשון בשעה 16:00 ב-22 ביוני, יש לבצע את הפעולות הבאות:
- שליחת בקשה לשכבות נתונים עבור כל השכבות במיקום (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))