Package google.maps.solar.v1

الفهرس

الطاقة الشمسية

تعريف الخدمة لواجهة برمجة التطبيقات Solar API

FindClosestBuildingInsights

rpc FindClosestBuildingInsights(FindClosestBuildingInsightsRequest) returns (BuildingInsights)

لتحديد موقع المبنى الذي تكون نقطته المركزية الأقرب إلى نقطة طلب البحث تعرِض رسالة خطأ بالرمز NOT_FOUND إذا لم تكن هناك مبانٍ ضمن نطاق 50 مترًا تقريبًا من نقطة الطلب.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform
GetDataLayers

rpc GetDataLayers(GetDataLayersRequest) returns (DataLayers)

الحصول على معلومات عن الأشعة الشمسية لمنطقة تحيط بموقع جغرافي تعرِض رسالة خطأ بالرمز NOT_FOUND إذا كان الموقع الجغرافي خارج منطقة التغطية.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform
GetGeoTiff

rpc GetGeoTiff(GetGeoTiffRequest) returns (HttpBody)

عرض صورة حسب رقم تعريفها

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform

BuildingInsights

رسالة الردّ بشأن Solar.FindClosestBuildingInsights معلومات عن الموقع الجغرافي للمبنى وأبعاده وإمكانات توليد الطاقة الشمسية على سطحه

الحقول
name

string

اسم المرجع للمبنى بالتنسيق buildings/{place_id}
center

LatLng

نقطة قريبة من وسط المبنى
bounding_box

LatLngBox

مربّع حدود المبنى
imagery_date

Date

تاريخ الحصول على الصور الأساسية هذه الأرقام تقريبية.
imagery_processed_date

Date

وقت اكتمال معالجة هذه الصور
postal_code

string

الرمز البريدي (مثل الرمز البريدي الأمريكي) الذي يقع ضمنه هذا المبنى
administrative_area

string

المنطقة الإدارية 1 (مثل الولاية في الولايات المتحدة) التي تحتوي على هذا المبنى على سبيل المثال، في الولايات المتحدة، قد يكون الاختصار "MA" أو "CA".
statistical_area

string

المنطقة الإحصائية (مثل منطقة التعداد السكاني في الولايات المتحدة) التي يقع فيها هذا المبنى.
region_code

string

رمز المنطقة للبلد (أو المنطقة) الذي يقع فيه هذا المبنى.
solar_potential

SolarPotential

إمكانية توليد الطاقة الشمسية في المبنى
imagery_quality

ImageryQuality

جودة الصور المستخدَمة لاحتساب بيانات هذا المبنى

CashPurchaseSavings

تكلفة وفائدة الشراء الفوري لإعدادات معيّنة من الألواح الشمسية مع استخدام كهرباء معيّن

الحقول
out_of_pocket_cost

Money

التكلفة الأولية قبل الحوافز الضريبية: المبلغ الذي يجب دفعه من جيبك يختلف ذلك عن upfront_cost، وهو الربح بعد الحوافز الضريبية.
upfront_cost

Money

التكلفة الأولية بعد الحوافز الضريبية: هو المبلغ الذي يجب دفعه خلال السنة الأولى. يُرجى الاطّلاع على out_of_pocket_cost، وهي قبل الحوافز الضريبية.
rebate_value

Money

قيمة جميع الخصومات الضريبية
savings

SavingsOverTime

المبلغ الذي تم توفيره (أو عدم توفيره) خلال فترة الاستخدام
payback_years

float

عدد السنوات إلى أن يتم استرداد الأموال تعني القيمة السالبة عدم حدوث فترة استرداد الأموال مطلقًا خلال فترة الاستخدام.

DataLayerView

المجموعة الفرعية من معلومات الطاقة الشمسية المطلوب عرضها

عمليات التعداد
DATA_LAYER_VIEW_UNSPECIFIED يعادل FULL.
DSM_LAYER الحصول على DSM فقط
IMAGERY_LAYERS الحصول على DSM وRGB والقناع
IMAGERY_AND_ANNUAL_FLUX_LAYERS يمكنك الحصول على بيانات DSM وRGB والقناع والمعدل السنوي للتغير.
IMAGERY_AND_ALL_FLUX_LAYERS يمكنك الحصول على بيانات DSM وRGB والقناع والكثافة السنوية والكثافة الشهرية.
FULL_LAYERS الحصول على كل البيانات

