Solar API משתמש בנתוני מיקום כדי לקבוע את סוג הבניין ומזהה מבנים על סמך צילומי לוויין. בדף הזה מוסבר איך לקבוע איזה מידע על אנרגיה סולארית של בניין יוחזר בבקשה buildingInsights
.
סוגי מבנים
Solar API תומך במבנים מסוג
premise
הסוג הזה
מציין מיקום בעל שם, בדרך כלל מבנה או אוסף של בניינים עם
שם פרטי.
סוגים אחרים, כמו
subpremise
או
מתחמים. לדוגמה, מבנים נפרדים הממוקמים על נכס יחיד, אלא אם
רשום בתור premise
–
לא נתמכים.
גגות של מבנים
Solar API מזהה את המיקום האופטימלי של לוחות סולאריים על הגגות על סמך צילומי לוויין. מבני מגורים, במיוחד עם גגות משופע או תלול, מזוהים ברמת דיוק גבוהה, אבל רמת הדיוק של זיהוי מבנים עם גגות שטוחים (למשל, בנייני דירות או בניינים מסחריים) עשויה להשתנות.
חיפוש מכתובת
ניתן להמיר כתובת לקואורדינטות של קו אורך וקו רוחב באמצעות Geocoding API או Place השלמה אוטומטית API.
אפשר להשתמש בסמל
place_id
כדי להתייחס למקום התואם.שימוש בקואורדינטות של קו הרוחב וקו האורך של המקום ב-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 },... }
- אם Solar API מוצא בניין תואם, צריך לבדוק שהערך של
אפשר להשתמש באפליקציית לדוגמה בקוד פתוח או לשלוח בקשה buildingInsights
כדי לבדוק את הערך של place_id
במבנים שנכללים ב-Solar API.
בחירת מיקום במפה
ניתן גם להציע חוויה משלימה כשמאפשרים למשתמשים לבחור
מבוסס על המפה באמצעות JavaScript של מפות Google
API. מחלצים את קו הרוחב וקו האורך של הבניין מאירוע העכבר, ומעבירים את הקואורדינטות האלה בבקשה buildingInsights
.