- درخواست 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 از آن به دنبال نزدیکترین ساختمان شناخته شده است. |
requiredQuality | اختیاری. حداقل سطح کیفی مجاز در نتایج. هیچ نتیجه ای با کیفیت پایین تر از این برگردانده نمی شود. عدم تعیین این معادل محدود کردن فقط به کیفیت بالا است. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پیام پاسخ برای Solar.FindClosestBuildingInsights
. اطلاعاتی در مورد مکان، ابعاد و پتانسیل خورشیدی یک ساختمان.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "name": string, "center": { object ( |
فیلدها | |
---|---|
name | نام منبع برای ساختمان، با فرمت |
center | نقطه ای نزدیک مرکز ساختمان. |
boundingBox | جعبه مرزبندی ساختمان. |
imageryDate | تاریخی که تصاویر زیربنایی به دست آمد. این تقریبی است. |
imageryProcessedDate | زمانی که پردازش روی این تصویر تکمیل شد. |
postalCode | کد پستی (به عنوان مثال، کد پستی ایالات متحده) این ساختمان توسط. |
administrativeArea | منطقه اداری 1 (به عنوان مثال، در ایالات متحده، ایالت) که شامل این ساختمان است. به عنوان مثال، در ایالات متحده، مخفف ممکن است "MA" یا "CA" باشد. |
statisticalArea | منطقه آماری (مثلاً سرشماری ایالات متحده) این ساختمان در آن قرار دارد. |
regionCode | کد منطقه برای کشور (یا منطقه) این ساختمان در آن است. |
solarPotential | پتانسیل خورشیدی ساختمان |
imageryQuality | کیفیت تصاویر مورد استفاده برای محاسبه داده های این ساختمان. |
محدوده مجوز
به محدوده 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 ( |
فیلدها | |
---|---|
maxArrayPanelsCount | اندازه حداکثر آرایه - یعنی حداکثر تعداد پانل هایی که می توانند روی سقف قرار بگیرند. |
panelCapacityWatts | ظرفیت، بر حسب وات، پانل مورد استفاده در محاسبات. |
panelHeightMeters | ارتفاع پانل مورد استفاده در محاسبات، بر حسب متر در جهت عمودی. |
panelWidthMeters | عرض، بر حسب متر در جهت عمودی، پانل مورد استفاده در محاسبات. |
panelLifetimeYears | طول عمر مورد انتظار، بر حسب سال، از پانل های خورشیدی. این در محاسبات مالی استفاده می شود. |
maxArrayAreaMeters2 | اندازه حداکثر آرایه، بر حسب متر مربع. |
maxSunshineHoursPerYear | حداکثر تعداد ساعات آفتابی دریافت شده در سال، در هر نقطه از پشت بام. ساعات آفتابی معیاری از کل مقدار تابش (انرژی) دریافتی در سال است. 1 ساعت آفتابی = 1 کیلووات ساعت در هر کیلووات (که در آن kW به کیلووات ظرفیت تحت شرایط تست استاندارد اشاره دارد). |
carbonOffsetFactorKgPerMwh | مقدار معادل CO2 تولید شده در هر مگاوات ساعت برق شبکه. این معیاری از شدت کربن برق شبکه است که توسط برق خورشیدی جابجا شده است. |
wholeRoofStats | اندازه کل و کمیت های نور خورشید برای بخشی از سقف که به بخشی از سقف اختصاص داده شده است. علیرغم نام، این ممکن است شامل کل ساختمان نباشد. |
buildingStats | اندازه و کمیت های نور خورشید برای کل ساختمان، از جمله قسمت هایی از سقف که به بخشی از سقف اختصاص داده نشده اند. از آنجایی که جهت گیری این قطعات به خوبی مشخص نشده است، تخمین مساحت سقف غیر قابل اعتماد است، اما برآورد سطح زمین قابل اعتماد است. ممکن است با مقیاس بندی مساحت سقف از |
roofSegmentStats[] | اندازه و چندک نور خورشید برای هر بخش سقف. |
solarPanels[] | هر |
solarPanelConfigs[] | هر |
financialAnalyses[] | یک |
SizeAndSunshineStats
چندک های اندازه و آفتابی یک سقف یا بخشی از سقف.
نمایندگی JSON |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
فیلدها | |
---|---|
areaMeters2 | مساحت سقف یا بخش سقف، بر حسب m^2. این مساحت سقف است (با محاسبه شیب)، نه مساحت ردپای زمین. |
sunshineQuantiles[] | چند درصد آفتابی در سراسر منطقه. اگر مقادیر N در اینجا وجود داشته باشد، این نشان دهنده (N-1) -iles است. به عنوان مثال، اگر 5 مقدار وجود داشته باشد، آنگاه آنها چارک ها خواهند بود (حداقل، 25، 50، 75، حداکثر). مقادیر بر حسب کیلووات ساعت/کیلووات سالانه مانند |
groundAreaMeters2 | مساحت ردپای زمین که توسط سقف یا بخش سقف پوشانده شده است، بر حسب m^2. |
RoofSegmentSizeAndSunshineStats
اطلاعاتی در مورد اندازه و چندک های آفتابی یک بخش سقف.
نمایندگی JSON |
---|
{ "stats": { object ( |
فیلدها | |
---|---|
stats | اندازه کل و کمیت های نور خورشید برای بخش سقف. |
center | نقطه ای نزدیک به مرکز بخش سقف. |
boundingBox | جعبه مرزی بخش سقف. |
pitchDegrees | زاویه بخش سقف نسبت به سطح زمین نظری. 0 = موازی با زمین، 90 = عمود بر زمین. |
azimuthDegrees | جهت قطب نما قسمت سقف به سمت آن است. 0 = شمال، 90 = شرق، 180 = جنوب. برای یک بخش سقف "مسطح" ( |
planeHeightAtCenterMeters | ارتفاع صفحه بخش سقف، بر حسب متر از سطح دریا، در نقطه تعیین شده توسط |
پنل خورشیدی
SolarPanel موقعیت، جهت گیری و تولید یک پنل خورشیدی منفرد را توصیف می کند. برای اطلاعات در مورد پارامترهای پانل به فیلدهای panelHeightMeters
، panelWidthMeters
و panelCapacityWatts
در SolarPotential
مراجعه کنید.
نمایندگی JSON |
---|
{ "center": { object ( |
فیلدها | |
---|---|
center | مرکز پانل. |
orientation | جهت پانل. |
yearlyEnergyDcKwh | این طرحبندی چقدر انرژی نور خورشید را در طول یک سال، بر حسب کیلووات ساعت DC جذب میکند. |
segmentIndex | نمایه در |
جهت گیری پنل خورشیدی
جهت گیری پنل خورشیدی این باید نسبت به آزیموت قسمت سقفی که پانل روی آن قرار گرفته است تفسیر شود.
Enums | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED | هیچ جهت پانل مشخص نیست. |
LANDSCAPE | یک پانل LANDSCAPE دارای لبه بلند خود عمود بر جهت آزیموت قسمت سقفی است که روی آن قرار گرفته است. |
PORTRAIT | یک پانل PORTRAIT لبه بلند خود را موازی با جهت آزیموت قسمت سقفی است که روی آن قرار گرفته است. |
SolarPanelConfig
SolarPanelConfig محل خاصی از پانل های خورشیدی را بر روی سقف توضیح می دهد.
نمایندگی JSON |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
فیلدها | |
---|---|
panelsCount | تعداد کل پانل ها توجه داشته باشید که این به (مجموع) فیلدهای مربوطه در |
yearlyEnergyDcKwh | این طرحبندی چه مقدار انرژی نور خورشید را در طول یک سال، بر حسب کیلووات ساعت DC، با فرض پنلهایی که در بالا توضیح داده شد، جذب میکند. |
roofSegmentSummaries[] | اطلاعات مربوط به تولید هر بخش سقف که حداقل یک پانل را در این طرح حمل می کند. |
RoofSegmentSummary
اطلاعاتی در مورد یک بخش سقف در ساختمان، با تعدادی پانل روی آن قرار داده شده است.
نمایندگی JSON |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
فیلدها | |
---|---|
panelsCount | تعداد کل پانل ها در این بخش. |
yearlyEnergyDcKwh | این بخش از طرح چه مقدار انرژی نور خورشید را در طول یک سال، بر حسب کیلووات ساعت DC، با فرض پنل های توضیح داده شده در بالا، جذب می کند. |
pitchDegrees | زاویه بخش سقف نسبت به سطح زمین نظری. 0 = موازی با زمین، 90 = عمود بر زمین. |
azimuthDegrees | جهت قطب نما قسمت سقف به سمت آن است. 0 = شمال، 90 = شرق، 180 = جنوب. برای یک بخش سقف "مسطح" ( |
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 | ما فکر میکنیم که پنلهای خورشیدی در سال اول خود چقدر AC کیلووات ساعت تولید خواهند کرد. |
remainingLifetimeUtilityBill | قبض آب و برق برای برق تولید نشده توسط خورشیدی، برای طول عمر پانل ها. |
federalIncentive | مقدار پول موجود از مشوق های فدرال؛ این در صورتی اعمال می شود که کاربر پنل ها را (با یا بدون وام) خریداری کند. |
stateIncentive | مقدار پول موجود از مشوق های دولتی؛ این در صورتی اعمال می شود که کاربر پنل ها را (با یا بدون وام) خریداری کند. |
utilityIncentive | مقدار پول در دسترس از مشوق های خدمات عمومی؛ در صورتی که کاربر پنل ها را بخرد (با یا بدون وام) اعمال می شود. |
lifetimeSrecTotal | مقدار پولی که کاربر از اعتبارات انرژی تجدیدپذیر خورشیدی در طول عمر پنل دریافت می کند. در صورتی که کاربر پنل ها را بخرد (با یا بدون وام) اعمال می شود. |
costOfElectricityWithoutSolar | اگر کاربر خورشیدی را نصب نمی کرد، کل هزینه برق را که کاربر در طول عمر پرداخت می کرد. |
netMeteringAllowed | آیا اندازه گیری خالص مجاز است یا خیر. |
solarPercentage | درصد (0-100) برق کاربر توسط خورشیدی تامین می شود. برای سال اول معتبر است اما برای سال های آینده تقریبا درست است. |
percentageExportedToGrid | درصد (0-100) تولید برق خورشیدی که ما فرض کردیم بر اساس سه ماهه اول تولید به شبکه صادر شده است. اگر اندازه گیری خالص مجاز نباشد، این محاسبات را تحت تأثیر قرار می دهد. |
پس انداز اجاره
هزینه و سود اجاره پیکربندی خاصی از پانل های خورشیدی با مصرف برق خاص.
نمایندگی JSON |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
فیلدها | |
---|---|
leasesAllowed | آیا اجاره نامه در این حوزه قضایی مجاز است (اجاره در برخی از ایالت ها مجاز نیست). اگر این فیلد نادرست است، احتمالاً باید مقادیر موجود در این پیام نادیده گرفته شود. |
leasesSupported | آیا اجاره نامه ها در این حوزه قضایی توسط موتور محاسبات مالی پشتیبانی می شوند یا خیر. اگر این فیلد نادرست است، احتمالاً باید مقادیر موجود در این پیام نادیده گرفته شود. این مستقل از |
annualLeasingCost | برآورد هزینه اجاره سالانه |
savings | چه مقدار در طول عمر ذخیره می شود (یا نه). |
SavingsOverTime
اطلاعات مالی که بین روش های مختلف تامین مالی به اشتراک گذاشته می شود.
نمایندگی JSON |
---|
{ "savingsYear1": { object ( |
فیلدها | |
---|---|
savingsYear1 | صرفه جویی در سال اول پس از نصب پانل. |
savingsYear20 | صرفه جویی در بیست سال اول پس از نصب پانل. |
presentValueOfSavingsYear20 | با استفاده از نرخ تنزیل مفروض، ارزش فعلی پس انداز انباشته 20 ساله چقدر است؟ |
savingsLifetime | صرفه جویی در کل طول عمر پانل. |
presentValueOfSavingsLifetime | با استفاده از نرخ تنزیل مفروض، ارزش فعلی پس انداز تجمعی مادام العمر چقدر است؟ |
financiallyViable | نشان می دهد که آیا این سناریو از نظر مالی مقرون به صرفه است یا خیر. برای سناریوهایی با قابلیت مالی ضعیف (مثلاً از دست دادن پول) نادرست خواهد بود. |
پس انداز خرید نقدی
هزینه و سود خرید مستقیم یک پیکربندی خاص از پانل های خورشیدی با مصرف برق خاص.
نمایندگی JSON |
---|
{ "outOfPocketCost": { object ( |
فیلدها | |
---|---|
outOfPocketCost | هزینه اولیه قبل از مشوق های مالیاتی: مبلغی که باید از جیب پرداخت شود. در مقایسه با |
upfrontCost | هزینه اولیه پس از مشوق های مالیاتی: مبلغی است که باید در طول سال اول پرداخت شود. در مقایسه با |
rebateValue | ارزش کلیه تخفیفات مالیاتی |
savings | چه مقدار در طول عمر ذخیره می شود (یا نه). |
paybackYears | تعداد سالها تا زمان بازپرداخت ارزش منفی به این معنی است که بازپرداخت هرگز در طول مدت عمر اتفاق نمی افتد. |
FinancedPurchaseSavings
هزینه و سود استفاده از وام برای خرید پیکربندی خاصی از پانل های خورشیدی با مصرف برق خاص.
نمایندگی JSON |
---|
{ "annualLoanPayment": { object ( |
فیلدها | |
---|---|
annualLoanPayment | پرداخت وام سالانه. |
rebateValue | ارزش تمام تخفیفات مالیاتی (از جمله اعتبار مالیاتی سرمایه گذاری فدرال (ITC)). |
loanInterestRate | نرخ بهره وام های در نظر گرفته شده در این مجموعه از محاسبات. |
savings | چه مقدار در طول عمر ذخیره می شود (یا نه). |