DataLayers

معلومات عن إمكانات توليد الطاقة الشمسية في منطقة معيّنة تتضمّن البيانات الفعلية عددًا من ملفات GeoTIFF التي تغطي المنطقة المطلوبة، والتي تحتوي هذه الرسالة على عناوين URL لها: تحتوي كل سلسلة في رسالة DataLayers على عنوان URL يمكن من خلاله جلب ملف GeoTIFF المقابل. تكون عناوين URL هذه صالحة لبضع ساعات بعد إنشائها. تكون معظم ملفات GeoTIFF بدرجة دقة 0.1 متر لكل بكسل، ولكن تكون درجة دقة ملف التدفق الشهري 0.5 متر لكل بكسل، وتكون درجة دقة ملفات التظليل كل ساعة 1 متر لكل بكسل. إذا تم تحديد قيمة pixel_size_meters في GetDataLayersRequest، سيكون الحد الأدنى للدقة في ملفات GeoTIFF هو تلك القيمة.

الحقول
imagery_date

Date

وقت التقاط صور المصدر (التي يتم اشتقاق جميع البيانات الأخرى منها) في هذه المنطقة إنّ هذه القيمة تقريبية إلى حدّ ما، لأنّه قد تم التقاط الصور على مدار أكثر من يوم واحد.
imagery_processed_date

Date

وقت اكتمال معالجة هذه الصور
dsm_url

string

عنوان URL لصورة نموذج سطح رقمي (DSM) للمنطقة يتم التعبير عن القيم بالأمتار فوق سطح الجيويد EGM96 (أي مستوى سطح البحر). يتم تخزين المواقع الجغرافية غير الصالحة (التي لا تتوفّر لدينا بيانات عنها) على أنّها -9999.
rgb_url

string

عنوان URL لصورة بيانات RGB (صورة جوية) للمنطقة
mask_url

string

عنوان URL لصورة قناع المبنى: بت واحد لكل بكسل يشير إلى ما إذا كان هذا البكسل يُعدّ جزءًا من سطح أم لا.
annual_flux_url

string

عنوان URL لخريطة التدفق السنوي (ضوء الشمس السنوي على الأسطح) للمنطقة. يتم التعبير عن القيم بالكيلوواط ساعة لكل كيلوواط في السنة. وهذا هو التدفّق غير المقنَّع: يتم احتساب التدفّق لكل موقع جغرافي، وليس فقط أسطح المباني. يتم تخزين المواقع الجغرافية غير الصالحة على أنّها -9999: ستكون المواقع الجغرافية خارج نطاق التغطية غير صالحة، وستكون أيضًا بعض المواقع الجغرافية داخل نطاق التغطية غير صالحة إذا تعذّر علينا احتساب معدّل التدفق.
monthly_flux_url

string

عنوان URL لخريطة التدفق الشهري (ضوء الشمس على الأسطح، مقسّمًا حسب الشهر) للمنطقة. يتم التعبير عن القيم بالكيلوواط ساعة/كيلوواط في السنة. سيحتوي ملف GeoTIFF الذي يشير إليه عنوان URL هذا على اثني عشر نطاقًا، تتوافق مع الأشهر من كانون الثاني (يناير) إلى كانون الأول (ديسمبر) بالترتيب.
hourly_shade_urls[]

string

