Method: buildingInsights.findClosest

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
location

object (LatLng)

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

enum (ImageryQuality)

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

גוף הבקשה

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

גוף התשובה

הודעת תשובה לגבי 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)
}
שדות
name

string

שם משאב הבניין, בפורמט building/<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)

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

היקפי הרשאות

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

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

LatLngBox

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

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

object (LatLng)

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

object (LatLng)

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

SolarPotential

מידע על הפוטנציאל הסולארי של בניין. כמה שדות מוגדרים בהקשר של "panels" (לוחות). השדות 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

הכמות המקבילה של פחמן דו-חמצני שמופקת לכל 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

השטח של גג או קטע הגג, ב-m^2. זהו שטח הגג (שמשקף את ההטיה), ולא שטח טביעת הרגל הפחמנית.
sunshineQuantiles[]

number

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

number

שטח טביעת הרגל הפחמנית שמכוסה על ידי קטע הגג או הגג, ב-m^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

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

טיפוסים בני מנייה (enums)
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", אז יחידה אחת היא דולר ארה"ב אחד.
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

כמה קוט"ש של זרם חילופין אנחנו חושבים שהלוחות הסולאריים יפיקו בשנה הראשונה.
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)

הערך של כל החזרי המס (כולל זיכוי מס השקעות פדרלי (ITC)).
loanInterestRate

number

שיעור הריבית על הלוואות שנלקחות בקבוצת החישובים הזו.
savings

object (SavingsOverTime)

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