- בקשת HTTP
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- כסף
- 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
תיבה תוחמת (bounding box) בקואורדינטות של קו רוחב/lng.
ייצוג 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 |
הכמות המקבילה של פחמן דו-חמצני המופקת לכל מגה-ואט של חשמל ברשת. זהו מדד של עוצמת הפחמן של החשמל ברשת החשמל שנפלט מחשמל סולארי. |
wholeRoofStats |
הגודל הכולל וכמויות אור השמש של חלק הגג שהוקצה לחלק מסוים של הגגות. למרות השם, ייתכן שהוא לא כולל את כל הבניין. |
buildingStats |
גודל וכמויות אור השמש של הבניין כולו, כולל חלקים מהגג שלא הוקצו לחלק מסוים של הגגות. הכיוונים של החלקים האלה לא מאופיינים היטב, ולכן אומדן שטח הגגות לא אמין, אבל ההערכה של שטח הקרקע היא אמינה. יכול להיות שניתן לקבל שטח גג שלם ואמין יותר על ידי שינוי גודל הגגות מ- |
roofSegmentStats[] |
הגודל וכמויות אור השמש לכל קטע גג. |
solarPanels[] |
כל |
solarPanelConfigs[] |
כל |
financialAnalyses[] |
|
SizeAndSunshineStats
גודל ומידת שמשייה של גג או חלק מהגג
ייצוג JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
שדות | |
---|---|
areaMeters2 |
השטח של מקטע הגג או הגג, במטרים^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
הכיוון של לוח סולארי. יש לפרש זאת ביחס לאזימוט של קטע הגג שעליו ממוקם הלוח.
טיפוסים בני מנייה (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 |
חיסכון ב-20 השנים הראשונות אחרי התקנת הלוחות. |
presentValueOfSavingsYear20 |
באמצעות שיעור ההנחה המשוער, מה הערך הנוכחי של החיסכון המצטבר ל-20 שנים? |
savingsLifetime |
חיסכון בכל משך החיים של הלוח. |
presentValueOfSavingsLifetime |
לפי שיעור ההנחה המשוער, מה הערך הנוכחי של החיסכון המצטבר לטווח הארוך? |
financiallyViable |
מציינת אם התרחיש הזה כדאי מבחינה כלכלית. הערך יהיה 'לא נכון' במקרים שבהם יש כדאיות פיננסית נמוכה (למשל, אובדן כסף). |
CashPurchaseSavings
העלות והתועלת של רכישה מוחלטת של תצורה מסוימת של לוחות סולאריים עם צריכת חשמל מסוימת.
ייצוג JSON |
---|
{ "outOfPocketCost": { object ( |
שדות | |
---|---|
outOfPocketCost |
העלות הראשונית לפני תמריצי מס: הסכום שיש לשלם מכובד. לעומת זאת, הערך של |
upfrontCost |
העלות הראשונית לאחר תמריצי מס: זהו הסכום שיש לשלם במהלך השנה הראשונה. לעומת זאת, הערך של |
rebateValue |
הערך של כל החזרי המס. |
savings |
כמה נשמר (או לא) במשך תקופת החיים. |
paybackYears |
מספר השנים עד להחזר התשלום. המשמעות של ערך שלילי היא שההחזר לא מתרחש אף פעם במהלך תקופת החיים. |
FinancedPurchaseSavings
העלות והתועלת של השימוש בהלוואה לקניית תצורה מסוימת של לוחות סולאריים עם צריכת חשמל מסוימת.
ייצוג JSON |
---|
{ "annualLoanPayment": { object ( |
שדות | |
---|---|
annualLoanPayment |
תשלומי הלוואות שנתיים. |
rebateValue |
הערך של כל החזרי המס (כולל Federal Investment Tax Credit (ITC)). |
loanInterestRate |
שיעור הריבית על הלוואות בהנחה בקבוצת החישובים הזו. |
savings |
כמה נשמר (או לא) במשך תקופת החיים. |