Method: buildingInsights.findClosest

מאתר את הבניין שהצנטרואיד שלו הכי קרוב לנקודת שאילתה. אם אין בניינים במרחק של כ-50 מטרים מנקודת השאילתה, הפונקציה מחזירה שגיאה עם קוד NOT_FOUND.

בקשת HTTP

GET https://solar.googleapis.com/v1/buildingInsights:findClosest

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של שאילתה

פרמטרים
location

object (LatLng)

חובה. קו האורך וקו הרוחב שממנו ה-API מחפש את הבניין הידוע הקרוב ביותר.
requiredQuality

enum (ImageryQuality)

אופציונלי. רמת האיכות המינימלית שמותרת בתוצאות. לא יוחזר אף תוצאה באיכות נמוכה יותר. אם לא מציינים את המאפיין הזה, המשמעות היא הגבלה לאיכות גבוהה בלבד.
exactQualityRequired

boolean

אופציונלי. האם נדרשת איכות מדויקת של התמונות. אם הערך הוא false, השדה requiredQuality מתפרש כאיכות המינימלית הנדרשת, כך שאם הערך של requiredQuality הוא MEDIUM, יכול להיות שיוחזרו תמונות באיכות HIGH. אם הערך הוא true,‏ requiredQuality מתפרש כאיכות הנדרשת המדויקת, ומוחזרות תמונות באיכות MEDIUM רק אם הערך של requiredQuality הוא MEDIUM.
experiments[]

enum (Experiment)

אופציונלי. מציינים את הניסויים בטרום-GA שרוצים להפעיל. בקשות שמשתמשות בשדה הזה מסווגות כמוצר בגרסת טרום-GA במסגרת התנאים הספציפיים לשירות של Google Maps Platform. פרטים נוספים מופיעים בקטע תיאור שלבי ההשקה.
additionalInsights[]

enum (AdditionalInsights)

אופציונלי. רשימה של additionalInsights שרוצים לכלול בתשובה.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

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

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "name": string,
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "postalCode": string,
  "administrativeArea": string,
  "statisticalArea": string,
  "regionCode": string,
  "solarPotential": {
    object (SolarPotential)
  },
  "imageryQuality": enum (ImageryQuality),
  "detectedArrays": {
    object (DetectedArrays)
  }
}
שדות
name

string

שם המשאב של הבניין, בפורמט buildings/{place_id}.
center

object (LatLng)

נקודה קרובה למרכז הבניין.
boundingBox

object (LatLngBox)

התיבה התוחמת של הבניין.
imageryDate

object (Date)

התאריך שבו צולמו התמונות הבסיסיות. זהו ערך משוער.
imageryProcessedDate

object (Date)

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

string

