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

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

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

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

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

أسقف المباني

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

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

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

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

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

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

2. استخدِم إحداثيات خط العرض وخط الطول الخاصة بالمكان في طلبك إلى Solar API buildingInsights.

   • إذا عثرت Solar API على مبنى مطابق، تأكَّد من أنّ قيمة place_id في الردّ buildingInsights تتطابق مع قيمة place_id من Geocoding API أو الإكمال التلقائي للأماكن 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.

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

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