- בקשת 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 משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
location |
חובה. קו האורך וקו הרוחב שמהם ה-API מחפש את המבנה הידוע הקרוב ביותר. |
requiredQuality |
אופציונלי. רמת האיכות המינימלית המותרת בתוצאות. לא תוחזר תוצאה באיכות נמוכה יותר. אם לא מציינים את הערך הזה, המשמעות היא הגבלה לתמונות באיכות גבוהה בלבד. |
experiments[] |
אופציונלי. מציין את התכונות מ-GA4 שרוצים להפעיל. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
הודעת התגובה עבור 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) בקואורדינטות של קו הרוחב/קו האורך.
ייצוג ב-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 שנוצרת לכל מגה-ואט-שעה של חשמל מרשת. מדד של עצימות הפחמן של חשמל מרשת שהוחלף בחשמל סולארי. |
wholeRoofStats |
הגודל הכולל ופרקי הזמן של אור השמש בחלק מהגג שהוקצה לפלח גג כלשהו. למרות השם, יכול להיות שהיא לא תכלול את כל הבניין. |
buildingStats |
גודל וקוונטילים של אור השמש בכל המבנה, כולל חלקים מהגג שלא הוקצו לחלק מסוים של הגג. מכיוון שהכיוונים של החלקים האלה לא מוגדרים בצורה טובה, האומדן של שטח הגג לא מהימן, אבל האומדן של שטח הקרקע מהימן. יכול להיות ששטח הגג של כל המבנה יהיה מהימן יותר אם יתבצע שינוי קנה מידה של שטח הגג מ- |
roofSegmentStats[] |
גודל וקוונטילים של קרינת השמש לכל מקטע גג. |
solarPanels[] |
כל |
solarPanelConfigs[] |
כל |
financialAnalyses[] |
הערך של |
SizeAndSunshineStats
גודל ופרמטרים של שמשיות של גג או של חלק מגג.
ייצוג ב-JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
שדות | |
---|---|
areaMeters2 |
שטח הגג או מקטע הגג, במטרים רבועים. זהו אזור הגג (כולל שיפוע), ולא אזור שטח הקרקע. |
sunshineQuantiles[] |
קוינטלים של שמשיות נקודתית ברחבי האזור. אם יש כאן N ערכים, הם מייצגים את ה-(N-1)-iles. לדוגמה, אם יש 5 ערכים, הם יהיו הרבעונים (min, 25%, 50%, 75%, max). הערכים הם ב-kWh לשנה ל-kW, כמו |
groundAreaMeters2 |
שטח התחום של הקרקע שמכוסה על ידי הגג או מקטע הגג, במטרים רבועים. |
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 |
מציין אם התרחיש הזה כלכלי. הערך יהיה שקר בתרחישים עם כדאיות פיננסית נמוכה (למשל, הפסדים כספיים). |
CashPurchaseSavings
העלות והתועלת של רכישה מיידית של הגדרה מסוימת של לוחות סולאריים עם צריכת חשמל מסוימת.
ייצוג ב-JSON |
---|
{ "outOfPocketCost": { object ( |
שדות | |
---|---|
outOfPocketCost |
העלות הראשונית לפני תמריצי המס: הסכום שצריך לשלם מכיסכם. בניגוד לערך |
upfrontCost |
העלות הראשונית אחרי תמריצי המס: הסכום שצריך לשלם במהלך השנה הראשונה. בניגוד לערך של |
rebateValue |
הערך של כל ההחזרים על מיסים. |
savings |
כמה חסכתם (או לא חסכתם) במהלך תקופת החיים. |
paybackYears |
מספר השנים עד לתשלום ההחזר. ערך שלילי מציין שההחזר על ההוצאה לא מתרחש אף פעם במהלך תקופת החיים. |
FinancedPurchaseSavings
העלות והתועלת של שימוש בהלוואה לרכישת הגדרה מסוימת של לוחות סולאריים עם צריכת חשמל מסוימת.
ייצוג ב-JSON |
---|
{ "annualLoanPayment": { object ( |
שדות | |
---|---|
annualLoanPayment |
תשלומי הלוואה שנתיים. |
rebateValue |
הערך של כל ההחזרים על מס (כולל Federal Investment Tax Credit (ITC)). |
loanInterestRate |
שיעור הריבית על ההלוואות שמשוער בקבוצת החישובים הזו. |
savings |
כמה חסכתם (או לא חסכתם) במהלך תקופת החיים. |