- בקשת HTTP
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Money
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- רוצים לנסות?
הפונקציה מחפשת את הבניין הקרוב ביותר לנקודת שאילתה. מחזירה שגיאה עם הקוד NOT_FOUND
אם אין מבנים בטווח של כ-50 מטרים מנקודת השאילתה.
בקשת HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
location |
חובה. קווי האורך והרוחב שמהם ה-API מחפש את הבניין הקרוב ביותר הידוע. |
requiredQuality |
זה שינוי אופציונלי. רמת האיכות המינימלית המותרת בתוצאות. לא תוחזר תוצאה באיכות נמוכה מזו. אם לא מציינים זאת, הגדרה זו זהה להגבלה של 'איכות גבוהה' בלבד. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
הודעת תשובה לגבי Solar.FindClosestBuildingInsights
. מידע על המיקום, המידות והפוטנציאל הסולארי של מבנה.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "name": string, "center": { object ( |
שדות | |
---|---|
name |
שם משאב הבניין, בפורמט |
center |
נקודה ליד מרכז המבנה. |
boundingBox |
התיבה התוחמת של הבניין. |
imageryDate |
התאריך שבו נרכשו התמונות המקוריות. הנתון הזה משוער. |
imageryProcessedDate |
כשהעיבוד של התמונות האלה הושלם. |
postalCode |
מיקוד (למשל, מיקוד בארה"ב) שהבניין הזה נמצא בו. |
administrativeArea |
אזור מנהלי 1 (למשל, המדינה בארה"ב) שכולל את המבנה הזה. לדוגמה, בארה"ב, הקיצור יכול להיות "MA" או "CA". |
statisticalArea |
אזור סטטיסטי (למשל, רשות האוכלוסין בארה"ב) שהבניין הזה נמצא בו. |
regionCode |
קוד האזור של המדינה (או האזור) שהבניין הזה נמצא בו. |
solarPotential |
הפוטנציאל הסולארי של הבניין. |
imageryQuality |
איכות התמונות ששימשו לחישוב הנתונים עבור הבניין הזה. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
תיבה תוחמת בקואורדינטות של קווי אורך ורוחב.
ייצוג JSON |
---|
{ "sw": { object ( |
שדות | |
---|---|
sw |
הפינה הדרום-מערבית של התיבה. |
ne |
הפינה הצפון-מזרחית של התיבה. |
SolarPotential
מידע על הפוטנציאל הסולארי של בניין. כמה שדות מוגדרים בהקשר של "panels" (לוחות). השדות panelCapacityWatts
, panelHeightMeters
ו-panelWidthMeters
מתארים את הפרמטרים של מודל הלוח שבו נעשה שימוש בחישובים האלה.
ייצוג JSON |
---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
שדות | |
---|---|
maxArrayPanelsCount |
גודל המערך המקסימלי - כלומר, המספר המקסימלי של לוחות שיכולים להתאים על הגג. |
panelCapacityWatts |
קיבולת, בוואט, של הלוח ששימש בחישובים. |
panelHeightMeters |
הגובה במטרים לאורך, של הלוח ששימש לחישובים. |
panelWidthMeters |
הרוחב, במטרים לאורך, של הלוח ששימש לחישובים. |
panelLifetimeYears |
משך החיים הצפוי (בשנים) של הלוחות הסולאריים. משמש לחישובים הפיננסיים. |
maxArrayAreaMeters2 |
הגודל במטרים רבועים, של המערך המקסימלי. |
maxSunshineHoursPerYear |
המספר המקסימלי של שעות שמש שהתקבלו בשנה, בכל נקודה על הגג. שעות שמש הן מדד של הסכום הכולל של בידוד (אנרגיה) שמתקבל בשנה. שעת שמש אחת = 1 קוט"ש לקילוואט (כאשר קילוואט מתייחס לקיבולת של קילוואט בהתאם לתנאי הבדיקה הרגילים). |
carbonOffsetFactorKgPerMwh |
הכמות המקבילה של פחמן דו-חמצני שמופקת לכל MWh של חשמל ברשת. זהו מדד של עוצמת הפחמן של החשמל ברשת שמקורו בחשמל סולארי. |
wholeRoofStats |
הגודל הכולל וכמות אור השמש לחלק של הגג שהוקצה לחלק מהגג. למרות השם, ייתכן שהוא לא יכלול את כל הבניין. |
buildingStats |
גודל וכמות אור השמש של הבניין כולו, כולל חלקים של הגג שלא הוקצו לחלק מהגג. מאחר שהכיוונים של החלקים האלה לא מאופיינים היטב, ההערכה של שטח הגג אינה אמינה, אבל אומדן שטח הקרקע הוא אמין. ייתכן שניתן יהיה לקבל שטח גג שלם אמין יותר על ידי התאמת שטח הגג מ- |
roofSegmentStats[] |
גודל וכמות אור השמש לכל מקטע גג. |
solarPanels[] |
כל |
solarPanelConfigs[] |
בכל |
financialAnalyses[] |
|
SizeAndSunshineStats
גודל וריבועים של גג או חלק מהגג.
ייצוג JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
שדות | |
---|---|
areaMeters2 |
השטח של גג או קטע הגג, ב-m^2. זהו שטח הגג (שמשקף את ההטיה), ולא שטח טביעת הרגל הפחמנית. |
sunshineQuantiles[] |
כמויות השמש המדויקות באזור. אם יש כאן N ערכים, הוא מייצג את (N-1). לדוגמה, אם קיימים 5 ערכים, הם יהיו הרבעונים (מינימום, 25%, 50%, 75%, מקסימום). הערכים הם בקוט"ש שנתי/קוט"ש, כמו |
groundAreaMeters2 |
שטח טביעת הרגל הפחמנית שמכוסה על ידי קטע הגג או הגג, ב-m^2. |
RoofSegmentSizeAndSunshineStats
מידע על גודל הקטע מהגג ואחוזי השמש שלו.
ייצוג JSON |
---|
{ "stats": { object ( |
שדות | |
---|---|
stats |
הגודל הכולל וכמות אור השמש של קטע הגג. |
center |
נקודה ליד מרכז הקטע של הגג. |
boundingBox |
התיבה התוחמת את הקטע בגג. |
pitchDegrees |
הזווית של קטע הגג ביחס למישור הקרקעי התיאורטי. 0 = מקביל לקרקע, 90 = אנכי לקרקע. |
azimuthDegrees |
הכיוון של המצפן שאליו פונה קטע הגג. 0 = צפון, 90 = מזרח, 180 = דרום. בקטע גג "שטוח" ( |
planeHeightAtCenterMeters |
גובה מישור קטע הגג, במטרים מעל פני הים, בנקודה שצוינה על ידי |
SolarPanel
SolarPanel מתאר את המיקום, הכיוון והייצור של לוח סולארי יחיד. מידע על הפרמטרים של החלונית זמין בשדות panelHeightMeters
, panelWidthMeters
ו-panelCapacityWatts
ב-SolarPotential
.
ייצוג JSON |
---|
{ "center": { object ( |
שדות | |
---|---|
center |
מרכז הלוח. |
orientation |
הכיוון של הלוח. |
yearlyEnergyDcKwh |
כמה אנרגיית אור קולטת בפריסה הזו במהלך שנה, בקוט"ש DC. |
segmentIndex |
אינדקס |
SolarPanelOrientation
הכיוון של לוח סולארי. יש לפרש את זה ביחס לאזימוט של מקטע הגג שעליו מוצבת הפאנל.
טיפוסים בני מנייה (enums) | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
לא ידוע כיוון הלוח. |
LANDSCAPE |
הקצה הארוך של לוח LANDSCAPE מאונך לכיוון האזימוט של קטע הגג שעליו הוא ממוקם. |
PORTRAIT |
הקצה הארוך של לוח PORTRAIT מקביל לכיוון האזימוט של קטע הגג שעליו הוא ממוקם. |
SolarPanelConfig
SolarPanelConfig מתאר מיקום מסוים של לוחות סולאריים על הגג.
ייצוג JSON |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
שדות | |
---|---|
panelsCount |
מספר הלוחות הכולל. חשוב לשים לב שזו מיותרת (הסכום הכולל) של השדות התואמים ב- |
yearlyEnergyDcKwh |
כמות אנרגיית אור השמש שהפריסה הזו צורכת במהלך שנה, בקוט"ש DC, בהנחה שהלוחות המתוארים למעלה. |
roofSegmentSummaries[] |
מידע על הייצור של כל מקטע על הגג שכולל לוח אחד לפחות בפריסה הזו. |
RoofSegmentSummary
מידע על קטע גג של הבניין, עם כמה לוחות מוצבים עליו.
ייצוג JSON |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
שדות | |
---|---|
panelsCount |
המספר הכולל של הלוחות בפלח הזה. |
yearlyEnergyDcKwh |
כמה אנרגיית אור שמש החלק הזה בפריסה לאורך שנה, בקוט"ש DC, בהנחה שהלוחות המתוארים למעלה. |
pitchDegrees |
הזווית של קטע הגג ביחס למישור הקרקעי התיאורטי. 0 = מקביל לקרקע, 90 = אנכי לקרקע. |
azimuthDegrees |
הכיוון של המצפן שאליו פונה קטע הגג. 0 = צפון, 90 = מזרח, 180 = דרום. בקטע גג "שטוח" ( |
segmentIndex |
אינדקס ב- |
FinancialAnalysis
ניתוח העלות והיתרונות של הפריסה הסולארית האופטימלית לגודל חשבון חשמל מסוים.
ייצוג JSON |
---|
{ "monthlyBill": { object ( |
שדות | |
---|---|
monthlyBill |
חשבון החשמל החודשי המשוער שהניתוח הזה מבוסס עליו. |
defaultBill |
אם זה סכום החיוב שנבחר כברירת המחדל לחיוב באזור שבו נמצא הבניין. |
averageKwhPerMonth |
כמות החשמל שהבית צורכת בחודש ממוצע, על סמך גודל החשבון ותעריפי החשמל המקומיים. |
financialDetails |
מידע פיננסי שחל ללא קשר לשיטת המימון שבה נעשה שימוש. |
leasingSavings |
העלות והתועלת של החכירה של הלוחות הסולאריים |
cashPurchaseSavings |
מה העלות והתועלת של קניית הלוחות הסולאריים במזומן? |
financedPurchaseSavings |
העלות והתועלת של קניית הלוחות הסולאריים על ידי מימון הרכישה. |
panelConfigIndex |
אינדקס ב- |
כסף
מייצג סכום כסף עם סוג המטבע שלו.
ייצוג JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
שדות | |
---|---|
currencyCode |
קוד המטבע בן שלוש האותיות המוגדר בתקן ISO 4217. |
units |
מספר היחידות השלמות של הסכום. לדוגמה, אם הערך של |
nanos |
מספר יחידות הננו (10^-9) של הסכום. הערך חייב להיות בין -999,999,999 ו+999,999,999, כולל. אם הערך של |
FinancialDetails
פרטים של ניתוח פיננסי. חלק מהפרטים האלה כבר שמורים ברמות גבוהות יותר (למשל, עלות גבוהה יותר). סכומי הכסף הכוללים מבוססים על תקופת חיים שהוגדרה על ידי השדה panelLifetimeYears
בSolarPotential
. הערה: העלות של רכישת הלוחות מצוינת בשדה outOfPocketCost
בCashPurchaseSavings
.
ייצוג JSON |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
שדות | |
---|---|
initialAcKwhPerYear |
כמה קוט"ש של זרם חילופין אנחנו חושבים שהלוחות הסולאריים יפיקו בשנה הראשונה. |
remainingLifetimeUtilityBill |
חשבון על תשתיות חשמליות שלא מיוצרות על ידי לוחות סולאריים, לכל משך החיים של הלוחות. |
federalIncentive |
סכום הכסף שזמין מתמריצים פדרליים. הסכום הזה חל אם המשתמש קונה את החלוניות (עם או בלי הלוואה). |
stateIncentive |
סכום הכסף הזמין מהתמריצים של המדינה. הסכום הזה חל אם המשתמש קונה את החלוניות (עם או בלי הלוואה). |
utilityIncentive |
סכום הכסף שזמין לתמריצים לשימוש בתשתיות. הסכום הזה חל אם המשתמש קונה את הלוחות (עם או בלי הלוואה). |
lifetimeSrecTotal |
סכום הכסף שהמשתמש יקבל מזיכויים על אנרגיה מתחדשת של אנרגיה מתחדשת במהלך חיי הפאנל. סכום זה חל אם המשתמש קונה את הלוחות (עם או בלי הלוואה). |
costOfElectricityWithoutSolar |
העלות הכוללת של חשמל שהמשתמש היה משלם במשך תקופת החיים אם לא היה מתקין לוחות סולאריים. |
netMeteringAllowed |
האם מותר להשתמש במונה נטו. |
solarPercentage |
האחוז (0-100) מכוח השימוש של המשתמש באנרגיה סולארית. בתוקף לשנה הראשונה אבל נכון לשנים הבאות, בקירוב. |
percentageExportedToGrid |
האחוז (0-100) של ייצור החשמל הסולארי שהנחנו מיוצא לרשת, בהתבסס על הרבעון הראשון של הייצור. אם לא ניתן להשתמש במונה נטו, תהיה לכך השפעה על החישובים. |
LeasingSavings
העלות והתועלת של חכירה של תצורה מסוימת של לוחות סולאריים עם צריכת חשמל מסוימת.
ייצוג JSON |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
שדות | |
---|---|
leasesAllowed |
האם השכירות מותרת בסמכות השיפוט הזו (החכירות אסורים במדינות מסוימות). אם השדה הזה מוגדר כ-False, כנראה יש להתעלם מהערכים בהודעה. |
leasesSupported |
האם השכירות נתמכת בסמכות השיפוט הזו על ידי מנוע החישוב הפיננסי. אם השדה הזה מוגדר כ-False, כנראה יש להתעלם מהערכים בהודעה. זה לא תלוי ב- |
annualLeasingCost |
עלות ליסינג שנתית משוערת. |
savings |
כמה נחסכו (או לא) במשך כל תקופת החיים. |
SavingsOverTime
מידע פיננסי שמשותף בין שיטות מימון שונות.
ייצוג JSON |
---|
{ "savingsYear1": { object ( |
שדות | |
---|---|
savingsYear1 |
חיסכון בשנה הראשונה לאחר התקנת הלוחות. |
savingsYear20 |
חיסכון ב-20 השנים הראשונות לאחר התקנת הלוחות. |
presentValueOfSavingsYear20 |
על סמך שיעור ההנחה המשוער, מהו הערך הנוכחי של החיסכון המצטבר ב-20 השנים האחרונות? |
savingsLifetime |
חיסכון בכל משך החיים של הלוח. |
presentValueOfSavingsLifetime |
על סמך שיעור ההנחה המשוער, מהו הערך הנוכחי של החיסכון המצטבר בכל משך החיים? |
financiallyViable |
מציין אם התרחיש הזה ישים מבחינה כלכלית. הערך יהיה false עבור תרחישים שבהם כדאיות פיננסית נמוכה (למשל, הפסד כסף). |
CashPurchaseSavings
העלות והתועלת של רכישה ישירה של תצורה מסוימת של לוחות סולאריים עם צריכת חשמל מסוימת.
ייצוג JSON |
---|
{ "outOfPocketCost": { object ( |
שדות | |
---|---|
outOfPocketCost |
עלות ראשונית לפני תמריצי מס: הסכום שיש לשלם מכיס. בניגוד ל |
upfrontCost |
עלות ראשונית לאחר תמריצי מס: זה הסכום שיש לשלם במהלך השנה הראשונה. בניגוד ל- |
rebateValue |
הערך של כל החזרי המס. |
savings |
כמה נחסכו (או לא) במשך כל תקופת החיים. |
paybackYears |
מספר השנים עד לביצוע ההחזר הכספי. ערך שלילי פירושו שההחזר הכספי לעולם לא מתרחש במהלך תקופת החיים. |
FinancedPurchaseSavings
העלות והתועלת של השימוש בהלוואה לקניית תצורה מסוימת של לוחות סולאריים עם צריכת חשמל מסוימת.
ייצוג JSON |
---|
{ "annualLoanPayment": { object ( |
שדות | |
---|---|
annualLoanPayment |
תשלומי הלוואה שנתיים. |
rebateValue |
הערך של כל החזרי המס (כולל זיכוי מס השקעות פדרלי (ITC)). |
loanInterestRate |
שיעור הריבית על הלוואות שנלקחות בקבוצת החישובים הזו. |
savings |
כמה נחסכו (או לא) במשך כל תקופת החיים. |