- בקשת 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 מחפש את המבנה הידוע הקרוב ביותר. |
required |
זה שינוי אופציונלי. רמת האיכות המינימלית המותרת בתוצאות. לא תוחזר תוצאה עם איכות נמוכה יותר. אם לא מציינים את האפשרות הזו, המשמעות היא הגבלה לתמונות באיכות גבוהה בלבד. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
הודעת התשובה עבור Solar.FindClosestBuildingInsights
. מידע על המיקום, המימדים והפוטנציאל הסולארי של מבנה.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{ "name": string, "center": { object ( |
שדות | |
---|---|
name |
שם המשאב של הבניין, בפורמט |
center |
נקודה ליד מרכז המבנה. |
bounding |
התיבה התוחמת (bounding box) של המבנה. |
imagery |
התאריך שבו התמונות הבסיסיות נרכשו. הערך הזה הוא משוער. |
imagery |
מתי הסתיים העיבוד של התמונות האלה. |
postal |
מיקוד (למשל, מיקוד בארה"ב) שבו נמצא המבנה. |
administrative |
אזור 1 (למשל, בארצות הברית, המדינה) שמכיל את הבניין הזה. לדוגמה, בארה"ב, הקיצור יכול להיות 'MA' או 'CA'. |
statistical |
אזור סטטיסטי (למשל, אזור אוכלוסין בארה"ב) שבו נמצא הבניין. |
region |
קוד האזור של המדינה (או האזור) שבה נמצא הבניין. |
solar |
הפוטנציאל הסולארי של המבנה. |
imagery |
איכות התמונות ששימשו לחישוב הנתונים של הבניין הזה. |
היקפי הרשאה
נדרש היקף הרשאות 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 ( |
שדות | |
---|---|
max |
גודל המערך המקסימלי – כלומר, המספר המקסימלי של הפאנלים שיכולים להתאים לגג. |
panel |
הקיבולת, בוולט, של הפאנל ששימש לחישוב. |
panel |
הגובה, במטרים בפריסה לאורך, של הלוח שמשמש בחישובים. |
panel |
רוחב החלונית, במטרים בכיוון לאורך, שמשמשת לחישוב. |
panel |
משך החיים הצפוי של הלוחות הסולאריים, בשנים. המערכת משתמשת בנתון הזה לצורך החישובים הפיננסיים. |
max |
הגודל, במטרים רבועים, של המערך המקסימלי. |
max |
מספר שעות השמש המקסימלי שמתקבלות בשנה, בכל נקודה על הגג. שעות שמש הן מדד לכמות האנרגיה הסולארית (הקרינה) שמתקבלת מדי שנה. שעה של שמש = 1 קוט"ש לכל קילוואט (כאשר קילוואט מתייחס לקיבולת של קילוואט בתנאי בדיקה רגילים). |
carbon |
כמות מקבילית של CO2 שנפלטת לכל מגה-ואט של חשמל מרשת. מדד של עצימות הפחמן של חשמל מרשת שהוחלף בחשמל סולארי. |
whole |
הגודל הכולל ופרקי הזמן של אור השמש בחלק מהגג שהוקצה לפלח גג כלשהו. למרות השם, יכול להיות שהיא לא תכלול את כל הבניין. |
building |
גודל וקוונטילים של אור השמש בכל המבנה, כולל חלקים מהגג שלא הוקצו לחלק מסוים של הגג. מכיוון שהכיוונים של החלקים האלה לא מוגדרים בצורה טובה, האומדן של שטח הגג לא מהימן, אבל האומדן של שטח הקרקע מהימן. יכול להיות ששטח הגג של כל המבנה יהיה מהימן יותר אם יתבצע שינוי קנה מידה של שטח הגג מ- |
roof |
גודל וקווינטילים של קרינת השמש לכל מקטע גג. |
solar |
כל |
solar |
כל |
financial |
הערך של |
SizeAndSunshineStats
גודל ופרמטרים של שמשיות של גג או חלק מגג.
ייצוג ב-JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
שדות | |
---|---|
area |
שטח הגג או מקטע הגג, במטרים רבועים. זהו אזור הגג (כולל שיפוע), ולא אזור שטח הקרקע. |
sunshine |
קוינטלים של שמשיות נקודתית ברחבי האזור. אם יש כאן N ערכים, הם מייצגים את ה-(N-1)-iles. לדוגמה, אם יש 5 ערכים, אלה יהיו הרבעונים (min, 25%, 50%, 75%, max). הערכים הם ב-kWh לשנה ל-kW, כמו |
ground |
שטח התחום של הקרקע שמכוסה על ידי הגג או מקטע הגג, במטרים רבועים. |
RoofSegmentSizeAndSunshineStats
מידע על הגודל ועל הרבעונים של שמשיות בחלק של הגג.
ייצוג ב-JSON |
---|
{ "stats": { object ( |
שדות | |
---|---|
stats |
הגודל הכולל ועשירונות של אור השמש בחלק של הגג. |
center |
נקודה ליד מרכז מקטע הגג. |
bounding |
התיבה התוחמת של מקטע הגג. |
pitch |
הזווית של מקטע הגג ביחס למישור הקרקע התיאורטי. 0 = מקביל לקרקע, 90 = אנכי לקרקע. |
azimuth |
כיוון המצפן שאליו פונה מקטע הגג. 0 = צפון, 90 = מזרח, 180 = דרום. בחלק 'שטוח' של גג ( |
plane |
הגובה של מישור מקטע הגג, במטרים מעל פני הים, בנקודה שסימנתם ב- |
SolarPanel
השדה SolarPanel מתאר את המיקום, הכיוון והייצור של לוח סולארי יחיד. מידע על הפרמטרים של החלונית זמין בשדות panelHeightMeters
, panelWidthMeters
ו-panelCapacityWatts
ב-SolarPotential
.
ייצוג ב-JSON |
---|
{ "center": { object ( |
שדות | |
---|---|
center |
מרכז החלונית. |
orientation |
הכיוון של הלוח. |
yearly |
כמות האנרגיה מאור השמש שהפריסה הזו קולטת במהלך שנה, בקוט"ש (DC). |
segment |
האינדקס ב- |
SolarPanelOrientation
הכיוון של לוח סולארי. צריך לפרש את הערך הזה ביחס לאזימוט של מקטע הגג שבו מותקן הפאנל.
טיפוסים בני מנייה (enum) | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
לא ידוע איזה כיוון יש ללוח. |
LANDSCAPE |
הקצה הארוך של פאנל LANDSCAPE ניצב לכיוון האזימוט של מקטע הגג שבו הוא ממוקם. |
PORTRAIT |
הקצה הארוך של לוח PORTRAIT מקביל לכיוון האזימוט של מקטע הגג שבו הוא מונח. |
SolarPanelConfig
SolarPanelConfig מתאר מיקום ספציפי של לוחות סולאריים על הגג.
ייצוג ב-JSON |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
שדות | |
---|---|
panels |
המספר הכולל של הלוחות. שימו לב שהערך הזה הוא יתיר (לסכום) השדות התואמים ב- |
yearly |
כמות האנרגיה מאור השמש שהפריסה הזו קולטת במהלך שנה, בקוט"ש (DC), בהנחה שהלוחות מתוארים למעלה. |
roof |
מידע על הייצור של כל מקטע גג שמכיל לפחות פאנל אחד בפריסה הזו. |
RoofSegmentSummary
מידע על מקטע גג בבניין, עם מספר מסוים של פאנלים שמותקנים עליו.
ייצוג ב-JSON |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
שדות | |
---|---|
panels |
המספר הכולל של החלוניות בקטע הזה. |
yearly |
כמות האנרגיה מאור השמש שהחלק הזה של הפריסה קולט במהלך שנה, בקוט"ש (DC), בהנחה שהלוחות מתאימים למה שמתואר למעלה. |
pitch |
הזווית של מקטע הגג ביחס למישור הקרקע התיאורטי. 0 = מקביל לקרקע, 90 = אנכי לקרקע. |
azimuth |
כיוון המצפן שאליו פונה מקטע הגג. 0 = צפון, 90 = מזרח, 180 = דרום. בחלק 'שטוח' של גג ( |
segment |
האינדקס ב- |
FinancialAnalysis
ניתוח של העלות והיתרונות של הפריסה האופטימלית של אנרגיה סולארית בהתאם לגודל חשבון חשמל מסוים.
ייצוג ב-JSON |
---|
{ "monthlyBill": { object ( |
שדות | |
---|---|
monthly |
חשבון החשמל החודשי שמשוער בניתוח. |
default |
האם זהו גודל החשבון שנבחר כחשבון ברירת המחדל לאזור שבו נמצא הבניין. צריך להגדיר את |
average |
כמות החשמל שהבית צורך בחודש ממוצע, על סמך סכום החיוב ושיעור החשמל המקומי. |
financial |
מידע פיננסי שרלוונטי ללא קשר לשיטת המימון שבה נעשה שימוש. |
leasing |
העלות והתועלת של רכישת הלוחות הסולאריים. |
cash |
העלות והתועלת של קניית הלוחות הסולאריים במזומן. |
financed |
העלות והתועלת של רכישת הלוחות הסולאריים באמצעות מימון הרכישה. |
panel |
האינדקס ב- |
כסף
מייצג סכום כסף עם סוג המטבע שלו.
ייצוג ב-JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
שדות | |
---|---|
currency |
קוד המטבע בן שלוש האותיות כפי שמוגדר בתקן ISO 4217. |
units |
מספר היחידות השלמות של הסכום. לדוגמה: אם הערך של |
nanos |
מספר יחידות הננו (10^-9) של הסכום. הערך חייב להיות בין -999,999,999 ל- +999,999,999, כולל. אם הערך של |
FinancialDetails
פרטים של ניתוח פיננסי. חלק מהפרטים האלה כבר מאוחסנים ברמות גבוהות יותר (למשל, עלות מתוך כיס). הסכומים הכספיים הכוללים הם על פני תקופת חיים שמוגדרת בשדה panelLifetimeYears
בקובץ SolarPotential
. הערה: העלות בפועל של רכישת הלוחות מוצגת בשדה outOfPocketCost
בקטע CashPurchaseSavings
.
ייצוג ב-JSON |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
שדות | |
---|---|
initial |
כמה קילוואט-שעה (kWh) AC אנחנו צופים שהלוחות הסולאריים ייצרו בשנה הראשונה שלהם. |
remaining |
חשבון החשמל על חשמל שלא נוצר על ידי האנרגיה הסולארית, למשך כל חיי הלוחות. |
federal |
סכום הכסף שזמין מההטבות הפדרליות. הנתון הזה רלוונטי אם המשתמש קונה את הפאנלים (עם או בלי הלוואה). |
state |
סכום הכסף שזמין מההטבות של המדינה. הנתון הזה רלוונטי אם המשתמש קונה את הפאנלים (עם או בלי הלוואה). |
utility |
סכום הכסף שזמין מהטבות של ספקי החשמל. הנתון הזה רלוונטי אם המשתמש קונה את הפאנלים (עם או בלי הלוואה). |
lifetime |
סכום הכסף שהמשתמש יקבל מקרדיטים על אנרגיה מתחדשת סולארית במהלך חיי הפאנלים. הנתון הזה רלוונטי אם המשתמש קונה את הפאנלים (עם או בלי הלוואה). |
cost |
העלות הכוללת של החשמל שהמשתמש היה צריך לשלם במהלך תקופת החיים של המכשיר, אם לא היה מתקין מערכת סולארית. |
net |
אם מותר להשתמש במונה נטו. |
solar |
אחוז (0-100) מהחשמל של המשתמש שמגיע מאנרגיה סולארית. התקף לשנה הראשונה, אבל מדויק פחות או יותר בשנים הבאות. |
percentage |
האחוז (0-100) של הפקת החשמל מהאנרגיה הסולארית שהנחנו שהוא יוצא לרשת, על סמך הרבעון הראשון של הייצור. האפשרות הזו משפיעה על החישובים אם השימוש במונה נטו אסור. |
LeasingSavings
העלות והתועלת של רכישת זיכיון לשימוש בהגדרה מסוימת של לוחות סולאריים עם שימוש מסוים בחשמל.
ייצוג ב-JSON |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
שדות | |
---|---|
leases |
האם מותר לחתום על חוזי שכירות בסמכות השיפוט הזו (במדינות מסוימות אסור לחתום על חוזי שכירות). אם השדה הזה הוא false, סביר להניח שצריך להתעלם מהערכים בהודעה הזו. |
leases |
האם מנוע החישובים הפיננסיים תומך בהסכמי שכירות בסמכות השיפוט הזו. אם השדה הזה הוא false, סביר להניח שצריך להתעלם מהערכים בהודעה הזו. הערך הזה לא תלוי ב- |
annual |
עלות השכירות השנתית המשוערת. |
savings |
כמה חסכתם (או לא חסכתם) במהלך תקופת החיים. |
SavingsOverTime
מידע פיננסי שמשותף בין שיטות מימון שונות.
ייצוג ב-JSON |
---|
{ "savingsYear1": { object ( |
שדות | |
---|---|
savings |
החיסכון בשנה הראשונה לאחר התקנת הפאנלים. |
savings |
החיסכון בשנות הפעילות הראשונות של הפאנלים. |
present |
מהו הערך הנוכחי של החיסכון המצטבר לאורך 20 שנה, לפי שיעור ההנחה המשוער? |
savings |
החיסכון במהלך כל משך החיים של הפאנל. |
present |
מהו הערך הנוכחי של החיסכון המצטבר לכל משך החיים, לפי שיעור ההנחה המשוער? |
financially |
מציין אם התרחיש הזה כלכלי. הערך יהיה שקר בתרחישים עם כדאיות פיננסית נמוכה (למשל, הפסדים כספיים). |
CashPurchaseSavings
העלות והתועלת של רכישה מיידית של הגדרה מסוימת של לוחות סולאריים עם שימוש מסוים בחשמל.
ייצוג ב-JSON |
---|
{ "outOfPocketCost": { object ( |
שדות | |
---|---|
out |
העלות הראשונית לפני תמריצי המס: הסכום שצריך לשלם מכיסכם. בניגוד לערך |
upfront |
העלות הראשונית אחרי תמריצי המס: הסכום שצריך לשלם במהלך השנה הראשונה. בניגוד לערך של |
rebate |
הערך של כל ההחזרים על מיסים. |
savings |
כמה חסכתם (או לא חסכתם) במהלך תקופת החיים. |
payback |
מספר השנים עד לתשלום ההחזר. ערך שלילי מציין שההחזר על ההוצאה לא מתרחש אף פעם במהלך תקופת החיים. |
FinancedPurchaseSavings
העלות והתועלת של שימוש בהלוואה לרכישת הגדרה מסוימת של לוחות סולאריים עם שימוש מסוים בחשמל.
ייצוג ב-JSON |
---|
{ "annualLoanPayment": { object ( |
שדות | |
---|---|
annual |
תשלומי הלוואה שנתיים. |
rebate |
הערך של כל ההחזרים על מס (כולל Federal Investment Tax Credit (ITC)). |
loan |
שיעור הריבית על ההלוואות שמשוער בקבוצת החישובים הזו. |
savings |
כמה חסכתם (או לא חסכתם) במהלך תקופת החיים. |