- درخواست HTTP
- پارامترهای پرس و جو
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- LatLngBox
- پتانسیل خورشیدی
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- پنل خورشیدی
- جهت گیری پنل خورشیدی
- SolarPanelConfig
- RoofSegmentSummary
- تحلیل مالی
- پول
- جزئیات مالی
- پس انداز اجاره
- SavingsOverTime
- پس انداز خرید نقدی
- FinancedPurchaseSavings
- آن را امتحان کنید!
نزدیکترین ساختمان به یک نقطه پرس و جو را تعیین می کند. اگر هیچ ساختمانی در حدود 50 متری نقطه پرس و جو وجود نداشته باشد، یک خطا با کد NOT_FOUND
برمی گرداند.
درخواست HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
پارامترها | |
---|---|
location | مورد نیاز. طول و عرض جغرافیایی که API از آن به دنبال نزدیکترین ساختمان شناخته شده است. |
required Quality | اختیاری. حداقل سطح کیفی مجاز در نتایج. هیچ نتیجه ای با کیفیت پایین تر از این برگردانده نمی شود. عدم تعیین این معادل محدود کردن فقط به کیفیت بالا است. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پیام پاسخ برای Solar.FindClosestBuildingInsights
. اطلاعاتی در مورد مکان، ابعاد و پتانسیل خورشیدی یک ساختمان.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "name": string, "center": { object ( |
فیلدها | |
---|---|
name | نام منبع برای ساختمان، با فرمت |
center | نقطه ای نزدیک مرکز ساختمان. |
bounding Box | جعبه مرزبندی ساختمان. |
imagery Date | تاریخی که تصاویر زیربنایی به دست آمد. این تقریبی است. |
imagery Processed Date | زمانی که پردازش روی این تصویر تکمیل شد. |
postal Code | کد پستی (به عنوان مثال، کد پستی ایالات متحده) این ساختمان توسط. |
administrative Area | منطقه اداری 1 (به عنوان مثال، در ایالات متحده، ایالت) که شامل این ساختمان است. به عنوان مثال، در ایالات متحده، مخفف ممکن است "MA" یا "CA" باشد. |
statistical Area | منطقه آماری (مثلاً سرشماری ایالات متحده) این ساختمان در آن قرار دارد. |
region Code | کد منطقه برای کشور (یا منطقه) این ساختمان در آن است. |
solar Potential | پتانسیل خورشیدی ساختمان |
imagery Quality | کیفیت تصاویر مورد استفاده برای محاسبه داده های این ساختمان. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/cloud-platform
LatLngBox
یک جعبه مرزی در مختصات lat/lng.
نمایندگی 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 ( |
فیلدها | |
---|---|
max Array Panels Count | اندازه حداکثر آرایه - یعنی حداکثر تعداد پانل هایی که می توانند روی سقف قرار بگیرند. |
panel Capacity Watts | ظرفیت، بر حسب وات، پانل مورد استفاده در محاسبات. |
panel Height Meters | ارتفاع پانل مورد استفاده در محاسبات، بر حسب متر در جهت عمودی. |
panel Width Meters | عرض، بر حسب متر در جهت عمودی، پانل مورد استفاده در محاسبات. |
panel Lifetime Years | طول عمر مورد انتظار، بر حسب سال، از پانل های خورشیدی. این در محاسبات مالی استفاده می شود. |
max Array Area Meters2 | اندازه حداکثر آرایه، بر حسب متر مربع. |
max Sunshine Hours Per Year | حداکثر تعداد ساعات آفتابی دریافت شده در سال، در هر نقطه از پشت بام. ساعات آفتابی معیاری از کل مقدار تابش (انرژی) دریافتی در سال است. 1 ساعت آفتابی = 1 کیلووات ساعت در هر کیلووات (که در آن kW به کیلووات ظرفیت تحت شرایط تست استاندارد اشاره دارد). |
carbon Offset Factor Kg Per Mwh | مقدار معادل CO2 تولید شده در هر مگاوات ساعت برق شبکه. این معیاری از شدت کربن برق شبکه است که توسط برق خورشیدی جابجا شده است. |
whole Roof Stats | اندازه کل و کمیت های نور خورشید برای بخشی از سقف که به بخشی از سقف اختصاص داده شده است. علیرغم نام، این ممکن است شامل کل ساختمان نباشد. |
building Stats | اندازه و کمیت های نور خورشید برای کل ساختمان، از جمله قسمت هایی از سقف که به بخشی از سقف اختصاص داده نشده اند. از آنجایی که جهت گیری این قطعات به خوبی مشخص نشده است، تخمین مساحت سقف غیر قابل اعتماد است، اما برآورد سطح زمین قابل اعتماد است. ممکن است با مقیاس بندی مساحت سقف از |
roof Segment Stats[] | اندازه و چندک نور خورشید برای هر بخش سقف. |
solar Panels[] | هر |
solar Panel Configs[] | هر |
financial Analyses[] | یک |
SizeAndSunshineStats
چندک های اندازه و آفتابی یک سقف یا بخشی از سقف.
نمایندگی JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
فیلدها | |
---|---|
area Meters2 | مساحت سقف یا بخش سقف، بر حسب m^2. این مساحت سقف است (با محاسبه شیب)، نه مساحت ردپای زمین. |
sunshine Quantiles[] | چند درصد آفتابی در سراسر منطقه. اگر مقادیر N در اینجا وجود داشته باشد، این نشان دهنده (N-1) -iles است. به عنوان مثال، اگر 5 مقدار وجود داشته باشد، آنگاه آنها چارک ها خواهند بود (حداقل، 25، 50، 75، حداکثر). مقادیر بر حسب کیلووات ساعت/کیلووات سالانه مانند |
ground Area Meters2 | مساحت ردپای زمین که توسط سقف یا بخش سقف پوشانده شده است، بر حسب m^2. |
RoofSegmentSizeAndSunshineStats
اطلاعاتی در مورد اندازه و چندک های آفتابی یک بخش سقف.
نمایندگی JSON |
---|
{ "stats": { object ( |
فیلدها | |
---|---|
stats | اندازه کل و کمیت های نور خورشید برای بخش سقف. |
center | نقطه ای نزدیک به مرکز بخش سقف. |
bounding Box | جعبه مرزی بخش سقف. |
pitch Degrees | زاویه بخش سقف نسبت به سطح زمین نظری. 0 = موازی با زمین، 90 = عمود بر زمین. |
azimuth Degrees | جهت قطب نما قسمت سقف به سمت آن است. 0 = شمال، 90 = شرق، 180 = جنوب. برای یک بخش سقف "مسطح" ( |
plane Height At Center Meters | ارتفاع صفحه بخش سقف، بر حسب متر از سطح دریا، در نقطه تعیین شده توسط |
پنل خورشیدی
SolarPanel موقعیت، جهت گیری و تولید یک پنل خورشیدی منفرد را توصیف می کند. برای اطلاعات در مورد پارامترهای پانل به فیلدهای panelHeightMeters
، panelWidthMeters
و panelCapacityWatts
در SolarPotential
مراجعه کنید.
نمایندگی JSON |
---|
{ "center": { object ( |
فیلدها | |
---|---|
center | مرکز پانل. |
orientation | جهت پانل. |
yearly Energy Dc Kwh | این طرحبندی چقدر انرژی نور خورشید را در طول یک سال، بر حسب کیلووات ساعت DC جذب میکند. |
segment Index | نمایه در |
جهت گیری پنل خورشیدی
جهت گیری پنل خورشیدی این باید نسبت به آزیموت قسمت سقفی که پانل روی آن قرار گرفته است تفسیر شود.
Enums | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED | هیچ جهت پانل مشخص نیست. |
LANDSCAPE | یک پانل LANDSCAPE دارای لبه بلند خود عمود بر جهت آزیموت قسمت سقفی است که روی آن قرار گرفته است. |
PORTRAIT | یک پانل PORTRAIT لبه بلند خود را موازی با جهت آزیموت قسمت سقفی است که روی آن قرار گرفته است. |
SolarPanelConfig
SolarPanelConfig محل خاصی از پانل های خورشیدی را بر روی سقف توضیح می دهد.
نمایندگی JSON |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
فیلدها | |
---|---|
panels Count | تعداد کل پانل ها توجه داشته باشید که این به (مجموع) فیلدهای مربوطه در |
yearly Energy Dc Kwh | این طرحبندی چه مقدار انرژی نور خورشید را در طول یک سال، بر حسب کیلووات ساعت DC، با فرض پنلهایی که در بالا توضیح داده شد، جذب میکند. |
roof Segment Summaries[] | اطلاعات مربوط به تولید هر بخش سقف که حداقل یک پانل را در این طرح حمل می کند. |
RoofSegmentSummary
اطلاعاتی در مورد یک بخش سقف در ساختمان، با تعدادی پانل روی آن قرار داده شده است.
نمایندگی JSON |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
فیلدها | |
---|---|
panels Count | تعداد کل پانل ها در این بخش. |
yearly Energy Dc Kwh | این بخش از طرح چه مقدار انرژی نور خورشید را در طول یک سال، بر حسب کیلووات ساعت DC، با فرض پنل های توضیح داده شده در بالا، جذب می کند. |
pitch Degrees | زاویه بخش سقف نسبت به سطح زمین نظری. 0 = موازی با زمین، 90 = عمود بر زمین. |
azimuth Degrees | جهت قطب نما قسمت سقف به سمت آن است. 0 = شمال، 90 = شرق، 180 = جنوب. برای یک بخش سقف "مسطح" ( |
segment Index | فهرست در |
تحلیل مالی
تجزیه و تحلیل هزینه و مزایای طرح خورشیدی بهینه برای اندازه قبض برق خاص.
نمایندگی JSON |
---|
{ "monthlyBill": { object ( |
فیلدها | |
---|---|
monthly Bill | قبض برق ماهانه این تجزیه و تحلیل فرض می کند. |
default Bill | آیا این اندازه صورتحساب انتخاب شده به عنوان صورتحساب پیشفرض برای منطقهای است که این ساختمان در آن قرار دارد. دقیقاً یک |
average Kwh Per Month | بر اساس اندازه قبض و نرخ برق محلی، خانه چقدر برق در یک ماه مصرف می کند. |
financial Details | اطلاعات مالی که بدون توجه به روش تامین مالی مورد استفاده اعمال می شود. |
leasing Savings | هزینه و فایده اجاره پنل های خورشیدی |
cash Purchase Savings | هزینه و سود خرید نقدی پنل خورشیدی |
financed Purchase Savings | هزینه و سود خرید پنل های خورشیدی با تامین مالی خرید. |
panel Config Index | نمایه در |
پول
مقداری پول را با نوع ارز آن نشان می دهد.
نمایندگی JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
فیلدها | |
---|---|
currency Code | کد ارز سه حرفی تعریف شده در ISO 4217. |
units | کل واحدهای مقدار. به عنوان مثال، اگر |
nanos | تعداد نانو (10^-9) واحد مقدار. مقدار باید بین -999,999,999 و +999,999,999 باشد. اگر |
جزئیات مالی
جزئیات یک تحلیل مالی برخی از این جزئیات در حال حاضر در سطوح بالاتر ذخیره شده اند (به عنوان مثال، هزینه از جیب شما). مجموع مبالغ پول در طول یک دوره عمر تعریف شده توسط قسمت panelLifetimeYears
در SolarPotential
است. توجه: هزینه از جیب خرید پنل ها در قسمت outOfPocketCost
در CashPurchaseSavings
آورده شده است.
نمایندگی JSON |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
فیلدها | |
---|---|
initial Ac Kwh Per Year | ما فکر میکنیم که پنلهای خورشیدی در سال اول خود چقدر AC کیلووات ساعت تولید خواهند کرد. |
remaining Lifetime Utility Bill | قبض آب و برق برای برق تولید نشده توسط خورشیدی، برای طول عمر پانل ها. |
federal Incentive | مقدار پول موجود از مشوق های فدرال؛ این در صورتی اعمال می شود که کاربر پنل ها را (با یا بدون وام) خریداری کند. |
state Incentive | مقدار پول موجود از مشوق های دولتی؛ این در صورتی اعمال می شود که کاربر پنل ها را (با یا بدون وام) خریداری کند. |
utility Incentive | مقدار پول در دسترس از مشوق های خدمات عمومی؛ این در صورتی اعمال می شود که کاربر پنل ها را (با یا بدون وام) خریداری کند. |
lifetime Srec Total | مقدار پولی که کاربر از اعتبارات انرژی تجدیدپذیر خورشیدی در طول عمر پنل دریافت می کند. این در صورتی اعمال می شود که کاربر پنل ها را (با یا بدون وام) خریداری کند. |
cost Of Electricity Without Solar | اگر کاربر خورشیدی را نصب نمی کرد، کل هزینه برق را که کاربر در طول عمر پرداخت می کرد. |
net Metering Allowed | آیا اندازه گیری خالص مجاز است یا خیر. |
solar Percentage | درصد (0-100) برق کاربر توسط خورشیدی تامین می شود. برای سال اول معتبر است اما برای سال های آینده تقریبا درست است. |
percentage Exported To Grid | درصد (0-100) تولید برق خورشیدی که ما فرض کردیم بر اساس سه ماهه اول تولید به شبکه صادر شده است. اگر اندازه گیری خالص مجاز نباشد، این محاسبات را تحت تأثیر قرار می دهد. |
پس انداز اجاره
هزینه و سود اجاره پیکربندی خاصی از پانل های خورشیدی با مصرف برق خاص.
نمایندگی JSON |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
فیلدها | |
---|---|
leases Allowed | آیا اجاره نامه در این حوزه قضایی مجاز است (اجاره در برخی از ایالت ها مجاز نیست). اگر این فیلد نادرست است، احتمالاً باید مقادیر موجود در این پیام نادیده گرفته شود. |
leases Supported | آیا اجاره نامه ها در این حوزه قضایی توسط موتور محاسبات مالی پشتیبانی می شوند یا خیر. اگر این فیلد نادرست است، احتمالاً باید مقادیر موجود در این پیام نادیده گرفته شود. این مستقل از |
annual Leasing Cost | برآورد هزینه اجاره سالانه |
savings | چه مقدار در طول عمر ذخیره می شود (یا نه). |
SavingsOverTime
اطلاعات مالی که بین روش های مختلف تامین مالی به اشتراک گذاشته می شود.
نمایندگی JSON |
---|
{ "savingsYear1": { object ( |
فیلدها | |
---|---|
savings Year1 | صرفه جویی در سال اول پس از نصب پانل. |
savings Year20 | صرفه جویی در بیست سال اول پس از نصب پانل. |
present Value Of Savings Year20 | با استفاده از نرخ تنزیل مفروض، ارزش فعلی پس انداز انباشته 20 ساله چقدر است؟ |
savings Lifetime | صرفه جویی در کل طول عمر پانل. |
present Value Of Savings Lifetime | با استفاده از نرخ تنزیل مفروض، ارزش فعلی پس انداز تجمعی مادام العمر چقدر است؟ |
financially Viable | نشان می دهد که آیا این سناریو از نظر مالی مقرون به صرفه است یا خیر. برای سناریوهایی با قابلیت مالی ضعیف (مثلاً از دست دادن پول) نادرست خواهد بود. |
پس انداز خرید نقدی
هزینه و سود خرید مستقیم یک پیکربندی خاص از پانل های خورشیدی با مصرف برق خاص.
نمایندگی JSON |
---|
{ "outOfPocketCost": { object ( |
فیلدها | |
---|---|
out Of Pocket Cost | هزینه اولیه قبل از مشوق های مالیاتی: مبلغی که باید از جیب پرداخت شود. در مقایسه با |
upfront Cost | هزینه اولیه پس از مشوق های مالیاتی: مبلغی است که باید در طول سال اول پرداخت شود. در مقایسه با |
rebate Value | ارزش کلیه تخفیفات مالیاتی |
savings | چه مقدار در طول عمر ذخیره می شود (یا نه). |
payback Years | تعداد سالها تا زمان بازپرداخت یک ارزش منفی به این معنی است که بازپرداخت هرگز در طول مدت عمر اتفاق نمی افتد. |
FinancedPurchaseSavings
هزینه و سود استفاده از وام برای خرید پیکربندی خاصی از پانل های خورشیدی با مصرف برق خاص.
نمایندگی JSON |
---|
{ "annualLoanPayment": { object ( |
فیلدها | |
---|---|
annual Loan Payment | پرداخت وام سالانه. |
rebate Value | ارزش تمام تخفیفات مالیاتی (از جمله اعتبار مالیاتی سرمایه گذاری فدرال (ITC)). |
loan Interest Rate | نرخ بهره وام های در نظر گرفته شده در این مجموعه از محاسبات. |
savings | چه مقدار در طول عمر ذخیره می شود (یا نه). |