- درخواست HTTP
- پارامترهای پرس و جو
- درخواست بدنه
- بدنه پاسخ
- دامنههای مجوز
- جعبه لات
- پتانسیل خورشیدی
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- پنل خورشیدی
- جهت پنل خورشیدی
- پیکربندی پنل خورشیدی
- خلاصه بخش سقف
- تحلیل مالی
- پول
- جزئیات مالی
- پساندازهای لیزینگ
- پسانداز در طول زمان
- خرید نقدیپسانداز
- خرید تأمین مالیپسانداز
- امتحانش کن!
ساختمانی را پیدا میکند که مرکز آن به نقطه پرسوجو نزدیکتر است. اگر هیچ ساختمانی در فاصله تقریباً ۵۰ متری از نقطه پرسوجو وجود نداشته باشد، خطایی با کد NOT_FOUND برمیگرداند.
درخواست HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای پرس و جو
| پارامترها | |
|---|---|
location | الزامی. طول و عرض جغرافیایی که API از آنجا به دنبال نزدیکترین ساختمان شناخته شده میگردد. |
requiredQuality | اختیاری. حداقل سطح کیفیت مجاز در نتایج. هیچ نتیجهای با کیفیت پایینتر از این بازگردانده نخواهد شد. عدم مشخص کردن این مورد معادل محدود کردن فقط به کیفیت بالا است. |
exactQualityRequired | اختیاری. اینکه آیا کیفیت دقیق تصویر مورد نیاز باشد یا خیر. اگر روی false تنظیم شود، فیلد |
experiments[] | اختیاری. ویژگیهای پیش از GA را برای فعال کردن مشخص میکند. |
درخواست بدنه
بدنه درخواست باید خالی باشد.
بدنه پاسخ
پیام پاسخ برای Solar.FindClosestBuildingInsights . اطلاعاتی در مورد مکان، ابعاد و پتانسیل خورشیدی یک ساختمان.
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "name": string, "center": { object ( |
| فیلدها | |
|---|---|
name | نام منبع برای ساختمان، با فرمت |
center | نقطهای نزدیک به مرکز ساختمان. |
boundingBox | جعبهی محصورکنندهی ساختمان. |
imageryDate | تاریخ دریافت تصاویر اصلی. این تقریبی است. |
imageryProcessedDate | وقتی پردازش روی این تصویر تکمیل شد. |
postalCode | کد پستی (مثلاً کد پستی ایالات متحده) که این ساختمان در آن قرار دارد. |
administrativeArea | منطقه اداری ۱ (مثلاً در ایالات متحده، ایالت) که شامل این ساختمان است. برای مثال، در ایالات متحده، مخفف آن ممکن است «MA» یا «CA» باشد. |
statisticalArea | منطقه آماری (مثلاً، حوزه سرشماری ایالات متحده) که این ساختمان در آن قرار دارد. |
regionCode | کد منطقه برای کشور (یا منطقهای) که این ساختمان در آن قرار دارد. |
solarPotential | پتانسیل خورشیدی ساختمان. |
imageryQuality | کیفیت تصاویر استفاده شده برای محاسبه دادههای این ساختمان. |
دامنههای مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/cloud-platform
جعبه لات
یک جعبه مرزی در مختصات عرض/طول.
| نمایش JSON |
|---|
{ "sw": { object ( |
| فیلدها | |
|---|---|
sw | گوشه جنوب غربی جعبه. |
ne | گوشه شمال شرقی جعبه. |
پتانسیل خورشیدی
اطلاعاتی در مورد پتانسیل خورشیدی یک ساختمان. تعدادی از فیلدها در این مورد بر اساس "پنلها" تعریف شدهاند. فیلدهای panelCapacityWatts ، panelHeightMeters و panelWidthMeters پارامترهای مدل پنل مورد استفاده در این محاسبات را توصیف میکنند.
| نمایش JSON |
|---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
| فیلدها | |
|---|---|
maxArrayPanelsCount | اندازه حداکثر آرایه - یعنی حداکثر تعداد پنلهایی که میتوانند روی سقف قرار گیرند. |
panelCapacityWatts | ظرفیت پنل مورد استفاده در محاسبات، بر حسب وات. |
panelHeightMeters | ارتفاع پنل مورد استفاده در محاسبات، بر حسب متر در حالت عمودی. |
panelWidthMeters | عرض پنل مورد استفاده در محاسبات، بر حسب متر در حالت عمودی. |
panelLifetimeYears | طول عمر مورد انتظار پنلهای خورشیدی (برحسب سال). این عدد در محاسبات مالی استفاده میشود. |
maxArrayAreaMeters2 | اندازه، بر حسب متر مربع، حداکثر آرایه. |
maxSunshineHoursPerYear | حداکثر تعداد ساعات آفتابی دریافتی در هر سال، توسط هر نقطه روی پشت بام. ساعات آفتابی معیاری از کل میزان تابش (انرژی) دریافتی در هر سال است. 1 ساعت آفتابی = 1 کیلووات ساعت به ازای هر کیلووات (که در آن کیلووات به کیلووات ظرفیت تحت شرایط آزمایش استاندارد اشاره دارد). |
carbonOffsetFactorKgPerMwh | مقدار معادل CO2 تولید شده به ازای هر مگاوات ساعت برق شبکه. این معیاری از شدت کربن برق شبکه است که توسط برق خورشیدی جایگزین شده است. |
wholeRoofStats | اندازه کل و مقادیر نور خورشید برای بخشی از سقف که به بخشی از سقف اختصاص داده شده است. برخلاف نامش، این ممکن است شامل کل ساختمان نباشد. به |
buildingStats | مقادیر اندازه و نور خورشید برای کل ساختمان، شامل بخشهایی از سقف که به برخی از بخشهای سقف اختصاص داده نشدهاند. از آنجا که جهتگیری این بخشها به خوبی مشخص نشده است، تخمین مساحت سقف غیرقابل اعتماد است، اما تخمین مساحت زمین قابل اعتماد است. ممکن است بتوان با مقیاسبندی مساحت سقف از |
roofSegmentStats[] | اندازه و کمیتهای نور خورشید برای هر بخش از سقف. |
solarPanels[] | هر |
solarPanelConfigs[] | هر |
financialAnalyses[] | یک |
SizeAndSunshineStats
کمیتهای اندازه و میزان آفتابگیری یک سقف یا بخشی از یک سقف.
| نمایش JSON |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| فیلدها | |
|---|---|
areaMeters2 | مساحت سقف یا قطعه سقف، بر حسب متر مربع. این مساحت سقف (با احتساب شیب) است، نه مساحت سطح زمین. |
sunshineQuantiles[] | کوانتایلهای میزان تابش نقطهای خورشید در سراسر منطقه. اگر N مقدار در اینجا وجود داشته باشد، این نشان دهنده (N-1)-iles است. برای مثال، اگر 5 مقدار وجود داشته باشد، آنها کوارتیلها (min، 25%، 50%، 75%، max) خواهند بود. مقادیر بر حسب kWh/kW سالانه هستند، مانند |
groundAreaMeters2 | مساحت سطح زمین تحت پوشش سقف یا قطعه سقف، بر حسب متر مربع. |
RoofSegmentSizeAndSunshineStats
اطلاعات مربوط به اندازه و مقادیر آفتابی بودن یک بخش از سقف.
| نمایش JSON |
|---|
{ "stats": { object ( |
| فیلدها | |
|---|---|
stats | اندازه کل و مقادیر تابش نور خورشید برای بخش سقف. |
center | نقطهای نزدیک به مرکز بخش سقف. |
boundingBox | جعبهی محصورکنندهی قطعهی سقف. |
pitchDegrees | زاویه قطعه سقف نسبت به صفحه زمین فرضی. ۰ = موازی با زمین، ۹۰ = عمود بر زمین. |
azimuthDegrees | جهت قطبنمایی که قطعه سقف به آن اشاره میکند. ۰ = شمال، ۹۰ = شرق، ۱۸۰ = جنوب. برای یک قطعه سقف "مسطح" ( |
planeHeightAtCenterMeters | ارتفاع صفحه قطعه سقف، بر حسب متر از سطح دریا، در نقطهای که با |
پنل خورشیدی
SolarPanel موقعیت، جهتگیری و تولید یک پنل خورشیدی واحد را توصیف میکند. برای اطلاعات در مورد پارامترهای پنل، به فیلدهای panelHeightMeters ، panelWidthMeters و panelCapacityWatts در SolarPotential مراجعه کنید.
| نمایش JSON |
|---|
{ "center": { object ( |
| فیلدها | |
|---|---|
center | مرکز پنل. |
orientation | جهت گیری پنل. |
yearlyEnergyDcKwh | این طرح در طول یک سال چه مقدار انرژی نور خورشید را جذب میکند، بر حسب کیلووات ساعت DC. |
segmentIndex | ایندکس در |
جهت پنل خورشیدی
جهت قرارگیری پنل خورشیدی. این جهت باید نسبت به آزیموت قسمتی از سقف که پنل روی آن قرار گرفته است، تفسیر شود.
| انومها | |
|---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED | جهت پنل مشخص نیست. |
LANDSCAPE | لبه بلند یک پنل LANDSCAPE عمود بر جهت آزیموت قسمتی از سقف است که روی آن قرار گرفته است. |
PORTRAIT | لبه بلند پنل PORTRAIT موازی با جهت آزیموت قسمتی از سقف است که روی آن قرار گرفته است. |
پیکربندی پنل خورشیدی
SolarPanelConfig نحوه قرارگیری خاص پنلهای خورشیدی روی پشت بام را توصیف میکند.
| نمایش JSON |
|---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
| فیلدها | |
|---|---|
panelsCount | تعداد کل پنلها. توجه داشته باشید که این تعداد، افزون بر (مجموع) فیلدهای مربوطه در |
yearlyEnergyDcKwh | این طرح با فرض پنلهای توضیح داده شده در بالا، چه مقدار انرژی نور خورشید را در طول یک سال، بر حسب کیلووات ساعت DC، جذب میکند. |
roofSegmentSummaries[] | اطلاعات مربوط به تولید هر بخش سقف که حداقل یک پنل در این طرح دارد. |
خلاصه بخش سقف
اطلاعات مربوط به یک بخش از سقف ساختمان، به همراه تعدادی پنل که روی آن قرار گرفتهاند.
| نمایش JSON |
|---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
| فیلدها | |
|---|---|
panelsCount | تعداد کل پنلهای موجود در این بخش. |
yearlyEnergyDcKwh | با فرض پنلهای توضیح داده شده در بالا، این بخش از طرح در طول یک سال چه مقدار انرژی نور خورشید را بر حسب کیلووات ساعت DC جذب میکند. |
pitchDegrees | زاویه قطعه سقف نسبت به صفحه زمین فرضی. ۰ = موازی با زمین، ۹۰ = عمود بر زمین. |
azimuthDegrees | جهت قطبنمایی که قطعه سقف به آن اشاره میکند. ۰ = شمال، ۹۰ = شرق، ۱۸۰ = جنوب. برای یک قطعه سقف "مسطح" ( |
segmentIndex | ایندکس در |
تحلیل مالی
تحلیل هزینه و مزایای طرح بهینه خورشیدی برای یک اندازه قبض برق خاص.
| نمایش JSON |
|---|
{ "monthlyBill": { object ( |
| فیلدها | |
|---|---|
monthlyBill | قبض برق ماهانهای که این تحلیل در نظر میگیرد. |
defaultBill | آیا این اندازه صورتحساب، به عنوان صورتحساب پیشفرض برای منطقهای که این ساختمان در آن قرار دارد انتخاب شده است یا خیر. دقیقاً یک |
averageKwhPerMonth | میزان مصرف برق خانه در یک ماه به طور متوسط، بر اساس مبلغ قبض و نرخ برق محلی. |
financialDetails | اطلاعات مالی که صرف نظر از روش تأمین مالی مورد استفاده، کاربرد دارد. |
leasingSavings | هزینه و مزایای اجاره پنلهای خورشیدی |
cashPurchaseSavings | هزینه و سود خرید پنلهای خورشیدی با پول نقد. |
financedPurchaseSavings | هزینه و سود خرید پنلهای خورشیدی با تأمین مالی خرید. |
panelConfigIndex | فهرست در |
پول
نشان دهنده مقدار پول به همراه نوع ارز آن است.
| نمایش JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| فیلدها | |
|---|---|
currencyCode | کد ارزی سه حرفی که در استاندارد ISO 4217 تعریف شده است. |
units | کل واحدهای مبلغ. برای مثال اگر |
nanos | تعداد نانو (10^-9) واحد از مبلغ. مقدار باید بین -999,999,999 و +999,999,999 باشد. اگر |
جزئیات مالی
جزئیات یک تحلیل مالی. برخی از این جزئیات از قبل در سطوح بالاتر ذخیره شدهاند (مثلاً هزینه از جیب). کل مبالغ در طول یک دوره عمر که توسط فیلد panelLifetimeYears در SolarPotential تعریف شده است، محاسبه میشوند. توجه: هزینه از جیب خرید پنلها در فیلد outOfPocketCost در CashPurchaseSavings ارائه شده است.
| نمایش JSON |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| فیلدها | |
|---|---|
initialAcKwhPerYear | فکر میکنیم پنلهای خورشیدی در سال اول خود چند کیلووات ساعت برق متناوب تولید خواهند کرد. |
remainingLifetimeUtilityBill | قبض برق برای برقی که توسط پنلهای خورشیدی تولید نمیشود، برای طول عمر پنلها. |
federalIncentive | میزان بودجهای که از محل مشوقهای فدرال در دسترس است؛ این مبلغ در صورتی اعمال میشود که کاربر (با وام یا بدون وام) پنلها را خریداری کند. |
stateIncentive | میزان بودجهای که از محل مشوقهای دولتی در دسترس است؛ این مبلغ در صورتی اعمال میشود که کاربر (با وام یا بدون وام) پنلها را خریداری کند. |
utilityIncentive | میزان پولی که از محل مشوقهای رفاهی در دسترس است؛ این موضوع در صورتی اعمال میشود که کاربر (با وام یا بدون وام) پنلها را خریداری کند. |
lifetimeSrecTotal | میزان پولی که کاربر در طول عمر پنل از محل اعتبارات انرژی تجدیدپذیر خورشیدی دریافت خواهد کرد؛ این مبلغ در صورتی اعمال میشود که کاربر پنلها را (با وام یا بدون وام) خریداری کند. |
costOfElectricityWithoutSolar | کل هزینه برقی که کاربر در طول عمر خود در صورت عدم نصب پنل خورشیدی باید پرداخت میکرد. |
netMeteringAllowed | آیا اندازهگیری خالص مجاز است؟ |
solarPercentage | درصد (۰-۱۰۰) از برق مصرفی کاربر که توسط انرژی خورشیدی تأمین میشود. برای سال اول معتبر است اما تقریباً برای سالهای آینده صحیح است. |
percentageExportedToGrid | درصد (0-100) تولید برق خورشیدی که ما فرض کردیم به شبکه برق صادر میشود، بر اساس سه ماهه اول تولید. اگر اندازهگیری خالص مجاز نباشد، این موضوع بر محاسبات تأثیر میگذارد. |
پساندازهای لیزینگ
هزینه و سود اجاره پیکربندی خاصی از پنلهای خورشیدی با مصرف برق خاص.
| نمایش JSON |
|---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
| فیلدها | |
|---|---|
leasesAllowed | آیا اجاره نامه در این حوزه قضایی مجاز است (در برخی ایالت ها اجاره نامه مجاز نیست). اگر این فیلد نادرست باشد، احتمالاً باید مقادیر این پیام نادیده گرفته شوند. |
leasesSupported | اینکه آیا اجارهها در این حوزه قضایی توسط موتور محاسبات مالی پشتیبانی میشوند یا خیر. اگر این فیلد نادرست باشد، احتمالاً باید مقادیر این پیام نادیده گرفته شوند. این مستقل از |
annualLeasingCost | هزینه تخمینی اجاره سالانه |
savings | چه مقدار در طول عمر پسانداز میشود (یا نمیشود). |
پسانداز در طول زمان
اطلاعات مالی که بین روشهای مختلف تأمین مالی به اشتراک گذاشته میشود.
| نمایش JSON |
|---|
{ "savingsYear1": { object ( |
| فیلدها | |
|---|---|
savingsYear1 | صرفهجویی در سال اول پس از نصب پنل. |
savingsYear20 | صرفهجویی در بیست سال اول پس از نصب پنل. |
presentValueOfSavingsYear20 | با استفاده از نرخ تنزیل فرضی، ارزش فعلی کل پسانداز ۲۰ ساله چقدر است؟ |
savingsLifetime | صرفهجویی در کل طول عمر پنل. |
presentValueOfSavingsLifetime | با استفاده از نرخ تنزیل فرضی، ارزش فعلی کل پساندازهای مادامالعمر چقدر است؟ |
financiallyViable | نشان میدهد که آیا این سناریو از نظر مالی قابل اجرا است یا خیر. برای سناریوهایی با قابلیت اجرا مالی ضعیف (مثلاً ضرر مالی) نادرست خواهد بود. |
خرید نقدیپسانداز
هزینه و سود خرید قطعی یک پیکربندی خاص از پنلهای خورشیدی با مصرف برق خاص.
| نمایش JSON |
|---|
{ "outOfPocketCost": { object ( |
| فیلدها | |
|---|---|
outOfPocketCost | هزینه اولیه قبل از مشوقهای مالیاتی: مبلغی که باید از جیب پرداخت شود. در مقابل |
upfrontCost | هزینه اولیه پس از مشوقهای مالیاتی: مبلغی است که باید در طول سال اول پرداخت شود. در مقابل، |
rebateValue | ارزش تمام تخفیفهای مالیاتی. |
savings | چه مقدار در طول عمر پسانداز میشود (یا نمیشود). |
paybackYears | تعداد سالهایی که تا زمان بازگشت سرمایه باقی مانده است. مقدار منفی به این معنی است که بازگشت سرمایه هرگز در طول دوره عمر رخ نمیدهد. |
خرید تأمین مالیپسانداز
هزینه و فایده استفاده از وام برای خرید پیکربندی خاصی از پنلهای خورشیدی با مصرف برق خاص.
| نمایش JSON |
|---|
{ "annualLoanPayment": { object ( |
| فیلدها | |
|---|---|
annualLoanPayment | پرداخت وام سالانه. |
rebateValue | ارزش تمام تخفیفهای مالیاتی (شامل اعتبار مالیاتی سرمایهگذاری فدرال (ITC)). |
loanInterestRate | نرخ بهره وامهای فرض شده در این مجموعه محاسبات. |
savings | چه مقدار در طول عمر پسانداز میشود (یا نمیشود). |