البحث عن المباني

تستخدِم واجهة برمجة التطبيقات Solar API بيانات الأماكن لتحديد نوع المبنى، كما تحدِّد المباني استنادًا إلى صور الأقمار الصناعية. توضّح هذه الصفحة كيفية تحديد معلومات الطاقة الشمسية للمبنى التي يتم عرضها في طلب buildingInsights.

أنواع المباني

تتيح Solar API استخدام المباني من النوع premise. يشير هذا النوع إلى موقع جغرافي يحمل اسمًا، وعادةً ما يكون مبنى أو مجموعة من المباني التي تحمل اسمًا شائعًا.

لا يمكن استخدام الأنواع الأخرى، مثل subpremise أو المجمعات، مثل المباني المنفصلة الواقعة على قطعة أرض واحدة، ما لم يتم تسجيلها على أنّها premise.

أسطح المباني

تحدد واجهة برمجة التطبيقات Solar API الموقع الأمثل لتثبيت الألواح الشمسية على السطح استنادًا إلى الصور التي يتم التقاطها من الأقمار الصناعية. يتم تحديد المباني السكنية، خاصةً المباني التي تتضمّن سطوحًا مائلّة، بدرجة عالية من الدقة، في حين قد تتفاوت دقة تحديد المباني التي تتضمّن سطوحًا مسطّحة (مثل المباني السكنية أو التجارية).

إذا كان ردّ buildingInsights لا يتضمّن الحقل solarPanelConfigs، يعني ذلك أنّه تمّت معالجة المبنى بشكل صحيح، ولكن تعذّر علينا وضع الألواح على السقف. قد يحدث ذلك إذا كان السقف صغيرًا جدًا لوضع الألواح أو مظللًا جدًا لكي تتمكن الألواح من توليد طاقة كبيرة.

ملاحظة: استنادًا إلى طرق اختيار أخرى، بما في ذلك اختيار المستخدم اليدوي أو اختيار آلي مخصّص، يمكنك استخدام نقطة نهاية واجهة برمجة التطبيقات Solar API dataLayers لإنشاء عمليات احتساب محتملة للطاقة الشمسية وتحديد موضع الألواح.

البحث من عنوان

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

ملاحظة: في بعض الأحيان، لن تتطابق أرقام تعريف الأماكن، ما يعني أنّ الإحداثيات التي تم البحث عنها (lat، lng) لا تؤدي إلى العنوان أو المبنى نفسه. حتى إذا كان استجابة Geocoding API ذات دقة ROOFTOP، قد يكون place_id من نوع آخر غير premise.

يمكنك استخدام تطبيق نموذج مفتوح المصدر أو تقديم طلب buildingInsights للاطّلاع على place_id للمباني التي توفّر واجهة برمجة التطبيقات Solar API معلومات عنها.

اختيار موقع جغرافي على الخريطة

يمكنك أيضًا تقديم تجربة تكميلية من خلال السماح للمستخدمين باختيار المبنى على الخريطة باستخدام واجهة برمجة التطبيقات برمجة JavaScript لتطبيق "خرائط Google". استخرِج خط العرض وخط الطول للمبنى من حدث الماوس، ثم أدخِل هذه الإحداثيات في طلب buildingInsights.