اثنا عشر عنوان URL للظل كل ساعة، تتوافق مع كانون الثاني (يناير) إلى كانون الأول (ديسمبر)، بالترتيب. سيحتوي كل ملف GeoTIFF على 24 نطاقًا، بما يتوافق مع الساعات الـ 24 في اليوم. كل بكسل هو عدد صحيح 32 بت، يتوافق مع 31 يومًا (أو أقل) من ذلك الشهر، ويعني 1 بت أنّ الموقع الجغرافي المقابل يمكنه رؤية الشمس في ذلك اليوم، وفي تلك الساعة، من ذلك الشهر. يتم تخزين المواقع الجغرافية غير الصالحة على النحو التالي: -9999 (بما أنّ هذه القيمة سالبة، تم ضبط الرقّم الثنائي 31، ولا يمكن ضبط الرقّم الثنائي 31 على أي قيمة صالحة لأنّ ذلك سيتوافق مع اليوم 32 من الشهر).

قد يكون من المفيد تقديم مثال. إذا أردت معرفة ما إذا كانت نقطة (في موضع البكسل (x, y)) قد تعرّضت للشمس في الساعة 4 مساءً في 22 حزيران (يونيو)، عليك إجراء ما يلي:

  1. استرجاع عنوان URL السادس في هذه القائمة (المرتبط بشهر حزيران/يونيو)
  2. ابحث عن القناة 17 (التي تُعرض فيها البرامج في الساعة 4 مساءً).
  3. قراءة القيمة 32 بت في (x, y)
  4. قراءة الرقّم الثنائي 21 من القيمة (الموافق لليوم 22 من الشهر)
  5. إذا كان هذا القسم هو 1، يعني ذلك أنّ الشمس ظهرت في تلك البقعة في الساعة 4 مساءً في 22 حزيران (يونيو).

بشكل أكثر رسمية: استنادًا إلى month (من 1 إلى 12)، وday (من 1 إلى 31 شهرًا بحد أقصى، وشهر شباط/فبراير يتضمّن 28 يومًا)، وhour (من 0 إلى 23)، فإنّ الظل/الشمس لذلك الشهر/اليوم/الساعة في موضع (x, y) هو القيمة

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

حيث يشير (x, y) إلى الفهرسة المكانية، ويشير [month - 1] إلى جلب عنوان URL month - 1 (الفهرسة من الصفر)، ويشير [hour] إلى الفهرسة في القنوات، وتعني النتيجة النهائية غير الصفرية "مشمس". لا تتوفّر أيام كبيس ولا توقيت صيفي (تبلغ مدة كل الأيام 24 ساعة، ويكون منتصف النهار دائمًا "التوقيت الرسمي").
imagery_quality

ImageryQuality

جودة الصور الناتجة

FinancedPurchaseSavings

تكلفة وفائدة استخدام قرض لشراء مجموعة معيّنة من الألواح الشمسية مع استخدام كهرباء معيّن

الحقول
annual_loan_payment

Money

دفعات القروض السنوية
rebate_value

Money

قيمة جميع الخصومات الضريبية (بما في ذلك "الخصم الضريبي الفيدرالي على الاستثمار")
loan_interest_rate

float

معدّل الفائدة على القروض المُفترض في هذه المجموعة من العمليات الحسابية
savings

SavingsOverTime

المبلغ الذي تم توفيره (أو عدم توفيره) خلال فترة الاستخدام

FinancialAnalysis

تحليل تكلفة وفوائد التصميم الأمثل للطاقة الشمسية لحجم فاتورة كهرباء معيّن

الحقول
monthly_bill

Money

فاتورة الكهرباء الشهرية التي يفترضها هذا التحليل.
default_bill

bool

ما إذا كان هذا هو حجم الفاتورة المحدّد ليكون الفاتورة التلقائية للمنطقة التي يقع فيها هذا المبنى. يجب ضبط default_bill على FinancialAnalysis واحد بالضبط في BuildingSolarPotential.
average_kwh_per_month

float

مقدار الكهرباء التي يستهلكها المنزل في المتوسط شهريًا، استنادًا إلى حجم الفاتورة ومعدّلات الكهرباء المحلية
financial_details

FinancialDetails

المعلومات المالية التي تنطبق بغض النظر عن طريقة التمويل المستخدَمة
leasing_savings

LeasingSavings

تكلفة استئجار الألواح الشمسية ومزاياها
cash_purchase_savings

CashPurchaseSavings

تكلفة شراء الألواح الشمسية نقدًا ومزاياها
financed_purchase_savings

