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