Package google.maps.solar.v1

אינדקס

• Solar (ממשק)
• BuildingInsights (הודעה)
• CashPurchaseSavings (הודעה)
• DataLayerView (enum)
• DataLayers (הודעה)
• FinancedPurchaseSavings (הודעה)
• FinancialAnalysis (הודעה)
• FinancialDetails (הודעה)
• FindClosestBuildingInsightsRequest (הודעה)
• GetDataLayersRequest (הודעה)
• GetGeoTiffRequest (הודעה)
• ImageryQuality (enum)
• LatLngBox (הודעה)
• LeasingSavings (הודעה)
• RoofSegmentSizeAndSunshineStats (הודעה)
• RoofSegmentSummary (הודעה)
• SavingsOverTime (הודעה)
• SizeAndSunshineStats (הודעה)
• SolarPanel (הודעה)
• SolarPanelConfig (הודעה)
• SolarPanelOrientation (enum)
• SolarPotential (הודעה)

שמש

הגדרת השירות של Solar API.

FindClosestBuildingInsights
rpc FindClosestBuildingInsights(FindClosestBuildingInsightsRequest) returns (BuildingInsights) מאתר את הבניין שהמוקד שלו קרוב ביותר לנקודת השאילתה. הפונקציה מחזירה שגיאה עם קוד NOT_FOUND אם אין בניינים במרחק של כ-50 מ' מנקודת השאילתה. היקפי הרשאה נדרש היקף הרשאות OAuth הבא: https://www.googleapis.com/auth/cloud-platform

GetDataLayers
rpc GetDataLayers(GetDataLayersRequest) returns (DataLayers) אחזור מידע על אנרגיה סולארית באזור שמקיף מיקום מסוים. הפונקציה מחזירה שגיאה עם קוד NOT_FOUND אם המיקום נמצא מחוץ לאזור הכיסוי. היקפי הרשאה נדרש היקף הרשאות OAuth הבא: https://www.googleapis.com/auth/cloud-platform

GetGeoTiff
rpc GetGeoTiff(GetGeoTiffRequest) returns (HttpBody) הפונקציה מחזירה תמונה לפי המזהה שלה. היקפי הרשאה נדרש היקף הרשאות OAuth הבא: https://www.googleapis.com/auth/cloud-platform

BuildingInsights

הודעת התגובה עבור Solar.FindClosestBuildingInsights. מידע על המיקום, המימדים והפוטנציאל הסולארי של מבנה.