FinancedPurchaseSavings

تكلفة شراء الألواح الشمسية ومزاياها من خلال تمويل عملية الشراء
panel_config_index

int32

فهرس في solar_panel_configs لتصميم الطاقة الشمسية الأمثل لحجم الفاتورة هذا ويمكن أن يكون هذا الرقم -1، ما يشير إلى عدم توفّر تنسيق. في هذه الحالة، سيتم حذف الرسائل الفرعية المتبقية.

FinancialDetails

تفاصيل تحليل مالي يتم تخزين بعض هذه التفاصيل حاليًا في مستويات أعلى (مثل التكلفة المدفوعة من المحفظة). يتم احتساب إجمالي المبالغ المالية على مدار فترة زمنية محدّدة من خلال حقل panel_lifetime_years في SolarPotential. ملاحظة: يتم إدخال التكلفة المدفوعة من المحفظة لشراء اللوحات في حقل out_of_pocket_cost ضمن CashPurchaseSavings.

الحقول
initial_ac_kwh_per_year

float

عدد كيلوواط ساعة من التيار المتردد الذي نعتقد أنّ الألواح الشمسية ستولده في السنة الأولى
remaining_lifetime_utility_bill

Money

فاتورة الخدمات الكهربائية غير المُنتَجة من الألواح الشمسية طوال مدة استخدامها
federal_incentive

Money

المبلغ المالي المتاح من الحوافز الفيدرالية، وينطبق ذلك إذا كان المستخدم يشتري الألواح (باستخدام قرض أو بدونه).
state_incentive

Money

المبلغ المالي المتاح من الحوافز الحكومية، وينطبق ذلك إذا كان المستخدم يشتري الألواح (باستخدام قرض أو بدونه).
utility_incentive

Money

المبلغ المالي المتاح من حوافز الخدمات العامة، وينطبق ذلك إذا كان المستخدم يشتري الألواح (باستخدام قرض أو بدونه).
lifetime_srec_total

Money

المبلغ المالي الذي سيحصل عليه المستخدم من "أرصدة الطاقة المتجدّدة من الطاقة الشمسية" على مدار عمر الألواح، وينطبق ذلك إذا كان المستخدم يشتري الألواح (باستخدام قرض أو بدونه).
cost_of_electricity_without_solar

Money

إجمالي تكلفة الكهرباء التي كان سيدفعها المستخدم على مدار فترة الاستخدام إذا لم يتم تركيب أنظمة الطاقة الشمسية.
net_metering_allowed

bool

ما إذا كان يُسمح بقياس صافي الطاقة
solar_percentage

float

النسبة المئوية (من 0 إلى 100) للطاقة المستخدَمة من الطاقة الشمسية تكون صالحة للسنة الأولى، ولكنها تكون صحيحة تقريبًا للسنوات المستقبلية.
percentage_exported_to_grid

float

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

FindClosestBuildingInsightsRequest

طلب رسالة لـ Solar.FindClosestBuildingInsights

الحقول
location

LatLng

مطلوب. خط الطول وخط العرض اللذان تبحث من خلالهما واجهة برمجة التطبيقات عن أقرب مبنى معروف
required_quality

ImageryQuality

اختياريّ. الحد الأدنى لمستوى الجودة المسموح به في النتائج ولن يتم عرض أي نتيجة بجودة أقل من هذه القيمة. ويؤدي عدم تحديد هذا الخيار إلى حصر المحتوى بالجودة العالية فقط.

GetDataLayersRequest

طلب رسالة لـ Solar.GetDataLayers

الحقول
location

LatLng

مطلوب. خطا الطول والعرض لمركز المنطقة التي تريد الحصول على بيانات عنها
radius_meters

float

مطلوب. نصف القطر، بالكيلومترات، الذي يحدّد المنطقة المحيطة بنقطة المركز التي يجب عرض البيانات لها. في ما يلي القيود المفروضة على هذه القيمة:

  • يمكن تحديد أي قيمة تصل إلى 100 متر في أي وقت.
  • يمكن تحديد قيم تزيد عن 100 متر، شرط أن تكون radius_meters <= pixel_size_meters * 1000.
  • ومع ذلك، بالنسبة إلى القيم التي تزيد عن 175 مترًا، يجب ألا يتضمّن DataLayerView في الطلب تدفقًا شهريًا أو تظليلًا كل ساعة.
