REST Resource: dataLayers

משאב: DataLayers

מידע על הפוטנציאל הסולארי באזור מסוים. הנתונים בפועל כלולים במספר קובצי GeoTIFF שמכסים את האזור המבוקש, וההודעה הזו מכילה כתובות URL שלהם: כל מחרוזת בהודעה DataLayers מכילה כתובת URL שממנה אפשר לאחזר את קובץ ה-GeoTIFF המתאים. כתובות ה-URL האלה תקפות למשך כמה שעות אחרי שהן נוצרות. רוב קובצי GeoTIFF הם ברזולוציה של 0.1 מטר לפיקסל, אבל קובץ השטף החודשי הוא ברזולוציה של 0.5 מטר לפיקסל, וקובצי הצללה לפי שעה הם ברזולוציה של מטר אחד לפיקסל. אם צוין ערך 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 של מפת שטף האנרגיה השנתית (קרינת שמש שנתית על גגות) באזור. הערכים הם קוט"ש/קילוואט/שנה. זהו שטף לא מוסתר: השטף מחושב לכל מיקום, לא רק לגגות של מבנים. מיקומים לא תקינים מאוחסנים כ-9999-: מיקומים מחוץ לאזור הכיסוי שלנו יהיו לא תקינים, וכך גם כמה מיקומים בתוך אזור הכיסוי, שבהם לא הצלחנו לחשב את השטף.
monthlyFluxUrl

string

כתובת ה-URL של מפת השינויים החודשית (כמות אור השמש על הגגות, בפירוט לפי חודש) של האזור. הערכים הם קוט"ש/קילוואט/שנה. קובץ ה-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...month max; February has 28 days) ו-hour (0-23), הצל או השמש לאותו חודש/יום/שעה במיקום (x, y) הם הביט

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

כאשר (x, y) הוא אינדוקס מרחבי, [month - 1] מתייחס לאחזור כתובת ה-URL ה-month - 1 (אינדוקס מאפס), [hour] הוא אינדוקס לערוצים, ותוצאה סופית שאינה אפס פירושה 'שמשי'. אין ימים מעוברים, ואין שעון קיץ (כל הימים הם באורך 24 שעות; השעה 12:00 היא תמיד השעה 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 מ' לכל פיקסל.
BASE הנתונים הסולאריים נגזרים מצילומי לוויין משופרים שעברו עיבוד ברזולוציה של 0.25 מ' לכל פיקסל.

Methods

get

 קבלת מידע סולארי על אזור מסוים.