الأسئلة الشائعة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المطوّرون في المنطقة الاقتصادية الأوروبية
مساعدة
كيف يمكنني نقل البيانات إلى Solar API الجديد من الإصدار السابق؟
أين يمكنني الحصول على المساعدة؟
ماذا تعني رموز الخطأ هذه؟
إعدادات المشروع
ما هي الأذونات التي أحتاج إليها في مشروعي على Google Cloud؟
هل يمكنني استخدام مفتاح واجهة برمجة التطبيقات مع أكثر من مشروع واحد على Cloud؟
- لا، استخدِم مفتاح واجهة برمجة التطبيقات لمشروع واحد فقط على Cloud. إذا كان لديك المزيد من مشاريع Cloud، يجب أن يكون لكل مشروع مفتاح واجهة برمجة تطبيقات خاص به. يُرجى العِلم أنّه من الطبيعي أن يكون لديك عدة مفاتيح لواجهة برمجة التطبيقات ضمن مشروع واحد.
التكلفة
كيف يمكنني الحدّ من التكاليف؟
النموذج الشمسي
ما هو معدّل تكرار تعديل البيانات؟
- تتم إضافة بيانات جديدة باستمرار، ولكن ليس لدينا معدّل إعادة تحميل محدّد لمناطق معيّنة. تستخدِم بعض المناطق صورًا يعود تاريخها إلى عدة سنوات.
يُرجى التحقّق من تواريخ الصور ذات الصلة، ويمكنك إرسال ملاحظاتك.
أين يمكنني الاطّلاع على مزيد من المعلومات عن الافتراضات المتعلّقة بالتحليل المالي للطاقة الشمسية؟
- تستخدم Google معلومات حول الحوافز الحكومية المتعلقة بالطاقة الشمسية، بالإضافة إلى البيانات والنماذج المالية الأخرى، من شركة Clean Power Research.
هل تأخذ واجهة برمجة التطبيقات في الاعتبار المداخن وفتحات السقف عند تقييم موضع الألواح الشمسية؟
- نعم، باستخدام خرائط الارتفاع، يتم تحديد المداخن وفتحات السقف على شكل مستطيلات صغيرة، ويستبعد النموذج ألواح الطاقة الشمسية.
هل يمكن لواجهة برمجة التطبيقات رؤية ما بداخل المباني؟
هل يمكن لواجهة برمجة التطبيقات إجراء تقييمات لشقة معيّنة داخل مجمع مبانٍ؟
- يعتمد ذلك على الحالة. يستخدم النموذج بيانات "خرائط Google"، وبالتالي إذا تم تصنيف الشقة كمبنى كامل في "خرائط Google"، سيتم عرض سطح شقة معيّنة في ذلك المبنى بشكل منفصل.
لماذا لا تعرض واجهة برمجة التطبيقات أحيانًا أي بيانات لمبنى أعرف أنّه موجود؟
- يمكن أن يحدث ذلك عندما تكون هناك مبانٍ جديدة لم تكن موجودة عند إجراء عملية الربط بالخرائط في ذلك الوقت.
كيف يمكنني استخدام طبقة بيانات الطاقة الشمسية المتغيرة لتصوّر الظل؟
- تتلقّى الأسقف المواجهة للشمال كمية أقل من التدفق (الإشعاع الشمسي)، ما يعني أنّها ستكون أكثر ظلًا. يمكنك الاستفادة من هذه المعلومات عند إجراء تقييمات للطاقة الشمسية. تتيح لك طبقة بيانات التدفق عرض التدفق بألوان.
- يمكنك بدلاً من ذلك إنشاء مربّعات تدفّق خاصة بك وتخصيص ألوانها، خاصةً إذا كنت تريد تحديد قيم رقمية معيّنة للظل على سطح.
كيف يمكنني استخدام hourlyShadeUrls من خدمة dataLayers؟
- يمكنك استعادة لقطة يومية للظل على مدار العام، وإنشاء صورة GIF متحركة أو فيديو للظل المتغيّر خلال عام.
- نعم، يمكنك استخدام طبقتَي بيانات الطاقة الشمسية، وهما "الفيض" و"نموذج السطح الرقمي" (خريطة الارتفاع عند كل نقطة)، لتخصيص أكبر.
لماذا تعرض واجهة برمجة التطبيقات عنوان URL، وماذا يمكنني أن أفعل به؟
- عناوين URL هي مؤشرات قصيرة الأمد تتيح لك تنزيل طبقات البيانات ذات الصلة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Solar API provides tools and data for solar potential assessment, including financial analysis and shade visualization.\u003c/p\u003e\n"],["\u003cp\u003eUsers can access support resources and migration guides for transitioning from previous API versions.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Maps data is used for building identification and solar panel placement, with limitations for newer buildings and interior assessments.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers data layers like flux and DSM for visualizing shade and performing custom calculations, accessed via short-lived URLs.\u003c/p\u003e\n"],["\u003cp\u003eCost management strategies are available through Google Cloud's budgeting documentation.\u003c/p\u003e\n"]]],["To migrate, consult the migration guide. For help, see support options. Error codes are detailed in HTTP status code documentation. Each Cloud project requires its own API key. Limit costs with budgeting documentation. Data refresh rates vary by region; provide feedback on old imagery. Solar financial analysis uses Clean Power Research data. The API considers chimneys/skylights and assesses only roofs, not building interiors. Shade is visualized via flux data; use `hourlyShadeUrls` for shade animation. Customize with flux and DSM solar data layers. URLs provide temporary access to download data layers.\n"],null,["# Frequently Asked Questions\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google\n| Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. [Learn more](/maps/comms/eea/faq). In addition, certain content from the Solar API will no longer be returned. [Learn more](/maps/comms/eea/solar).\n\nHelp\n----\n\n### How do I migrate to the new Solar API from the previous version?\n\n- Review our [migration guide](/maps/documentation/solar/migration).\n\n### Where can I get help?\n\n- Check out [Support Options for Solar API](/maps/documentation/solar/support).\n\n### What do these error codes mean?\n\n- Read more about [HTTP status codes](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status).\n\nProject configuration\n---------------------\n\n### What permissions do I need on my Cloud project?\n\n- See [the documentation](https://developers.google.com/maps/roles).\n\n### Can I use my API key with more than one Cloud project?\n\n- No, only use your API key for one Cloud project. If you have more Cloud projects, each should have their own API key. Note that, within a single project, it's normal to have several API keys.\n\nCost\n----\n\n### How do I limit costs?\n\n- See the [Budgeting\n documentation](https://cloud.google.com/billing/docs/how-to/budgets) for strategies and tips.\n\nSolar model\n-----------\n\n### How often are data refreshed?\n\n- New data are added all the time, but we don't have a specific refresh rate for specific regions. Some regions use imagery that is several years old. Please check the dates of the relevant imagery, and feel free to [file\n feedback](https://issuetracker.google.com/issues/new?component=1356349&template=1817492).\n\n### Where can I learn more about the assumptions for the solar financial analysis?\n\n- Google uses information about government solar incentives, along with other financial data and models, from [Clean Power\n Research](https://www.cleanpower.com/).\n\n### Are chimneys and skylights taken into consideration by the API when making an assessment of solar panel placement?\n\n- Yes, with height maps chimneys and skylights are identified as small rectangles, and solar panels are excluded by the model.\n\n### Can the API see inside of buildings?\n\n- No, just the roofs.\n\n### Can the API make assessments for a specific apartment within a building complex?\n\n- Depends. The model uses Google Maps data, and so if the apartment is classified as a whole building in Google Maps, then the roof of a specific apartment of that building are displayed as separate.\n\n### Why does the API sometimes not return any data for a building which I know exists?\n\n- This can happen when there are newer buildings that did not exist when mapping was realized at the time.\n\n### How can I use the flux solar data layer for visualizing shade?\n\n- North-facing roofs get less flux ([solar\n irradiance](https://en.wikipedia.org/wiki/Solar_irradiance)), which means they will have higher shade. You can leverage this information when performing solar assessments. The flux data layer lets you visualize flux in colors.\n- You can alternatively make your own flux tiles and customize their colors, especially if you wish to locate specific numerical values of shade on a roof.\n\n### How can I use `hourlyShadeUrls` from the [dataLayers service](/maps/documentation/solar/reference/rest/v1/dataLayers)?\n\n- You can get back a daily snapshot of shade throughout the year, and produce an animated GIF or video of shade changing during a year.\n\n### Can I perform my own custom calculations?\n\n- Yes, can use the flux and DSM (height map at each point) solar data layers for greater customization.\n\n### Why does the API return a URL, and what can I do with them?\n\n- The URLs are short-lived pointers to enable you to download the corresponding data layers."]]