view

DataLayerView

اختياريّ. المجموعة الفرعية المطلوبة من البيانات المطلوب عرضها.
required_quality

ImageryQuality

اختياريّ. الحد الأدنى لمستوى الجودة المسموح به في النتائج ولن يتم عرض أي نتيجة بجودة أقل من هذه القيمة. ويؤدي عدم تحديد هذا الخيار إلى حصر المحتوى بالجودة العالية فقط.
pixel_size_meters

float

اختياريّ. الحد الأدنى للمقياس، بالمتر لكل بكسل، للبيانات المطلوب عرضها. يمكن استخدام القيم 0.1 (القيمة التلقائية في حال عدم ضبط هذا الحقل بشكل صريح) و0.25 و0.5 و1.0. سيتم عرض مكوّنات الصور التي تكون دقتها العادية أقل من pixel_size_meters بالدقة المحدّدة في pixel_size_meters، وسيتم عرض مكوّنات الصور التي تكون دقتها العادية مساوية أو أكبر من pixel_size_meters بالدقة العادية هذه.
exact_quality_required

bool

اختياريّ. ما إذا كنت تريد أن تكون جودة الصور دقيقة في حال ضبط القيمة على false، يتم تفسير الحقل required_quality على أنّه الحد الأدنى للجودة المطلوبة، ما يتيح عرض صور ذات جودة عالية عند ضبط required_quality على MEDIUM. في حال ضبطها على "صحيح"، يتم تفسير required_quality على أنّها الجودة المطلوبة بالضبط، ولا يتم عرض صور بجودة أقل من MEDIUM إلا إذا تم ضبط required_quality على MEDIUM.

GetGeoTiffRequest

طلب رسالة لـ Solar.GetGeoTiff

الحقول
id

string

مطلوب. معرّف مادة العرض المطلوبة.

ImageryQuality

جودة الصور المستخدَمة لاحتساب بعض نتائج واجهة برمجة التطبيقات

ملاحظة: بغض النظر عن مستوى جودة الصور، تكون دقة نتائج DSM دائمًا 0.1 متر لكل بكسل، وتكون دقة نتائج التدفق الشهري دائمًا 0.5 متر لكل بكسل، وتكون دقة نتائج الظل كل ساعة دائمًا 1 متر لكل بكسل.

عمليات التعداد
IMAGERY_QUALITY_UNSPECIFIED لا تتوفّر معلومات عن الجودة.
HIGH يتم استخراج بيانات الإشعاع الشمسي من الصور الجوية التي يتم التقاطها على ارتفاع منخفض ويتم معالجتها بمعدّل 0.1 متر لكل بكسل.
MEDIUM يتم استخراج بيانات الطاقة الشمسية من صور جوية محسّنة تم التقاطها على ارتفاعات عالية وتم معالجتها بدقة 0.25 متر لكل بكسل.
LOW يتم الحصول على بيانات الطاقة الشمسية من صور الأقمار الصناعية المحسّنة التي تمت معالجتها بدقة 0.25 متر لكل بكسل.
BASE يتم الحصول على بيانات الطاقة الشمسية من صور الأقمار الصناعية المحسّنة التي تمت معالجتها بدقة 0.25 متر لكل بكسل.

LatLngBox

مربّع حدود في إحداثيات خط الطول/خط العرض

الحقول
sw

LatLng

الزاوية الجنوبية الغربية من العلبة
ne

LatLng

الزاوية الشمالية الشرقية من العلبة

LeasingSavings

تكلفة ومزايا استئجار مجموعة معيّنة من الألواح الشمسية مع استخدام كهرباء معيّن

الحقول
leases_allowed

bool

ما إذا كان يُسمح بعقود الإيجار في نطاق السلطة هذا (لا يُسمح بعقود الإيجار في بعض الولايات) إذا كانت قيمة هذا الحقل "false"، من المرجّح أن يتم تجاهل القيم الواردة في هذه الرسالة.
leases_supported

