- בקשת HTTP
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התגובה
- היקפי הרשאה
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Money
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- כדאי לנסות!
הפונקציה מאתרת את הבניין שהצנטרואיד שלו הכי קרוב לנקודת שאילתה. אם אין בניינים ברדיוס של כ-50 מטרים מנקודת השאילתה, הפונקציה מחזירה שגיאה עם קוד NOT_FOUND.
בקשת HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
location |
חובה. קו האורך וקו הרוחב שממנו ה-API מחפש את הבניין הידוע הקרוב ביותר. |
requiredQuality |
אופציונלי. רמת האיכות המינימלית שמותרת בתוצאות. לא יוחזר אף תוצאה באיכות נמוכה יותר. אם לא מציינים את המאפיין הזה, המשמעות היא הגבלה לאיכות גבוהה בלבד. |
exactQualityRequired |
אופציונלי. האם נדרשת איכות מדויקת של התמונות. אם הערך הוא false, השדה |
experiments[] |
אופציונלי. מציינת את התכונות בגרסת טרום-GA שיופעלו. |
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
הודעת תגובה ל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
מידע על הפוטנציאל הסולארי של בניין. חלק מהשדות מוגדרים במונחים של 'חלוניות'. השדות 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 |
כמות שוות-ערך של CO2 שנוצרת לכל MWh של חשמל מהרשת. זהו מדד של העצימות הפחמנית של חשמל מהרשת שהוחלף על ידי חשמל סולארי. |
wholeRoofStats |
הגודל הכולל והקוונטילים של אור השמש בחלק של הגג שהוקצה לפלח גג מסוים. למרות השם, יכול להיות שהכתובת לא כוללת את כל הבניין. |
buildingStats |
הכמויות של הגודל ואור השמש לכל הבניין, כולל חלקים בגג שלא הוקצו לפלח גג מסוים. מכיוון שהמיקומים של החלקים האלה לא מאופיינים היטב, האומדן של שטח הגג לא אמין, אבל האומדן של שטח הקרקע אמין. יכול להיות שאפשר לקבל שטח גג מהימן יותר של כל הבניין על ידי שינוי קנה המידה של שטח הגג מ- |
roofSegmentStats[] |
הגודל והאחוזון של כמות אור השמש לכל מקטע גג. |
solarPanels[] |
כל |
solarPanelConfigs[] |
כל |
financialAnalyses[] |
|
SizeAndSunshineStats
קוונטילים של גודל ושל מידת החשיפה לשמש של גג או חלק מגג.
| ייצוג ב-JSON |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| שדות | |
|---|---|
areaMeters2 |
שטח הגג או מקטע הגג, במטרים רבועים. זהו שטח הגג (כולל שיפוע), ולא שטח טביעת הרגל על הקרקע. |
sunshineQuantiles[] |
הכמויות של מידת החשיפה לשמש בנקודות שונות באזור. אם יש כאן N ערכים, הם מייצגים את אחוזוני (N-1). לדוגמה, אם יש 5 ערכים, הם יהיו הרבעונים (מינימום, 25%, 50%, 75%, מקסימום). הערכים הם בקוט"ש לשנה לכל קילוואט, כמו |
groundAreaMeters2 |
שטח טביעת הרגל על הקרקע שמכוסה על ידי הגג או קטע הגג, במ'^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
הכיוון של הפאנל הסולארי. הזווית הזו צריכה להיות מפורשת ביחס לאזימוט של מקטע הגג שעליו ממוקם הפאנל.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 |
כמה קילוואט-שעה של זרם חילופין (AC) אנחנו חושבים שהלוחות הסולאריים יפיקו בשנה הראשונה. |
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 |
החיסכון בעשרים השנים הראשונות לאחר התקנת הפאנל. |
presentValueOfSavingsYear20 |
מהו הערך הנוכחי של החיסכון המצטבר ל-20 שנה, בהתבסס על שיעור ההנחה המשוער? |
savingsLifetime |
חיסכון לאורך כל משך החיים של הפאנל. |
presentValueOfSavingsLifetime |
מהו הערך הנוכחי של החיסכון המצטבר לכל החיים, בהתבסס על שיעור ההנחה המשוער? |
financiallyViable |
מציין אם התרחיש הזה הוא בר-קיימא מבחינה כלכלית. הערך יהיה false בתרחישים שבהם הכדאיות הכלכלית נמוכה (למשל, הפסדים כספיים). |
CashPurchaseSavings
העלות והתועלת של רכישה ישירה של הגדרה מסוימת של לוחות סולאריים עם שימוש מסוים בחשמל.
| ייצוג ב-JSON |
|---|
{ "outOfPocketCost": { object ( |
| שדות | |
|---|---|
outOfPocketCost |
העלות הראשונית לפני תמריצי מס: הסכום שצריך לשלם מכיסכם. השוואה ל- |
upfrontCost |
העלות הראשונית אחרי הטבות מס: זה הסכום שצריך לשלם במהלך השנה הראשונה. ההטבות האלה שונות מהטבות המס |
rebateValue |
הערך של כל ההנחות במס. |
savings |
כמה נחסך (או לא נחסך) במהלך תקופת החיים. |
paybackYears |
מספר השנים עד להחזר ההשקעה. ערך שלילי מציין שההחזר לא מתרחש אף פעם במהלך תקופת החיים. |
FinancedPurchaseSavings
העלות והתועלת של שימוש בהלוואה לקניית תצורה מסוימת של לוחות סולאריים עם צריכת חשמל מסוימת.
| ייצוג ב-JSON |
|---|
{ "annualLoanPayment": { object ( |
| שדות | |
|---|---|
annualLoanPayment |
תשלומי הלוואה שנתיים. |
rebateValue |
הערך של כל ההנחות במס (כולל Federal Investment Tax Credit (ITC)). |
loanInterestRate |
שיעור הריבית על ההלוואות שמונחות בסט החישובים הזה. |
savings |
כמה נחסך (או לא נחסך) במהלך תקופת החיים. |