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

string

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

string

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

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

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

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

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

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

טיפוסים בני מנייה (enums)
IMAGERY_QUALITY_UNSPECIFIED לא ידועה איכות.
HIGH התמונות הבסיסיות ונתוני ה-DSM עובדו ב-0.1 מטר לפיקסל.
MEDIUM התמונות הבסיסיות ונתוני ה-DSM עובדו בקצב של 0.25 מטר לפיקסל.
LOW התמונות הבסיסיות ונתוני ה-DSM עובדו במהירות של 0.5 מטר לפיקסל.

שיטות

get

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