bool

ما إذا كان محرّك الحساب المالي يتيح استخدام عقود الإيجار في هذه المنطقة القضائية إذا كانت قيمة هذا الحقل "false"، من المرجّح أن يتم تجاهل القيم الواردة في هذه الرسالة. لا يرتبط ذلك بـ leases_allowed: في بعض المناطق، يُسمح بعقود الإيجار، ولكن بشروط لا تتعامل معها النماذج المالية.
annual_leasing_cost

Money

التكلفة السنوية المقدَّرة للاستئجار
savings

SavingsOverTime

المبلغ الذي تم توفيره (أو عدم توفيره) خلال فترة الاستخدام

RoofSegmentSizeAndSunshineStats

معلومات عن حجم شريحة السقف ونِسب ساعات سطوع الشمس فيها

الحقول
stats

SizeAndSunshineStats

إجمالي الحجم وشرائح أشعة الشمس لجزء السقف
center

LatLng

نقطة بالقرب من مركز جزء السقف
bounding_box

LatLngBox

مربّع حدود جزء السقف
pitch_degrees

float

زاوية جزء السقف بالنسبة إلى مستوى الأرض النظري 0 = موازٍ للأرض، 90 = عمودي على الأرض
azimuth_degrees

float

اتجاه البوصلة الذي يشير إليه جزء السقف 0 = الشمال، 90 = الشرق، 180 = الجنوب. بالنسبة إلى جزء السقف "المسطّح" (pitch_degrees قريب جدًا من 0)، لا يكون السمت محدّدًا جيدًا، لذا من أجل الاتساق، نحدّده بشكل تعسّفي على أنّه 0 (الاتجاه الشمالي).
plane_height_at_center_meters

float

ارتفاع مستوى سطح القسم من السقف، بالمتر فوق مستوى سطح البحر، في النقطة المحدّدة بالرمز center. بالإضافة إلى الميل والاتجاه والموقع المركزي، يحدّد ذلك بشكل كامل مستوى جزء السقف.

RoofSegmentSummary

معلومات عن جزء من السقف على المبنى، مع وضع بعض الألواح عليه

الحقول
panels_count

int32

إجمالي عدد اللوحات في هذا المقطع
yearly_energy_dc_kwh

float

مقدار طاقة ضوء الشمس التي يجمعها هذا الجزء من التصميم على مدار عام، بالكيلوواط ساعة من التيار المباشر، بافتراض استخدام الألواح الموضّحة أعلاه
pitch_degrees

float

زاوية جزء السقف بالنسبة إلى مستوى الأرض النظري 0 = موازٍ للأرض، 90 = عمودي على الأرض
azimuth_degrees

float

اتجاه البوصلة الذي يشير إليه جزء السقف 0 = الشمال، 90 = الشرق، 180 = الجنوب. بالنسبة إلى جزء السقف "المسطّح" (pitch_degrees قريب جدًا من 0)، لا يكون السمت محدّدًا جيدًا، لذا من أجل الاتساق، نحدّده بشكل تعسّفي على أنّه 0 (الاتجاه الشمالي).
segment_index

int32

الفهرس في roof_segment_stats للعنصر RoofSegmentSizeAndSunshineStats المقابل

SavingsOverTime

المعلومات المالية التي تتم مشاركتها بين طرق التمويل المختلفة

الحقول
savings_year1

Money

التوفير في السنة الأولى بعد تركيب الألواح
savings_year20

Money

التوفير في أوّل عشرين عامًا بعد تركيب الألواح
present_value_of_savings_year20

Money

باستخدام معدّل الخصم المقدَّر، ما هي القيمة الحالية للتوفير التراكمي على مدار 20 عامًا؟
savings_lifetime

Money

التوفير على مدار فترة استخدام اللوحة بالكامل
present_value_of_savings_lifetime

Money

باستخدام معدّل الخصم المقدَّر، ما هي القيمة الحالية للتوفير التراكمي على مدار الحياة؟
financially_viable

