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

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

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

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

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

بناء الأسطح

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

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

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

1. يمكنك تحويل عنوان إلى إحداثيات خطوط الطول والعرض باستخدام Geocoding API أو Place Autocomplete API.

   استخدِم place_id للإشارة إلى المكان المطابق.

2. يمكنك استخدام إحداثيات خط العرض وخط الطول للمكان في طلب buildingInsights الخاص بواجهة برمجة التطبيقات Solar 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
     },...
     }
     

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

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

تحديد موقع على الخريطة

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