تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تستخدم واجهة برمجة التطبيقات Solar API بيانات الأماكن لتحديد نوع المبنى، وتحدّد المباني استنادًا إلى صور الأقمار الصناعية. توضّح هذه الصفحة كيفية تحديد معلومات الطاقة الشمسية الخاصة بأي مبنى يتم عرضها في طلب buildingInsights.
أنواع المباني
تتيح Solar API استخدام المباني من النوع
premise. يشير هذا النوع إلى موقع جغرافي محدّد الاسم، ويكون عادةً مبنى أو مجموعة من المباني لها اسم مشترك.
لا تتوافق الخدمة مع الأنواع الأخرى، مثل
subpremise أو
المجمّعات، مثل المباني المنفصلة الواقعة في عقار واحد، ما لم يتم تسجيلها كـ premise،
ولا تتوافق معها.
أسقف المباني
تحدّد Solar API أفضل موضع لتركيب ألواح الطاقة الشمسية على الأسطح استنادًا إلى صور الأقمار الصناعية. يتم تحديد المباني السكنية، لا سيما تلك التي تحتوي على أسطح مائلة أو منحدرة، بدقة عالية، بينما قد تختلف دقة تحديد المباني التي تحتوي على أسطح مستوية (مثل المباني السكنية أو التجارية).
إذا لم يتضمّن الردّ على طلب buildingInsights الحقل solarPanelConfigs، يعني ذلك أنّه تمت معالجة المبنى بشكل صحيح، ولكن تعذّر علينا وضع الألواح على السطح. قد يحدث ذلك إذا كان السطح صغيرًا جدًا بحيث لا يمكن وضع الألواح عليه أو إذا كان مظللاً جدًا بحيث لا يمكن للألواح توليد طاقة كبيرة.
استخدِم إحداثيات خط العرض وخط الطول الخاصة بالمكان في طلبك إلى Solar API
buildingInsights.
إذا عثرت Solar API على مبنى مطابق، تأكَّد من أنّ قيمة place_id في الردّ buildingInsights تتطابق مع قيمة place_id من Geocoding API أو Place Autocomplete API.
لحصر النتائج على الأماكن من النوع premise، أضِف فلترًا لنوع المكان إلى الردود من Geocoding API أو Places API.
يمكنك أيضًا تقديم تجربة تكميلية من خلال السماح للمستخدمين باختيار المبنى على الخريطة باستخدام Maps JavaScript API. استخرِج خط العرض وخط الطول للمبنى من حدث
الماوس، ثم مرِّر هاتين الإحداثيتين في طلب buildingInsights.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Solar API uses place data and satellite imagery to identify buildings and determine their solar potential, focusing on buildings classified as "premise" in Google Places.\u003c/p\u003e\n"],["\u003cp\u003eThe API primarily supports residential buildings with inclined roofs for accurate solar panel placement, while accuracy may vary for flat-roofed buildings.\u003c/p\u003e\n"],["\u003cp\u003eIf the \u003ccode\u003esolarPanelConfigs\u003c/code\u003e field is missing from the API response, it indicates the building was analyzed, but solar panel placement was not feasible due to roof size or shading.\u003c/p\u003e\n"],["\u003cp\u003eUsers can identify buildings for solar analysis by converting addresses to coordinates using Geocoding or Place Autocomplete APIs and passing the coordinates to the Solar API.\u003c/p\u003e\n"],["\u003cp\u003eA complementary approach involves users selecting a building directly on a map using the Maps JavaScript API, and using the extracted coordinates for solar analysis.\u003c/p\u003e\n"]]],["The Solar API utilizes place data and satellite imagery to identify buildings and determine solar potential. It primarily supports `premise` type buildings, excluding `subpremise` types. Optimal solar panel placement is assessed, with higher accuracy for residential pitched roofs; flat roofs may vary. The API can be used by converting an address to coordinates via the Geocoding or Place Autocomplete APIs, or by using a location selected on a map. The results can be filtered to places of type premise, and the results from the building insights api can be compared to the results from the geocoding or places API.\n"],null,[]]