bool

يشير ذلك إلى ما إذا كان هذا السيناريو مجديًا من الناحية المالية. سيكون خطأ للسيناريوهات ذات الجدوى المالية السيئة (مثل الخسارة المالية).

SizeAndSunshineStats

مقاييس كمية لحجم سطح المنزل أو جزء منه ومدى تعرضه للشمس

الحقول
area_meters2

float

مساحة السطح أو جزء من السطح، بالمتر المربّع هذه هي مساحة السقف (مع مراعاة الميل)، وليست مساحة السطح.
sunshine_quantiles[]

float

كميات أشعة الشمس في كل نقطة على مستوى المنطقة إذا كانت هناك قيم N هنا، يمثّل ذلك الشرائح (N-1). على سبيل المثال، إذا كانت هناك 5 قيم، ستكون هذه القيم هي الشرائح الربعية (الحد الأدنى، و‎25%، و‎50%، و‎75%، والحد الأقصى). يتم التعبير عن القيم بالكيلوواط ساعة لكل كيلوواط سنويًا، مثل max_sunshine_hours_per_year.
ground_area_meters2

float

مساحة السطح التي يغطيها السقف أو جزء من السقف، بالمتر المربّع

SolarPanel

تصف سمة SolarPanel موضع لوحة شمسية واحدة واتجاهها وإنتاجها. اطّلِع على حقول panel_height_meters وpanel_width_meters وpanel_capacity_watts في SolarPotential للحصول على معلومات عن مَعلمات اللوحة.

الحقول
center

LatLng

وسط اللوحة
orientation

SolarPanelOrientation

اتجاه اللوحة
yearly_energy_dc_kwh

float

مقدار طاقة ضوء الشمس التي يجمعها هذا التصميم على مدار عام، بالكيلوواط ساعة من التيار المباشر
segment_index

int32

الفهرس في roof_segment_stats من RoofSegmentSizeAndSunshineStats الذي يتوافق مع جزء السقف الذي تم وضع هذه اللوحة عليه.

SolarPanelConfig

تصف سمة SolarPanelConfig موضعًا معيّنًا للألواح الشمسية على السطح.

الحقول
panels_count

int32

إجمالي عدد اللوحات يُرجى العِلم أنّ هذا الحقل متكرّر (مجموع) الحقول المقابلة في roof_segment_summaries.
yearly_energy_dc_kwh

float

مقدار طاقة ضوء الشمس التي يجمعها هذا التصميم على مدار عام، بالكيلوواط ساعة من التيار المباشر، بافتراض استخدام الألواح الموضّحة أعلاه
roof_segment_summaries[]

RoofSegmentSummary

معلومات عن إنتاج كل جزء من أجزاء السقف الذي يحمل لوحة واحدة على الأقل في هذا التنسيق تصف roof_segment_summaries[i] جزء السقف i، بما في ذلك حجمه وإنتاجه المتوقّع واتجاهه.

SolarPanelOrientation

اتجاه لوح شمسي ويجب تفسير ذلك بالنسبة إلى سمت جزء السقف الذي تم وضع اللوحة عليه.

عمليات التعداد
SOLAR_PANEL_ORIENTATION_UNSPECIFIED لا يتوفّر أي معلومات عن اتجاه اللوحة.
LANDSCAPE يكون جانب اللوحة LANDSCAPE الطويل عموديًا على اتجاه السمت لجزء السقف الذي يتم وضعها عليه.
PORTRAIT تكون حافة لوحة PORTRAIT الطويلة موازية لاتجاه السمت لجزء السطح الذي يتم وضعها عليه.

SolarPotential

معلومات عن الطاقة الشمسية التي يمكن توليدها من مبنى معيّن يتمّ تحديد عدد من الحقول في هذا القسم من حيث "اللوحات". تصف الحقول panel_capacity_watts وpanel_height_meters وpanel_width_meters مَعلمات نموذج اللوحة المستخدَمة في هذه العمليات الحسابية.

الحقول
max_array_panels_count

int32

