ساختمان ها را جستجو کنید

Solar API از داده های مکان برای تعیین نوع ساختمان استفاده می کند و ساختمان ها را بر اساس تصاویر ماهواره ای شناسایی می کند. این صفحه نحوه تعیین اطلاعات خورشیدی ساختمان را در یک درخواست buildingInsights توضیح می‌دهد.

انواع ساختمان

Solar API از ساختمان هایی از نوع premise پشتیبانی می کند. این نوع یک مکان نامگذاری شده را نشان می دهد، معمولاً یک ساختمان یا مجموعه ای از ساختمان ها با یک نام مشترک.

انواع دیگر، مانند subpremise یا ترکیبات - برای مثال، ساختمان‌های مجزا که در یک ملک واحد واقع شده‌اند، مگر اینکه به عنوان یک premise ثبت شده باشند - پشتیبانی نمی‌شوند .

سقف ساختمان

Solar API مکان بهینه پنل خورشیدی روی پشت بام را بر اساس تصاویر ماهواره ای شناسایی می کند. ساختمان های مسکونی، به ویژه سقف های شیب دار یا شیب دار، با درجه بالایی از دقت شناسایی می شوند، در حالی که ساختمان های با سقف های مسطح (به عنوان مثال، ساختمان های آپارتمانی یا تجاری) ممکن است از نظر دقت متفاوت باشند.

اگر پاسخ buildingInsights شامل قسمت solarPanelConfigs نباشد، ساختمان به درستی پردازش شده است، اما ما نمی‌توانیم پانل‌ها را روی سقف قرار دهیم. این ممکن است در صورتی اتفاق بیفتد که سقف برای قرار دادن پانل ها خیلی کوچک باشد یا بیش از حد سایه باشد تا پانل ها انرژی قابل توجهی تولید کنند.

نکته: بر اساس سایر رویکردهای انتخاب، از جمله انتخاب دستی کاربر یا انتخاب برنامه‌ای سفارشی، می‌توانید از نقطه پایانی Solar API dataLayers برای ایجاد محاسبات پتانسیل خورشیدی و قرار دادن پانل خود استفاده کنید.

جستجو از یک آدرس

1. می‌توانید با استفاده از Geocoding API یا Place Autocomplete API یک آدرس را به مختصات طول و عرض جغرافیایی تبدیل کنید.

   از place_id برای اشاره به مکان منطبق استفاده کنید.

2. از مختصات طول و عرض جغرافیایی مکان در درخواست buildingInsights API خورشیدی خود استفاده کنید.

   • اگر 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 Geocoding دارای جزئیات ROOFTOP باشد، place_id ممکن است نوع دیگری غیر از premise داشته باشد.

می‌توانید از برنامه نمونه منبع باز استفاده کنید یا یک درخواست buildingInsights برای بررسی place_id برای ساختمان‌های تحت پوشش Solar API ارائه دهید.

انتخاب مکان روی نقشه

همچنین می‌توانید با فعال کردن کاربران برای انتخاب ساختمان روی نقشه با استفاده از Maps JavaScript API یک تجربه تکمیلی ارائه دهید. طول و عرض جغرافیایی ساختمان را از رویداد ماوس استخراج کنید، سپس آن مختصات را در یک درخواست buildingInsights ارسال کنید.