חיפוש מבנים

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

סוגי מבנים

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

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

גגות למבנים

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

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

חיפוש מכתובת

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

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

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

   • אם Solar API מוצא מבנה תואם, מוודאים שה-place_id בתשובה buildingInsights תואם ל-place_id מ-Geocoding API או מ-Place השלמה אוטומטית 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 כדי לבדוק את המבנים שמכוסה על ידי Solar API ב-place_id.

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

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