REST Resource: dataLayers

משאב: DataLayers

מידע על הפוטנציאל הסולארי של אזור מסוים. הנתונים בפועל נמצאים בכמה קובצי GeoTIFF לגבי האזור המבוקש. ההודעה הזו מכילה כתובות URL. כל מחרוזת בהודעה DataLayers מכילה כתובת URL שממנה ניתן לאחזר את קובץ GeoTIFF התואם. כתובות ה-URL האלה תקפות למשך כמה שעות אחרי שהן נוצרו. רוב קובצי GeoTIFF הם ברזולוציה של 0.1 m לפיקסל, אבל קובץ ה-Flux החודשי הוא 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 (1...לחודש לכל היותר, פברואר כולל 28 ימים) ו-hour (0-23), הצללה/שמש באותו חודש/יום/שעה במיקום (x, y) הוא הערך המינימלי

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

כאשר (x, y) הוא אינדקס מרחבי, [month - 1] מתייחס לאחזור month - 1 כתובת ה-URL ביותר (הוספה לאינדקס מאפס), [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 מטר לפיקסל.

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

שיטות

get

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