Method: buildingInsights.findClosest

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

בקשת HTTP

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

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

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

פרמטרים
location

object (LatLng)

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

enum (ImageryQuality)

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

boolean

אופציונלי. אם לדרוש איכות מדויקת של התמונות. אם הערך הוא False, השדה requiredQuality מפורש כאיכות המינימלית הנדרשת, כך שתמונות באיכות HIGH עשויות להיות מוחזרות כאשר requiredQuality מוגדר כ-MEDIUM. אם הערך הוא 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

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

number

כמות שוות ערך של CO2 שנוצרת לכל מגה-ואט לשעה של חשמל ברשת. זהו מדד לשיעור פליטת הפחמן מרשת החשמל שהוחלפה בחשמל סולארי.
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)-iles. לדוגמה, אם יש 5 ערכים, הם יהיו הרבעונים (מינימום, 25%, 50%, 75%, מקסימום). הערכים הם בקילוואט-שעה/קילוואט לשנה, כמו maxSunshineHoursPerYear.
groundAreaMeters2

number

השטח של הגג או של מקטע הגג במטרים רבועים.

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)

התיבה התוחמת (bounding box) של מקטע הגג.
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

האם זהו גודל החשבון שנבחר כחשבון ברירת המחדל לאזור שבו נמצא המבנה הזה. צריך להגדיר defaultBill אחד בדיוק ב-FinancialAnalysis ב-BuildingSolarPotential.
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", המשמעות היא שיחידה אחת שווה לדולר ארה"ב אחד.
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)

החיסכון ב-20 השנים הראשונות אחרי התקנת הפאנלים.
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),
  "arrays": [
    {
      object (SolarArray)
    }
  ],
  "latestCaptureDate": {
    object (Date)
  }
}
שדות
detectionStatus

enum (DetectionStatus)

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

object (SolarArray)

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

object (Date)

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

DetectionStatus

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

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

SolarArray

פרטים של מערך סולארי יחיד שזוהה.

ייצוג ב-JSON 
{
  "polygonGeojson": {
    object
  }
}
שדות
polygonGeojson

object (Struct format)

ייצוג GeoJSON של שטח המבנה שבו זוהו לוחות סולאריים.

נתוני ה-GeoJSON צריכים להיות בפורמט RFC 7946 ולייצג פוליגון של אזור רציף אחד.

אם הפוליגון מכיל חורים, הוא ייוצג על ידי כמה לולאות.

דוגמה:

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }