חיפוש מבנים

Solar API משתמש בנתוני המיקום כדי לקבוע את סוג הבניין ומזהה מבנים על סמך צילומי לוויין. בדף הזה מוסבר איך לקבוע איזה מידע על אנרגיה סולארית של בניין יוחזר בבקשה buildingInsights.

סוגי מבנים

ב-Solar API יש תמיכה בבניינים מסוג premise. הסוג הזה מציין מיקום בעל שם, בדרך כלל בניין או אוסף של בניינים עם שם משותף.

אין תמיכה בסוגי נכסים אחרים, כמו subpremise או מתחמים – למשל, מבנים נפרדים שנמצאים בנכס אחד, אלא אם הם רשומים כpremise.

גגות של מבנים

‏Solar API מזהה את המיקום האופטימלי של לוחות סולאריים על הגג על סמך תמונות לוויין. מבני מגורים, במיוחד עם גגות משופעיים, מזוהים ברמת דיוק גבוהה, אבל רמת הדיוק של זיהוי מבנים עם גגות שטוחים (למשל, בנייני דירות או בניינים מסחריים) עשויה להשתנות.

אם התשובה buildingInsights לא כוללת את השדה solarPanelConfigs, הבניין טופל כראוי אבל לא הצלחנו להתקין פאנלים על הגג. הסיבה לכך עשויה להיות שהגג קטן מדי כדי להציב בו פאנלים או שהוא מוצלל מדי והפאנלים לא יכולים לייצר כמות משמעותית של אנרגיה.

טיפ: על סמך גישות אחרות לבחירה, כולל בחירת משתמש ידנית או בחירת פרוגרמטית בהתאמה אישית, אפשר להשתמש בנקודת הקצה של Solar API‏ dataLayers כדי ליצור חישובים של פוטנציאל אנרגיה סולארית ומיקום של פאנלים.

חיפוש מכתובת

1. אפשר להמיר כתובת לקואורדינטות של קו הרוחב ואורך הגלובוס באמצעות Geocoding API או Place Autocomplete API.

   משתמשים ב-place_id כדי להפנות למקום התואם.

2. משתמשים בקואורדינטות של קווי האורך והרוחב של המקום בבקשה ל-Solar API‏ buildingInsights.

   • אם Solar API מוצא בניין תואם, צריך לבדוק שהערך של place_id בתשובה buildingInsights תואם לערך של place_id מ-Geocoding API או מ-Place Autocomplete API.
   • כדי להגביל את התוצאות למקומות מסוג premise, מוסיפים מסנן של סוג מקום לתגובות של Geocoding API או של Places API.

     {
     "name": "buildings/ChIJh0CMPQW7j4ARLrRiVvmg6Vs",
     "center": {
     "latitude": 37.4449739,
     "longitude": -122.13914659999998
     },...
     }

הערה: לפעמים מזהי המקומות לא יהיו זהים, כלומר הנתונים (lat, lng) שנמצאו בחיפוש לא יתקבלו באותה כתובת או באותו בניין. גם אם התגובה של Geocoding API היא ברמת פירוט ROOFTOP, יכול להיות לסוג של place_id ערך שונה מ-premise.

אפשר להשתמש באפליקציית לדוגמה בקוד פתוח או לשלוח בקשה buildingInsights כדי לבדוק את הערך של place_id במבנים שנכללים ב-Solar API.

בחירת מיקום במפה

אפשר גם להציע חוויה משלימה על ידי מתן אפשרות למשתמשים לבחור את הבניין במפה באמצעות ממשק ה-API של JavaScript של מפות Google. מחלצים את קו הרוחב וקו האורך של הבניין מאירוע העכבר, ומעבירים את הקואורדינטות האלה בבקשה buildingInsights.