המיקוד (למשל, מיקוד בארה"ב) שבו נמצא הבניין.
administrativeArea

string

אזור מנהלי 1 (למשל, בארה"ב, המדינה) שבו נמצא הבניין. לדוגמה, בארה"ב, הקיצור יכול להיות "MA" או "CA".
statisticalArea

string

אזור סטטיסטי (למשל, אזור מוגדר למפקד אוכלוסין בארה"ב) שבו נמצא הבניין.
regionCode

string

קוד האזור של המדינה (או האזור) שבהם נמצא הבניין.
solarPotential

object (SolarPotential)

פוטנציאל ליצירת אנרגיה סולארית של הבניין.
imageryQuality

enum (ImageryQuality)

איכות התמונות ששימשו לחישוב הנתונים של הבניין הזה.
detectedArrays

object (DetectedArrays)

זוהו מערכים סולאריים במבנה. השדה הזה מאוכלס רק אם DETECTED_ARRAYS נכלל ב-FindClosestBuildingInsightsRequest.additional_insights של הבקשה.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

AdditionalInsights

פרטי בניין נוספים, כמו גיאומטריית הגג ומערכי לוחות סולאריים, שאפשר לקבל ב-BuildingInsights.

טיפוסים בני מנייה (enum)
ADDITIONAL_INSIGHTS_UNSPECIFIED ערך ברירת המחדל. הערך שיוחזר יהיה ברירת המחדל של BuildingInsights.
DETECTED_ARRAYS

קובע אם התשובה תכלול את המערכים שזוהו.

אם צוין, השדה detectedArrays יאוכלס בתגובה.

LatLngBox

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

ייצוג ב-JSON 
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
שדות
sw

object (LatLng)

הפינה הדרום-מערבית של התיבה.
ne

object (LatLng)

הפינה הצפון-מזרחית של התיבה.

SolarPotential

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

ייצוג ב-JSON 
{
  "maxArrayPanelsCount": integer,
  "panelCapacityWatts": number,
  "panelHeightMeters": number,
  "panelWidthMeters": number,
  "panelLifetimeYears": integer,
  "maxArrayAreaMeters2": number,
  "maxSunshineHoursPerYear": number,
  "carbonOffsetFactorKgPerMwh": number,
  "wholeRoofStats": {
    object (SizeAndSunshineStats)
  },
  "buildingStats": {
    object (SizeAndSunshineStats)
  },
  "roofSegmentStats": [
    {
      object (RoofSegmentSizeAndSunshineStats)
    }
  ],
  "solarPanels": [
    {
      object (SolarPanel)
    }
  ],
  "solarPanelConfigs": [
    {
      object (SolarPanelConfig)
    }
  ],
  "financialAnalyses": [
    {
      object (FinancialAnalysis)
    }
  ]
}
שדות
maxArrayPanelsCount

integer

גודל המערך המקסימלי – כלומר, המספר המקסימלי של הפאנלים שיכולים להיכנס לגג.
panelCapacityWatts

number

הקיבולת, בוואט, של הפאנל שמשמש לחישובים.
panelHeightMeters

number

גובה החלונית בפריסה לאורך, במטרים, שמשמשת לחישובים.
panelWidthMeters

number

רוחב הפאנל במטרים במצב אנכי, שמשמש לחישובים.
panelLifetimeYears

integer

תוחלת החיים הצפויה של הפאנלים הסולאריים, בשנים. הערך הזה משמש לחישובים פיננסיים.
maxArrayAreaMeters2

number

הגודל המקסימלי של המערך במטרים רבועים.
maxSunshineHoursPerYear

number

מספר השעות המקסימלי של חשיפה לשמש בשנה, בכל נקודה על הגג. שעות השמש הן מדד לכמות הכוללת של קרינת השמש (אנרגיה) שמתקבלת בשנה. שעת שמש אחת = 1 קוט"ש לכל קילוואט (כאשר קילוואט מתייחס לקילוואט של קיבולת בתנאי בדיקה רגילים).
carbonOffsetFactorKgPerMwh

number

כמות שוות-ערך של CO2 שנוצרת לכל MWh של חשמל מהרשת. זהו שיעור פליטת הפחמן של חשמל מהרשת שהוחלף על ידי חשמל סולארי.
wholeRoofStats

object (SizeAndSunshineStats)

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

object (SizeAndSunshineStats)

הכמויות של הגודל ואור השמש לכל הבניין, כולל חלקים בגג שלא שויכו לפלח גג מסוים. מכיוון שהכיוונים של החלקים האלה לא מאופיינים היטב, האומדן של שטח הגג לא אמין, אבל האומדן של שטח הקרקע אמין. יכול להיות שאפשר לקבל שטח גג מהימן יותר של הבניין כולו על ידי שינוי קנה המידה של שטח הגג מ-wholeRoofStats לפי היחס בין שטחי הקרקע של buildingStats ו-wholeRoofStats.
roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

הגודל והכמות של קרני השמש שנספגות בכל מקטע גג.
solarPanels[]

object (SolarPanel)

כל SolarPanel מתאר לוח סולארי יחיד. הם מופיעים בסדר שבו האלגוריתם של פריסת החלוניות מיקם אותם. בדרך כלל, אבל לא תמיד, הסדר הוא יורד לפי ייצור האנרגיה השנתי.
solarPanelConfigs[]

object (SolarPanelConfig)

כל SolarPanelConfig מתאר סידור שונה של לוחות סולאריים על הגג. הם מסודרים לפי מספר הלוחות, מהקטן לגדול. הערך SolarPanelConfig עם panelsCount=N מבוסס על N הפאנלים הראשונים ברשימה solarPanels. השדה הזה מאוכלס רק אם אפשר להתקין לפחות 4 פאנלים על הגג.
financialAnalyses[]

object (FinancialAnalysis)

FinancialAnalysis מציג את החיסכון שמתקבל ממעבר לאנרגיה סולארית בהנחה של חשבון חודשי נתון וספק חשמל נתון. הם מסודרים לפי סדר עולה של סכום החיוב החודשי. השדה הזה יהיה ריק לגבי בניינים באזורים שבהם ל-Solar API אין מספיק מידע כדי לבצע חישובים פיננסיים.

SizeAndSunshineStats

אחוזונים של גודל ומידת החשיפה לשמש של גג או חלק מגג.

ייצוג ב-JSON 
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
שדות
areaMeters2

number

שטח הגג או מקטע הגג, במ"ר. הכוונה היא לשטח הגג (כולל שיפוע), ולא לשטח הבסיס.
sunshineQuantiles[]

number

הכמויות של מידת החשיפה לשמש בכל נקודה באזור. אם יש כאן N ערכים, הם מייצגים את אחוזוני (N-1). לדוגמה, אם יש 5 ערכים, הם יהיו הרבעונים (מינימום, 25%, 50%, 75%, מקסימום). הערכים הם קוט"ש לשנה לכל קילוואט, כמו maxSunshineHoursPerYear.
groundAreaMeters2

number

שטח טביעת הרגל על הקרקע שמכוסה על ידי הגג או קטע הגג, במ'^2.

RoofSegmentSizeAndSunshineStats

מידע על גודל ועל חלוקה לכמויות שוות של קטע גג.

ייצוג ב-JSON 
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
שדות
stats

object (SizeAndSunshineStats)

הגודל הכולל והכמויות של אור השמש בפלח הגג.
center

object (LatLng)

נקודה קרובה למרכז של מקטע הגג.
boundingBox

object (LatLngBox)

התיבה התוחמת של מקטע הגג.
pitchDegrees

number

הזווית של מקטע הגג ביחס למישור הקרקע התיאורטי. ‫0 = מקביל לקרקע, 90 = מאונך לקרקע.
azimuthDegrees

number

כיוון המצפן שאליו פונה מקטע הגג. ‫0 = צפון, 90 = מזרח, 180 = דרום. בפלח גג שטוח (pitchDegrees קרוב מאוד ל-0), האזימוט לא מוגדר היטב, ולכן כדי לשמור על עקביות, אנחנו מגדירים אותו באופן שרירותי כ-0 (צפון).
planeHeightAtCenterMeters

number

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

SolarPanel

‫SolarPanel מתאר את המיקום, הכיוון והייצור של לוח סולארי יחיד. מידע על הפרמטרים של החלונית מופיע בשדות panelHeightMeters, panelWidthMeters ו-panelCapacityWatts ב-SolarPotential.

ייצוג ב-JSON 
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
שדות
center

object (LatLng)

מרכז החלונית.
orientation

enum (SolarPanelOrientation)

הכיוון של החלונית.
yearlyEnergyDcKwh

number

כמה אנרגיה מאור השמש נאספת בפריסה הזו במהלך שנה, בקוט"ש DC.
segmentIndex

integer

האינדקס ב-roofSegmentStats של RoofSegmentSizeAndSunshineStats שמתאים לקטע הגג שבו ממוקם הפאנל הזה.

SolarPanelOrientation

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

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

SolarPanelConfig

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

ייצוג ב-JSON 
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
שדות
panelsCount

integer

המספר הכולל של לוחות. שימו לב: הערך הזה מיותר כי הוא זהה לערך שמתקבל מסיכום השדות המתאימים ב-roofSegmentSummaries.
yearlyEnergyDcKwh

number

כמה אנרגיה סולארית נאספת בפריסה הזו במהלך שנה, בקוט"ש DC, בהנחה שמדובר בלוחות שתוארו למעלה.
roofSegmentSummaries[]

object (RoofSegmentSummary)

מידע על הייצור של כל מקטע גג שנושא לפחות פאנל אחד בפריסה הזו. ‫roofSegmentSummaries[i] מתאר את פלח הגג ה-i, כולל הגודל, הייצור הצפוי והכיוון שלו.

RoofSegmentSummary

מידע על פלח גג בבניין, עם מספר מסוים של פאנלים שמוצבים עליו.

ייצוג ב-JSON 
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
שדות
panelsCount

integer

המספר הכולל של החלוניות בפלח הזה.
yearlyEnergyDcKwh

number

כמות אנרגיית אור השמש שנקלטת בחלק הזה של הפריסה במהלך שנה, בקוט"ש DC, בהנחה שלוחות סולאריים כפי שמתואר למעלה.
pitchDegrees

number

הזווית של מקטע הגג ביחס למישור הקרקע התיאורטי. ‫0 = מקביל לקרקע, 90 = מאונך לקרקע.
azimuthDegrees

number

כיוון המצפן שאליו מצביע מקטע הגג. ‫0 = צפון, 90 = מזרח, 180 = דרום. בפלח גג שטוח (pitchDegrees קרוב מאוד ל-0), האזימוט לא מוגדר היטב, ולכן כדי לשמור על עקביות, אנחנו מגדירים אותו באופן שרירותי כ-0 (צפון).
segmentIndex

integer

האינדקס ב-roofSegmentStats של RoofSegmentSizeAndSunshineStats המתאים.

FinancialAnalysis

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

ייצוג ב-JSON 
{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}
שדות
monthlyBill

object (Money)

חשבון החשמל החודשי שהניתוח הזה מניח.
defaultBill

boolean

האם זה גודל החשבון שנבחר להיות חשבון ברירת המחדל באזור שבו נמצא הבניין. בדיוק אחד מהמאפיינים FinancialAnalysis ב-BuildingSolarPotential צריך להיות מוגדר כ-defaultBill.
averageKwhPerMonth

number

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

object (FinancialDetails)

מידע פיננסי שרלוונטי לכל שיטת מימון.
leasingSavings

object (LeasingSavings)

העלות והתועלת של חכירת הלוחות הסולאריים.
cashPurchaseSavings

object (CashPurchaseSavings)

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

object (FinancedPurchaseSavings)

העלות והתועלת של רכישת הלוחות הסולאריים באמצעות מימון הרכישה.
panelConfigIndex

integer

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

כסף

מייצג סכום כסף עם סוג המטבע.

ייצוג ב-JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
שדות
currencyCode

string

קוד המטבע בן שלוש אותיות כפי שמוגדר בתקן ISO 4217.
units

string (int64 format)

מספר היחידות השלמות של הסכום. לדוגמה: אם הערך של currencyCode הוא "USD", המשמעות היא ש-1 יחידה = 1 דולר ארה"ב.
nanos

integer

מספר יחידות הננו (10‎^-9) של הסכום. הערך חייב להיות בין ‎-999,999,999 ל- ‎+999,999,999, כולל. אם הערך של units הוא חיובי, הערך של nanos חייב להיות חיובי או אפס. אם הערך של units הוא אפס, הערך של nanos יכול להיות חיובי, אפס או שלילי. אם הערך של units הוא שלילי, הערך של nanos חייב להיות שלילי או אפס. לדוגמה, הסכום ‎ $-1.75 מיוצג כ-units=-1 וגם כ-nanos=-750,000,000.

FinancialDetails

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

ייצוג ב-JSON 
{
  "initialAcKwhPerYear": number,
  "remainingLifetimeUtilityBill": {
    object (Money)
  },
  "federalIncentive": {
    object (Money)
  },
  "stateIncentive": {
    object (Money)
  },
  "utilityIncentive": {
    object (Money)
  },
  "lifetimeSrecTotal": {
    object (Money)
  },
  "costOfElectricityWithoutSolar": {
    object (Money)
  },
  "netMeteringAllowed": boolean,
  "solarPercentage": number,
  "percentageExportedToGrid": number
}
שדות
initialAcKwhPerYear

number

כמה קילוואט-שעה של זרם חילופין (AC) אנחנו חושבים שהלוחות הסולאריים יפיקו בשנה הראשונה.
remainingLifetimeUtilityBill

object (Money)

חשבון על תשתיות עבור חשמל שלא מיוצר על ידי אנרגיה סולארית, למשך חיי הלוחות.
federalIncentive

object (Money)

סכום הכסף שזמין מתמריצים פדרליים. הנתון הזה רלוונטי אם המשתמש קונה את הפאנלים (עם או בלי הלוואה).
stateIncentive

object (Money)

סכום הכסף שזמין מתמריצים של המדינה. זה רלוונטי אם המשתמש קונה את הפאנלים (עם או בלי הלוואה).
utilityIncentive

object (Money)

סכום הכסף שזמין כהטבות על שירותים; הערך הזה רלוונטי אם המשתמש קונה את הפאנלים (עם או בלי הלוואה).
lifetimeSrecTotal

object (Money)

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

object (Money)

העלות הכוללת של החשמל שהמשתמש היה משלם במהלך תקופת השימוש אם הוא לא היה מתקין לוחות סולאריים.
netMeteringAllowed

boolean

האם מותר להשתמש במונה נטו.
solarPercentage

number

אחוז (0-100) החשמל שהמשתמש מקבל מאנרגיה סולארית. המחיר תקף לשנה הראשונה, אבל הוא נכון בקירוב גם לשנים הבאות.
percentageExportedToGrid

number

האחוז (0-100) של ייצור חשמל סולארי שלפי ההנחה שלנו יוצא לרשת, על סמך הרבעון הראשון של הייצור. הדבר משפיע על החישובים אם השימוש במונה נטו אסור.

LeasingSavings

העלות והתועלת של חכירת תצורה מסוימת של לוחות סולאריים עם צריכת חשמל מסוימת.

ייצוג ב-JSON 
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
שדות
leasesAllowed

boolean

האם מותר להשכיר נכסים בתחום השיפוט הזה (במדינות מסוימות אסור להשכיר נכסים). אם הערך בשדה הזה הוא false, כדאי להתעלם מהערכים בהודעה הזו.
leasesSupported

boolean

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

object (Money)

עלות שנתית משוערת של ליסינג.
savings

object (SavingsOverTime)

כמה נחסך (או לא נחסך) במהלך תקופת החיים.

SavingsOverTime

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

ייצוג ב-JSON 
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
שדות
savingsYear1

object (Money)

החיסכון בשנה הראשונה אחרי התקנת הפאנל.
savingsYear20

object (Money)

החיסכון בעשרים השנים הראשונות לאחר התקנת הפאנל.
presentValueOfSavingsYear20

object (Money)

מהו הערך הנוכחי של החיסכון המצטבר ל-20 שנה, בהתבסס על שיעור ההנחה המשוער?
savingsLifetime

object (Money)

חיסכון לאורך כל משך החיים של הפאנל.
presentValueOfSavingsLifetime

object (Money)

מהו הערך הנוכחי של החיסכון המצטבר לכל החיים, בהתבסס על שיעור ההנחה המשוער?
financiallyViable

boolean

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

CashPurchaseSavings

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

ייצוג ב-JSON 
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
שדות
outOfPocketCost

object (Money)

העלות הראשונית לפני מס: הסכום שצריך לשלם מכיסכם. השוואה ל-upfrontCost, שכולל תמריצי מס.
upfrontCost

object (Money)

העלות הראשונית אחרי הטבות מס: זה הסכום שצריך לשלם במהלך השנה הראשונה. ההטבות האלה שונות מ-outOfPocketCost, שהוא לפני תמריצי מס.
rebateValue

object (Money)

הערך של כל ההנחות במס.
savings

object (SavingsOverTime)

כמה נחסך (או לא נחסך) במהלך תקופת החיים.
paybackYears

number

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

FinancedPurchaseSavings

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

ייצוג ב-JSON 
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
שדות
annualLoanPayment

object (Money)

תשלומי הלוואה שנתיים.
rebateValue

object (Money)

הערך של כל ההנחות במס (כולל Federal Investment Tax Credit‏ (ITC)).
loanInterestRate

number

שיעור הריבית על ההלוואות שמונחות בסט החישובים הזה.
savings

object (SavingsOverTime)

כמה נחסך (או לא נחסך) במהלך תקופת החיים.

DetectedArrays

מידע על מערכים סולאריים שזוהו במבנה.

ייצוג ב-JSON 
{
  "detectionStatus": enum (DetectionStatus),
  "latestCaptureDate": {
    object (Date)
  }
}
שדות
detectionStatus

enum (DetectionStatus)

מציין את סטטוס הזיהוי של מערכים סולאריים בבניין הזה.
latestCaptureDate

object (Date)

התאריך שבו נאספו הנתונים האחרונים של המערך הסולארי.

DetectionStatus

מציין את סטטוס הזיהוי של מערכים סולאריים בבניין הזה.

טיפוסים בני מנייה (enum)
DETECTION_STATUS_UNSPECIFIED הסטטוס לא צוין.
DETECTION_STATUS_DATA_UNAVAILABLE נתונים של מערך סולארי שזוהה לא זמינים לגבי הבניין הזה.
DETECTION_STATUS_ARRAYS_DETECTED זוהה לפחות מערך סולארי אחד בבניין הזה.
DETECTION_STATUS_NO_ARRAYS_DETECTED לא זוהו מערכים סולאריים בבניין הזה.