حجم أكبر مجموعة، أي الحد الأقصى لعدد الألواح التي يمكن تركيبها على السطح
panel_capacity_watts

float

سعة اللوحة المستخدَمة في العمليات الحسابية، بالكيلوواط
panel_height_meters

float

ارتفاع اللوحة المستخدَمة في العمليات الحسابية، بالمتر في الوضع العمودي
panel_width_meters

float

عرض اللوحة المستخدَمة في العمليات الحسابية، بالمتر في الوضع العمودي
panel_lifetime_years

int32

العمر المتوقع لألواح الطاقة الشمسية، بالسنة تُستخدَم هذه القيمة في العمليات الحسابية المالية.
max_array_area_meters2

float

حجم الصفيف الأقصى، بالأمتار المربعة
max_sunshine_hours_per_year

float

الحد الأقصى لعدد ساعات سطوع الشمس التي يتم تلقّيها سنويًا في أي نقطة على السطح ساعات سطوع الشمس هي مقياس لإجمالي مقدار الإشعاع الشمسي (الطاقة) الذي يتم تلقّيه سنويًا. ساعة شمسية واحدة = كيلوواط ساعة واحدة لكل كيلوواط (حيث يشير كيلوواط إلى سعة كيلوواط في ظل ظروف الاختبار العادية).
carbon_offset_factor_kg_per_mwh

float

الكمية المكافئة لثاني أكسيد الكربون التي يتم إنتاجها لكل ميغاواط ساعة من كهرباء الشبكة وهذا مقياس لكثافة الانبعاثات الكربونية للكهرباء من الشبكة الكهربائية التي تم استبدالها بالكهرباء الشمسية.
whole_roof_stats

SizeAndSunshineStats

إجمالي الحجم ونِسب أشعة الشمس لجزء من السقف الذي تمّ تحديده لبعض أقسام السقف على الرغم من الاسم، قد لا يشمل ذلك المبنى بأكمله. يمكنك الاطّلاع على building_stats.
building_stats

SizeAndSunshineStats

حجم ونسب أشعة الشمس للمبنى بأكمله، بما في ذلك أجزاء من السقف لم يتم إسنادها إلى أي جزء من أجزاء السقف ولأنّ اتجاهات هذه الأجزاء غير محدّدة بدقة، فإنّ تقدير مساحة السقف غير موثوق به، ولكنّ تقدير مساحة الأرض موثوق به. قد يكون من الممكن الحصول على مساحة سطح مبنى أكثر موثوقية من خلال توسيع مساحة السطح من whole_roof_stats بمقدار نسبة مساحات الأرض building_stats وwhole_roof_stats.
roof_segment_stats[]

RoofSegmentSizeAndSunshineStats

مقاييس حجم أشعة الشمس لكل جزء من أجزاء السقف
solar_panels[]

SolarPanel

يصف كل SolarPanel لوحة شمسية واحدة. ويتم إدراجها بالترتيب الذي وضعته خوارزمية تنسيق اللوحة. وعادةً ما يتم ترتيبها تنازليًا حسب الإنتاج السنوي للطاقة، ولكن ليس دائمًا.
solar_panel_configs[]

SolarPanelConfig

يصف كل SolarPanelConfig ترتيبًا مختلفًا للألواح الشمسية على السطح. وهي مرتبة حسب عدد الألواح المتزايد. تستند SolarPanelConfig مع panels_count=N إلى أول N لوحة في قائمة solar_panels. لا تتم تعبئة هذا الحقل إلا إذا كان بالإمكان وضع 4 ألواح على الأقل على سطح.
financial_analyses[]

FinancialAnalysis

تعرِض بطاقة FinancialAnalysis التوفير الناتج عن استخدام الطاقة الشمسية بافتراض فاتورة شهرية معيّنة ومقدّم خدمة كهرباء معيّن. وهي مرتبة حسب الترتيب المتزايد لقيمة الفاتورة الشهرية. سيكون هذا الحقل فارغًا للمباني في المناطق التي لا تتوفّر فيها معلومات كافية لواجهة برمجة التطبيقات Solar API لإجراء العمليات الحسابية المالية.