חיפוש מבנים

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

סוגי מבנים

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

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

גגות של מבנים

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

טיפ: על סמך גישות אחרות לבחירה, כולל בחירת משתמש ידנית או בחירת פרוגרמטית בהתאמה אישית, אפשר להשתמש בנקודת הקצה של 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.