חיפוש מבנים

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

סוגי מבנים

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

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

גגות של מבנים

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

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

חיפוש מכתובת

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

   אפשר להשתמש בסמל place_id כדי להתייחס למקום התואם.

2. שימוש בקואורדינטות של קו הרוחב וקו האורך של המקום ב-Solear 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) שנמצאו בחיפוש לא יתקבלו באותה כתובת או באותו בניין. גם אם הקידוד הגיאוגרפי תגובת ה-API היא ברמת פירוט ROOFTOP, יכול להיות שהסוג של place_id הוא לא premise.

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

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

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