REST Resource: dataLayers

מקור מידע: DataLayers

מידע על הפוטנציאל הסולארי של אזור מסוים. הנתונים בפועל נכללים במספר קובצי GeoTIFF שמכסים את האזור המבוקש, וההודעה הזו מכילה את כתובות ה-URL שלהם: כל מחרוזת בהודעה DataLayers מכילה כתובת URL שממנה אפשר לאחזר את קובץ ה-GeoTIFF התואם. כתובות ה-URL האלה תקפות למשך כמה שעות אחרי שהן נוצרות. רוב קובצי GeoTIFF הם ברזולוציה של 0.1 מ'/פיקסל, אבל קובץ הזרימה החודשית הוא ברזולוציה של 0.5 מ'/פיקסל וקובצי ההצללה השעתיים הם ברזולוציה של 1 מ'/פיקסל. אם צוין ערך pixelSizeMeters ב-GetDataLayersRequest, הערך הזה יהיה הרזולוציה המינימלית בקובצי GeoTIFF.

ייצוג ב-JSON 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
שדות
imageryDate

object (Date)

מתי צולמה התמונה המקורית (שממנה נגזרים כל שאר הנתונים) באזור הזה. התוצאה היא תמיד משוערת במידה מסוימת, כי יכול להיות שהתמונות צולמו במהלך יותר מיום אחד.
imageryProcessedDate

object (Date)

מתי הסתיים העיבוד של התמונות האלה.
dsmUrl

string

כתובת ה-URL של תמונה של DSM (מודל דיגיטלי של פני השטח) של האזור. הערכים הם במטרים מעל פני הים (כלומר, מעל הגיאואיד EGM96). מיקומים לא חוקיים (שלא יש לנו נתונים לגביהם) נשמרים כ-9999-.
rgbUrl

string

כתובת ה-URL של תמונה עם נתוני RGB (תמונה אווירית) של האזור.
maskUrl

string

כתובת ה-URL של תמונת המסכה של הבניין: ביט אחד לכל פיקסל, שמציין אם הפיקסל נחשב לחלק מגג או לא.
annualFluxUrl

string

כתובת ה-URL של מפת הזרימה השנתית (קרינת השמש השנתית על הגגות) של האזור. הערכים הם קוט"ש/kW/שנה. זהו השדה 'flux' ללא אנונימיזציה': השדה 'flux' מחושב לכל מיקום, ולא רק לגגות של בניינים. מיקומים לא חוקיים מאוחסנים כ-9999-: מיקומים מחוץ לאזור הכיסוי שלנו יהיו לא חוקיים, וגם כמה מיקומים בתוך אזור הכיסוי שבהם לא הצלחנו לחשב את הזרימה יהיו לא חוקיים.
monthlyFluxUrl

string

כתובת ה-URL של מפת הזרימה החודשית (אור שמש על גגות, פירוט לפי חודש) של האזור. הערכים הם קוט"ש/kW/שנה. קובץ ה-GeoTIFF שכתובתו מופיעה בכתובת ה-URL הזו יכיל 12 פסים, בהתאמה לינואר עד דצמבר, לפי הסדר.
hourlyShadeUrls[]

string

12 כתובות URL של צל שעתי, בהתאמה לינואר עד דצמבר, לפי הסדר. כל קובץ GeoTIFF יכיל 24 פסים, בהתאם ל-24 השעות ביום. כל פיקסל הוא מספר שלם של 32 ביט, שתואם ל-31 הימים (לכל היותר) באותו חודש. ביט אחד (1) מציין שהמיקום התואם יכול לראות את השמש באותו יום, באותה שעה, באותו חודש. מיקומים לא חוקיים מאוחסנים כ--9999 (מכיוון שהערך הזה שלילי, ביט 31 מוגדר בו, ואף ערך חוקי לא יכול לכלול הגדרה של ביט 31 כי זה יתאים ליום ה-32 בחודש).

כדאי להיעזר בדוגמה. אם רוצים לדעת אם נקודה (במיקום הפיקסל (x, y)) ראתה שמש בשעה 16:00 ב-22 ביוני, צריך:

  1. לאחזר את כתובת ה-URL השישית ברשימה הזו (שמתאימת לחודש יוני).
  2. מחפשים את הערוץ ה-17 (שמתאים לשעה 16:00).
  3. קריאת הערך של 32 הביט ב-(x, y).
  4. קוראים את ביט 21 של הערך (התואמת ל-22 בחודש).
  5. אם הביט הזה הוא 1, אז השמש זרחה באותו מקום בשעה 16:00 ב-22 ביוני.

באופן רשמי יותר: בהינתן month (1-12), day (1…חודש מקסימלי; בפברואר יש 28 ימים) ו-hour (0-23), הצל/השמש באותו חודש/יום/שעה במיקום (x, y) הוא הבייט

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

כאשר (x, y) הוא הוספה של מיקומים גיאוגרפיים לאינדקס, [month - 1] מתייחס לאחזור של כתובת ה-URL ה-month - 1 (הוספה לאינדקס מ-0), [hour] הוא הוספה של מיקומים גיאוגרפיים לערוצים ותוצאה סופית שאינה אפס פירושה 'שמש זורחת'. אין ימים מעוקבים, ולא קיים שעון קיץ (כל הימים נמשכים 24 שעות, והשעה 12:00 היא תמיד 'שעון רגיל').
imageryQuality

enum (ImageryQuality)

איכות התמונות בתוצאה.

תאריך

מייצג תאריך קלנדרי מלא או חלקי, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או שהם לא חשובים. התאריך מתייחס ליומן הגרגוריאני. הערך הזה יכול לייצג אחת מהאפשרויות הבאות:

  • תאריך מלא, עם ערכים שונים מאפס לשנה, לחודש וליום.
  • חודש ויום, עם אפס בשנה (לדוגמה, יום נישואין).
  • שנה לבד, עם אפס חודש ואפס יום.
  • שנה וחודש, עם יום אפס (לדוגמה, תאריך תפוגת תוקף של כרטיס אשראי).

סוגים קשורים:

ייצוג ב-JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

השנה של התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.
month

integer

החודש בשנה. הערך צריך להיות בין 1 ל-12, או 0 כדי לציין שנה ללא חודש ויום.
day

integer

היום בחודש. הערך חייב להיות בין 1 ל-31 ותקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם היום לא רלוונטי.

ImageryQuality

האיכות של התמונות ששימשו לחישוב תוצאות מסוימות של ממשק API.

הערה: ללא קשר לרמת האיכות של התמונות, תמיד תהיה לרזולוציה של פלט DSM ערך של 0.1 מ'/פיקסל, לרזולוציה של פלט של זרימה חודשית ערך של 0.5 מ'/פיקסל ולרזולוציה של פלט של צל שעתי ערך של 1 מ'/פיקסל.

טיפוסים בני מנייה (enum)
IMAGERY_QUALITY_UNSPECIFIED איכות לא ידועה.
HIGH הנתונים הסולאריים מבוססים על תמונות אוויר שצולמו בגובה נמוך ועובדו ברזולוציה של 0.1 מ'/פיקסל.
MEDIUM נתוני האנרגיה הסולארית מבוססים על תמונות אוויר משופרות שצולמו בגובה רב ועובדו ברזולוציה של 0.25 מ'/פיקסל.
LOW נתוני האנרגיה הסולארית מבוססים על צילומי לוויין משופרים שעברו עיבוד ברזולוציה של 0.25 מ'/פיקסל.

Methods

get

 אחזור מידע על אנרגיה סולארית באזור שמקיף מיקום מסוים.