שדות
name	string שם המשאב של הבניין, בפורמט buildings/{place_id}.
center	LatLng נקודה ליד מרכז המבנה.
bounding_box	LatLngBox התיבה התוחמת (bounding box) של המבנה.
imagery_date	Date התאריך שבו התמונות הבסיסיות נרכשו. הערך הזה הוא משוער.
imagery_processed_date	Date מתי הסתיים העיבוד של התמונות האלה.
postal_code	string מיקוד (למשל, מיקוד בארה"ב) שבו נמצא המבנה.
administrative_area	string אזור 1 (למשל, בארצות הברית, המדינה) שמכיל את הבניין הזה. לדוגמה, בארה"ב, הקיצור יכול להיות 'MA' או 'CA'.
statistical_area	string אזור סטטיסטי (למשל, אזור אוכלוסין בארה"ב) שבו נמצא הבניין.
region_code	string קוד האזור של המדינה (או האזור) שבה נמצא הבניין.
solar_potential	SolarPotential הפוטנציאל הסולארי של המבנה.
imagery_quality	ImageryQuality איכות התמונות ששימשו לחישוב הנתונים של הבניין הזה.

CashPurchaseSavings

העלות והתועלת של רכישה מיידית של הגדרה מסוימת של לוחות סולאריים עם שימוש מסוים בחשמל.

שדות
out_of_pocket_cost	Money העלות הראשונית לפני תמריצי המס: הסכום שצריך לשלם מכיסכם. בניגוד לערך upfront_cost, שמתייחס לנתונים אחרי תמריצי המס.
upfront_cost	Money העלות הראשונית אחרי תמריצי המס: הסכום שצריך לשלם במהלך השנה הראשונה. לעומת out_of_pocket_cost, שמחושב לפני תמריצי המס.
rebate_value	Money הערך של כל ההחזרים על מיסים.
savings	SavingsOverTime כמה כסף חוסכים (או לא חוסכים) במהלך תקופת החיים.
payback_years	float מספר השנים עד לתשלום ההחזר. ערך שלילי מציין שההחזר על ההוצאה לא מתרחש אף פעם במהלך תקופת החיים.

DataLayerView

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

טיפוסים בני מנייה (enum)
DATA_LAYER_VIEW_UNSPECIFIED	שווה ערך ל-FULL.
DSM_LAYER	קבלת DSM בלבד.
IMAGERY_LAYERS	מקבלים את ה-DSM, ה-RGB והמסכה.
IMAGERY_AND_ANNUAL_FLUX_LAYERS	הצגת DSM,‏ RGB,‏ מסכה וזרימה שנתית.
IMAGERY_AND_ALL_FLUX_LAYERS	הצגת DSM,‏ RGB,‏ מסכה, פוטנציאל פליטה שנתי ופוטנציאל פליטה חודשי.
FULL_LAYERS	אחזור כל הנתונים.

DataLayers

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

שדות
imagery_date	Date מתי צולמה התמונה המקורית (שממנה נגזרים כל שאר הנתונים) באזור הזה. התוצאה היא תמיד משוערת במידה מסוימת, כי יכול להיות שהתמונות צולמו במהלך יותר מיום אחד.
imagery_processed_date	Date מתי הסתיים העיבוד של התמונות האלה.
dsm_url	string כתובת ה-URL של תמונה של DSM (מודל דיגיטלי של פני השטח) של האזור. הערכים מוצגים במטרים מעל פני הים (כלומר, מעל הגיאואיד EGM96). מיקומים לא חוקיים (ללא נתונים) נשמרים כ-9999-.
rgb_url	string כתובת ה-URL של תמונה עם נתוני RGB (תמונה אווירית) של האזור.
mask_url	string כתובת ה-URL של תמונת המסכה של הבניין: ביט אחד לכל פיקסל, שמציין אם הפיקסל נחשב לחלק מגג או לא.
annual_flux_url	string כתובת ה-URL של מפת הזרימה השנתית (קרינת השמש השנתית על הגגות) של האזור. הערכים הם קוט"ש/kW/שנה. זהו השדה flux ללא אנונימיזציה: השדה flux מחושב לכל מיקום, ולא רק לגגות של בניינים. מיקומים לא חוקיים מאוחסנים כ-9999-: מיקומים מחוץ לאזור הכיסוי שלנו יהיו לא חוקיים, וגם כמה מיקומים בתוך אזור הכיסוי, שבהם לא הצלחנו לחשב את הזרימה, יהיו לא חוקיים.
monthly_flux_url	string כתובת ה-URL של מפת הזרימה החודשית (אור שמש על גגות, פירוט לפי חודש) של האזור. הערכים הם קוט"ש/kW/שנה. קובץ ה-GeoTIFF שמצביעת עליו כתובת ה-URL הזו יכיל 12 פסים, בהתאמה לינואר עד דצמבר, לפי הסדר.
hourly_shade_urls[]	string 12 כתובות URL של צל שעתי, בהתאמה לינואר עד דצמבר, לפי הסדר. כל קובץ GeoTIFF יכיל 24 פסים, בהתאם ל-24 השעות ביום. כל פיקסל הוא מספר שלם של 32 ביט, שתואם ל-31 הימים (לכל היותר) באותו חודש. ביט אחד (1) מציין שהמיקום התואם יכול לראות את השמש באותו יום, באותה שעה, באותו חודש. מיקומים לא חוקיים מאוחסנים כ--9999 (מכיוון שהערך הזה שלילי, ביט 31 מוגדר בו, ואף ערך חוקי לא יכול לכלול הגדרה של ביט 31 כי זה יתאים ליום ה-32 בחודש). כדאי להיעזר בדוגמה. אם רוצים לדעת אם נקודה (במיקום הפיקסל (x, y)) ראתה שמש בשעה 16:00 ב-22 ביוני, צריך: לאחזר את כתובת ה-URL השישית ברשימה הזו (שמתאימת לחודש יוני). מחפשים את הערוץ ה-17 (שמתאים לשעה 16:00). קריאת הערך של 32 הביט ב-(x, y). קוראים את ביט 21 של הערך (התואמת ל-22 בחודש). אם הביט הזה הוא 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 היא תמיד 'שעון רגיל').
imagery_quality	ImageryQuality איכות התמונות בתוצאה.

FinancedPurchaseSavings

העלות והתועלת של שימוש בהלוואה לרכישת הגדרה מסוימת של לוחות סולאריים עם שימוש מסוים בחשמל.

שדות
annual_loan_payment	Money תשלומי הלוואה שנתיים.
rebate_value	Money הערך של כל ההחזרים על מיסים (כולל Federal Investment Tax Credit‏ (ITC)).
loan_interest_rate	float שיעור הריבית על ההלוואות שמשוער בקבוצת החישובים הזו.
savings	SavingsOverTime כמה כסף חוסכים (או לא חוסכים) במהלך תקופת החיים.

FinancialAnalysis

ניתוח של העלות והיתרונות של הפריסה האופטימלית של האנרגיה הסולארית בהתאם לגודל חשבון חשמל מסוים.

שדות
monthly_bill	Money חשבון החשמל החודשי שמשוער בניתוח.
default_bill	bool האם זהו גודל החשבון שנבחר כחשבון ברירת המחדל לאזור שבו נמצא הבניין. צריך להגדיר את default_bill ב-FinancialAnalysis אחד בלבד ב-BuildingSolarPotential.
average_kwh_per_month	float כמות החשמל שהבית צורך בחודש ממוצע, על סמך סכום החיוב ושיעור החשמל המקומי.
financial_details	FinancialDetails מידע פיננסי שרלוונטי ללא קשר לאמצעי המימון שבו נעשה שימוש.
leasing_savings	LeasingSavings העלות והתועלת של רכישת הלוחות הסולאריים.
cash_purchase_savings	CashPurchaseSavings העלות והיתרונות של קניית הלוחות הסולאריים במזומן.
financed_purchase_savings	FinancedPurchaseSavings העלות והתועלת של רכישת הלוחות הסולאריים באמצעות מימון הרכישה.
panel_config_index	int32 האינדקס ב-solar_panel_configs של הפריסה האופטימלית של המערכת הסולארית לגודל החשבון הזה. הערך יכול להיות -1, כדי לציין שאין פריסה. במקרה כזה, שאר הודעות המשנה יוסרו.

FinancialDetails

פרטים של ניתוח פיננסי. חלק מהפרטים האלה כבר מאוחסנים ברמות גבוהות יותר (למשל, עלות מתוך כיס). הסכומים הכספיים הכוללים הם על פני תקופת חיים שמוגדרת בשדה panel_lifetime_years בקובץ SolarPotential. הערה: העלות בפועל של רכישת הלוחות מופיעה בשדה out_of_pocket_cost בקטע CashPurchaseSavings.

שדות
initial_ac_kwh_per_year	float כמה קילוואט-שעה (AC) אנחנו צופים שהלוחות הסולאריים ייצרו בשנה הראשונה שלהם.
remaining_lifetime_utility_bill	Money חשבון החשמל על חשמל שלא נוצר על ידי האנרגיה הסולארית, למשך כל חיי הלוחות.
federal_incentive	Money סכום הכסף שזמין מההטבות הפדרליות. הנתון הזה רלוונטי אם המשתמש קונה את הפאנלים (עם או בלי הלוואה).
state_incentive	Money סכום הכסף שזמין מההטבות של המדינה. הנתון הזה רלוונטי אם המשתמש קונה את הפאנלים (עם הלוואה או בלי).
utility_incentive	Money סכום הכסף שזמין מהטבות של ספקי החשמל. הנתון הזה רלוונטי אם המשתמש קונה את הפאנלים (עם או בלי הלוואה).
lifetime_srec_total	Money סכום הכסף שהמשתמש יקבל מקרדיטים על אנרגיה מתחדשת סולארית במהלך חיי הפאנלים. הנתון הזה רלוונטי אם המשתמש קונה את הפאנלים (עם או בלי הלוואה).
cost_of_electricity_without_solar	Money העלות הכוללת של החשמל שהמשתמש היה משלם במהלך תקופת החיים, אם לא היה מתקין מערכת סולארית.
net_metering_allowed	bool אם מותר להשתמש במונה נטו.
solar_percentage	float אחוז (0-100) מהחשמל של המשתמש שמגיע מאנרגיה סולארית. התקף לשנה הראשונה, אבל מדויק פחות או יותר בשנים הבאות.
percentage_exported_to_grid	float האחוז (0-100) של הפקת החשמל מהאנרגיה הסולארית שהנחנו שהוא יוצא לרשת, על סמך הרבעון הראשון של הייצור. האפשרות הזו משפיעה על החישובים אם השימוש במונה נטו אסור.

FindClosestBuildingInsightsRequest

הודעה עם בקשה עבור Solar.FindClosestBuildingInsights.

שדות
location	LatLng חובה. קו האורך וקו הרוחב שמהם ה-API מחפש את המבנה הידוע הקרוב ביותר.
required_quality	ImageryQuality זה שינוי אופציונלי. רמת האיכות המינימלית המותרת בתוצאות. לא תוחזר תוצאה באיכות נמוכה יותר. אם לא מציינים את האפשרות הזו, המשמעות היא הגבלה לתמונות באיכות גבוהה בלבד.

GetDataLayersRequest

הודעה עם בקשה עבור Solar.GetDataLayers.

שדות
location	LatLng חובה. קו האורך וקו הרוחב של מרכז האזור שלגביו רוצים לקבל נתונים.
radius_meters	float חובה. הרדיוס, במטרים, שמגדיר את האזור שמקיף את נקודת המרכז הזו, שעבורו צריך להחזיר נתונים. המגבלות על הערך הזה הן: תמיד אפשר לציין ערך של עד 100 מ'. אפשר לציין ערכים מעל 100m, כל עוד radius_meters <= pixel_size_meters * 1000. עם זאת, לערכים מעל 175m, השדה DataLayerView בבקשה לא יכול לכלול נתוני פליטה חודשיים או נתוני צל שעתי.
view	DataLayerView זה שינוי אופציונלי. קבוצת המשנה הרצויה של הנתונים להחזרה.
required_quality	ImageryQuality זה שינוי אופציונלי. רמת האיכות המינימלית המותרת בתוצאות. לא תוחזר תוצאה באיכות נמוכה יותר. אם לא מציינים את האפשרות הזו, המשמעות היא הגבלה לתמונות באיכות גבוהה בלבד.
pixel_size_meters	float זה שינוי אופציונלי. קנה המידה המינימלי, במטרים לכל פיקסל, של הנתונים שיוחזרו. הערכים הנתמכים הם 0.1 (ברירת המחדל, אם השדה הזה לא מוגדר באופן מפורש), 0.25,‏ 0.5 ו-1.0. רכיבי תמונות שהרזולוציה הרגילה שלהם קטנה מ-pixel_size_meters יחזרו ברזולוציה שצוינה ב-pixel_size_meters. רכיבי תמונות שהרזולוציה הרגילה שלהם שווה ל-pixel_size_meters או גדולה ממנה יחזרו ברזולוציה הרגילה הזו.
exact_quality_required	bool זה שינוי אופציונלי. האם לדרוש איכות מדויקת של התמונות. אם הערך מוגדר כ-false, השדה required_quality מפורש כאיכות המינימלית הנדרשת, כך שיכול להיות שתוחזר תמונה באיכות גבוהה כשהערך של required_quality מוגדר כ-MEDIUM. אם הערך מוגדר כ-true, הערך required_quality מפורש כאיכות הנדרשת המדויקת, ורק תמונות באיכות MEDIUM יחזרו אם הערך של required_quality מוגדר כ-MEDIUM.

GetGeoTiffRequest

הודעה עם בקשה עבור Solar.GetGeoTiff.

שדות
id	string חובה. המזהה של הנכס המבוקש.

ImageryQuality

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

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

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

LatLngBox

תיבה תוחמת (bounding box) בקואורדינטות של קו הרוחב/קו האורך.

שדות
sw	LatLng הפינה הדרום-מערבית של התיבה.
ne	LatLng הפינה הצפונית-מזרחית של התיבה.

LeasingSavings

העלות והתועלת של רכישת זיכיון לשימוש בהגדרה מסוימת של לוחות סולאריים עם שימוש מסוים בחשמל.

שדות
leases_allowed	bool האם מותר לחתום על חוזי שכירות בסמכות השיפוט הזו (במדינות מסוימות אסור לחתום על חוזי שכירות). אם השדה הזה הוא false, סביר להניח שצריך להתעלם מהערכים בהודעה הזו.
leases_supported	bool האם מנוע החישובים הפיננסיים תומך בהסכמי שכירות בסמכות השיפוט הזו. אם השדה הזה הוא false, סביר להניח שצריך להתעלם מהערכים בהודעה הזו. הערך הזה לא תלוי ב-leases_allowed: באזורים מסוימים מותר להשכיר, אבל בתנאים שלא מטופלים על ידי הדגמים הפיננסיים.
annual_leasing_cost	Money עלות השכירות השנתית המשוערת.
savings	SavingsOverTime כמה כסף חוסכים (או לא חוסכים) במהלך תקופת החיים.

RoofSegmentSizeAndSunshineStats

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

שדות
stats	SizeAndSunshineStats הגודל הכולל ועשירונות של אור השמש בחלק של הגג.
center	LatLng נקודה ליד מרכז מקטע הגג.
bounding_box	LatLngBox התיבה התוחמת של מקטע הגג.
pitch_degrees	float הזווית של מקטע הגג ביחס למישור הקרקע התיאורטי. 0 = מקביל לקרקע, 90 = אנכי לקרקע.
azimuth_degrees	float כיוון המצפן שאליו פונה מקטע הגג. 0 = צפון, 90 = מזרח, 180 = דרום. בחלק 'שטוח' של גג (pitch_degrees קרוב מאוד ל-0), האזימוט לא מוגדר בצורה טובה, ולכן, כדי לשמור על עקביות, אנחנו מגדירים אותו באופן שרירותי כ-0 (צפון).
plane_height_at_center_meters	float הגובה של מישור מקטע הגג, במטרים מעל פני הים, בנקודה שסומנה ב-center. יחד עם הזווית, הזווית הצפון-דרום והמיקום במרכז, הנתונים האלה מגדירים באופן מלא את מישור מקטע הגג.

RoofSegmentSummary

מידע על מקטע גג בבניין, עם מספר מסוים של פאנלים שמותקנים עליו.

שדות
panels_count	int32 המספר הכולל של החלוניות בקטע הזה.
yearly_energy_dc_kwh	float כמות האנרגיה מאור השמש שחלק זה של הפריסה קולט במהלך שנה, בקוט"ש (DC), בהנחה שהלוחות מתוארים למעלה.
pitch_degrees	float הזווית של מקטע הגג ביחס למישור הקרקע התיאורטי. 0 = מקביל לקרקע, 90 = אנכי לקרקע.
azimuth_degrees	float כיוון המצפן שאליו פונה מקטע הגג. 0 = צפון, 90 = מזרח, 180 = דרום. בחלק 'שטוח' של גג (pitch_degrees קרוב מאוד ל-0), האזימוט לא מוגדר בצורה טובה, ולכן, כדי לשמור על עקביות, אנחנו מגדירים אותו באופן שרירותי כ-0 (צפון).
segment_index	int32 האינדקס ב-roof_segment_stats של RoofSegmentSizeAndSunshineStats התואם.

SavingsOverTime

מידע פיננסי שמשותף בין שיטות מימון שונות.

שדות
savings_year1	Money החיסכון בשנה הראשונה לאחר התקנת הפאנלים.
savings_year20	Money החיסכון בשנות הפעילות הראשונות של הפאנלים.
present_value_of_savings_year20	Money מהו הערך הנוכחי של החיסכון המצטבר לאורך 20 שנה, לפי שיעור ההנחה המשוער?
savings_lifetime	Money החיסכון בכל משך החיים של הפאנל.
present_value_of_savings_lifetime	Money מהו הערך הנוכחי של החיסכון המצטבר לכל משך החיים, לפי שיעור ההנחה המשוער?
financially_viable	bool מציין אם התרחיש הזה כלכלי. הערך יהיה שקר בתרחישים עם כדאיות פיננסית נמוכה (למשל, הפסדים כספיים).

SizeAndSunshineStats

גודל ופרמטרים של שמשיות של גג או של חלק מגג.

שדות
area_meters2	float שטח הגג או מקטע הגג, במטרים רבועים. זהו אזור הגג (כולל שיפוע), ולא אזור שטח הקרקע.
sunshine_quantiles[]	float קוינטלים של שמשיות נקודתית ברחבי האזור. אם יש כאן N ערכים, הם מייצגים את ה-(N-1)-iles. לדוגמה, אם יש 5 ערכים, אלה יהיו הרבעונים (min, ‏ 25%, ‏ 50%, ‏ 75%, ‏ max). הערכים הם ב-kWh ל-kW לשנה, כמו max_sunshine_hours_per_year.
ground_area_meters2	float שטח התחום של הגג או מקטע הגג שמכוסה על הקרקע, במטרים רבועים.

SolarPanel

השדה SolarPanel מתאר את המיקום, הכיוון והייצור של לוח סולארי יחיד. מידע על הפרמטרים של החלונית זמין בשדות panel_height_meters,‏ panel_width_meters ו-panel_capacity_watts ב-SolarPotential.

שדות
center	LatLng מרכז החלונית.
orientation	SolarPanelOrientation הכיוון של הלוח.
yearly_energy_dc_kwh	float כמות האנרגיה מאור השמש שהפריסה הזו קולטת במהלך שנה, בקוט"ש (DC).
segment_index	int32 האינדקס ב-roof_segment_stats של ה-RoofSegmentSizeAndSunshineStats שתואם לפלח הגג שבו מותקן הפאנל הזה.

SolarPanelConfig

SolarPanelConfig מתאר מיקום ספציפי של לוחות סולאריים על הגג.

שדות
panels_count	int32 המספר הכולל של הלוחות. שימו לב שהערך הזה הוא יתיר (לסכום) השדות התואמים ב-roof_segment_summaries.
yearly_energy_dc_kwh	float כמות האנרגיה מאור השמש שהפריסה הזו קולטת במהלך שנה, בקוט"ש (DC), בהנחה שהלוחות מתוארים למעלה.
roof_segment_summaries[]	RoofSegmentSummary מידע על התפוקה של כל מקטע גג שמכיל לפחות פאנל אחד בפריסה הזו. roof_segment_summaries[i] מתאר את מקטע הגג ה-i, כולל הגודל, התפוקה הצפויה והכיוון שלו.

SolarPanelOrientation

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

טיפוסים בני מנייה (enum)
SOLAR_PANEL_ORIENTATION_UNSPECIFIED	לא ידוע איזה כיוון יש ללוח.
LANDSCAPE	הקצה הארוך של פאנל LANDSCAPE הוא מאונך לכיוון האזימוט של מקטע הגג שבו הוא ממוקם.
PORTRAIT	הקצה הארוך של לוח PORTRAIT מקביל לכיוון האזימוט של מקטע הגג שבו הוא מונח.

SolarPotential

מידע על הפוטנציאל הסולארי של מבנה. חלק מהשדות מוגדרים במונחים של 'חלוניות'. השדות panel_capacity_watts,‏ panel_height_meters ו-panel_width_meters מתארים את הפרמטרים של מודל הלוח שמשמש בחישובים האלה.

שדות
max_array_panels_count	int32 גודל המערך המקסימלי – כלומר, המספר המקסימלי של הפאנלים שיכולים להתאים לגג.
panel_capacity_watts	float הקיבולת, בוולט, של הפאנל ששימש לחישוב.
panel_height_meters	float הגובה, במטרים בפריסה לאורך, של הלוח שמשמש בחישובים.
panel_width_meters	float רוחב החלונית, במטרים בכיוון לאורך, שמשמש לחישוב.
panel_lifetime_years	int32 משך החיים הצפוי של הלוחות הסולאריים, בשנים. המערכת משתמשת בנתון הזה לצורך החישובים הפיננסיים.
max_array_area_meters2	float הגודל, במטרים רבועים, של המערך המקסימלי.
max_sunshine_hours_per_year	float מספר שעות השמש המקסימלי שמתקבלות בשנה, בכל נקודה על הגג. שעות שמש הן מדד לכמות האנרגיה הסולארית (הקרינה) שמתקבלת בכל שנה. שעה של שמש = 1 קוט"ש לכל קילוואט (כאשר קילוואט מתייחס לקיבולת של קילוואט בתנאי בדיקה רגילים).
carbon_offset_factor_kg_per_mwh	float כמות מקבילית של CO2 שנוצרת לכל מגה-ואט-שעה של חשמל מרשת. מדד של עצימות הפחמן של חשמל מרשת שהוחלף בחשמל סולארי.
whole_roof_stats	SizeAndSunshineStats הגודל הכולל ופרקי הזמן של אור השמש בחלק מהגג שהוקצה לפלח גג כלשהו. למרות השם, יכול להיות שהיא לא תכלול את כל הבניין. building_stats.
building_stats	SizeAndSunshineStats גודל וקוונטילים של אור השמש בכל המבנה, כולל חלקים מהגג שלא הוקצו לחלק מסוים של הגג. מכיוון שהכיוונים של החלקים האלה לא מוגדרים בצורה טובה, האומדן של שטח הגג לא מהימן, אבל האומדן של שטח הקרקע מהימן. יכול להיות ששטח הגג של כל המבנה יהיה מהימן יותר אם יתבצע שינוי קנה מידה של שטח הגג מ-whole_roof_stats לפי היחס בין שטחי הקרקע של building_stats ו-whole_roof_stats.
roof_segment_stats[]	RoofSegmentSizeAndSunshineStats גודל וקווינטילים של קרינת השמש לכל מקטע גג.
solar_panels[]	SolarPanel כל SolarPanel מתאר פאנל סולארי יחיד. הן מופיעות לפי הסדר שבו האלגוריתם של פריסת החלונית מיקם אותן. בדרך כלל, אבל לא תמיד, הרשימה מסודרת לפי ירידה בייצור האנרגיה השנתי.
solar_panel_configs[]	SolarPanelConfig כל SolarPanelConfig מתאר סידור שונה של לוחות סולאריים על הגג. הם מופיעים לפי מספר הלוחות המוגדל. הערך של SolarPanelConfig עם panels_count=N מבוסס על N הלוחות הראשונים ברשימה solar_panels. השדה הזה מאוכלס רק אם אפשר להציב על הגג לפחות 4 לוחות.
financial_analyses[]	FinancialAnalysis הערך של FinancialAnalysis מתייחס לחיסכון מהשימוש באנרגיה סולארית, בהנחה של חשבון חודשי נתון וספק חשמל נתון. הם מופיעים לפי סדר עולה של סכום החיוב החודשי. השדה הזה יהיה ריק במבנים שנמצאים באזורים שבהם ל-Solar API אין מספיק מידע כדי לבצע חישובים פיננסיים.