חיפוש מבנים

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

סוגי מבנים

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

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

גגות של מבנים

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

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

חיפוש מכתובת

  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
      },...
      }

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

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

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

מפה אינטראקטיבית לציון המיקום.