Method: buildingInsights.findClosest

ساختمانی را پیدا می‌کند که مرکز آن به نقطه پرس‌وجو نزدیک‌تر است. اگر هیچ ساختمانی در فاصله تقریباً ۵۰ متری از نقطه پرس‌وجو وجود نداشته باشد، خطایی با کد NOT_FOUND برمی‌گرداند.

درخواست HTTP

GET https://solar.googleapis.com/v1/buildingInsights:findClosest

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای پرس و جو

پارامترها
location

object ( LatLng )

الزامی. طول و عرض جغرافیایی که API از آنجا به دنبال نزدیکترین ساختمان شناخته شده می‌گردد.

requiredQuality

enum ( ImageryQuality )

اختیاری. حداقل سطح کیفیت مجاز در نتایج. هیچ نتیجه‌ای با کیفیت پایین‌تر از این بازگردانده نخواهد شد. عدم مشخص کردن این مورد معادل محدود کردن فقط به کیفیت بالا است.

exactQualityRequired

boolean

اختیاری. اینکه آیا کیفیت دقیق تصویر مورد نیاز باشد یا خیر. اگر روی false تنظیم شود، فیلد requiredQuality به عنوان حداقل کیفیت مورد نیاز تفسیر می‌شود، به طوری که اگر requiredQuality روی MEDIUM تنظیم شود، ممکن است تصاویر با کیفیت بالا بازگردانده شوند. اگر روی true تنظیم شود، requiredQuality به عنوان کیفیت دقیق مورد نیاز تفسیر می‌شود و اگر requiredQuality روی MEDIUM تنظیم شود، فقط تصاویر با کیفیت MEDIUM ​​بازگردانده می‌شوند.

experiments[]

enum ( Experiment )

اختیاری. ویژگی‌های پیش از GA را برای فعال کردن مشخص می‌کند.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پیام پاسخ برای Solar.FindClosestBuildingInsights . اطلاعاتی در مورد مکان، ابعاد و پتانسیل خورشیدی یک ساختمان.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON
{
  "name": string,
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "postalCode": string,
  "administrativeArea": string,
  "statisticalArea": string,
  "regionCode": string,
  "solarPotential": {
    object (SolarPotential)
  },
  "imageryQuality": enum (ImageryQuality)
}
فیلدها
name

string

نام منبع برای ساختمان، با فرمت buildings/{place_id} .

center

object ( LatLng )

نقطه‌ای نزدیک به مرکز ساختمان.

boundingBox

object ( LatLngBox )

جعبه‌ی محصورکننده‌ی ساختمان.

imageryDate

object ( Date )

تاریخ دریافت تصاویر اصلی. این تقریبی است.

imageryProcessedDate

object ( Date )

وقتی پردازش روی این تصویر تکمیل شد.

postalCode

string

کد پستی (مثلاً کد پستی ایالات متحده) که این ساختمان در آن قرار دارد.

administrativeArea

string

منطقه اداری ۱ (مثلاً در ایالات متحده، ایالت) که شامل این ساختمان است. برای مثال، در ایالات متحده، مخفف آن ممکن است «MA» یا «CA» باشد.

statisticalArea

string

منطقه آماری (مثلاً، حوزه سرشماری ایالات متحده) که این ساختمان در آن قرار دارد.

regionCode

string

کد منطقه برای کشور (یا منطقه‌ای) که این ساختمان در آن قرار دارد.

solarPotential

object ( SolarPotential )

پتانسیل خورشیدی ساختمان.

imageryQuality

enum ( ImageryQuality )

کیفیت تصاویر استفاده شده برای محاسبه داده‌های این ساختمان.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

جعبه لات

یک جعبه مرزی در مختصات عرض/طول.

نمایش JSON
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
فیلدها
sw

object ( LatLng )

گوشه جنوب غربی جعبه.

ne

object ( LatLng )

گوشه شمال شرقی جعبه.

پتانسیل خورشیدی

اطلاعاتی در مورد پتانسیل خورشیدی یک ساختمان. تعدادی از فیلدها در این مورد بر اساس "پنل‌ها" تعریف شده‌اند. فیلدهای panelCapacityWatts ، panelHeightMeters و panelWidthMeters پارامترهای مدل پنل مورد استفاده در این محاسبات را توصیف می‌کنند.

نمایش JSON
{
  "maxArrayPanelsCount": integer,
  "panelCapacityWatts": number,
  "panelHeightMeters": number,
  "panelWidthMeters": number,
  "panelLifetimeYears": integer,
  "maxArrayAreaMeters2": number,
  "maxSunshineHoursPerYear": number,
  "carbonOffsetFactorKgPerMwh": number,
  "wholeRoofStats": {
    object (SizeAndSunshineStats)
  },
  "buildingStats": {
    object (SizeAndSunshineStats)
  },
  "roofSegmentStats": [
    {
      object (RoofSegmentSizeAndSunshineStats)
    }
  ],
  "solarPanels": [
    {
      object (SolarPanel)
    }
  ],
  "solarPanelConfigs": [
    {
      object (SolarPanelConfig)
    }
  ],
  "financialAnalyses": [
    {
      object (FinancialAnalysis)
    }
  ]
}
فیلدها
maxArrayPanelsCount

integer

اندازه حداکثر آرایه - یعنی حداکثر تعداد پنل‌هایی که می‌توانند روی سقف قرار گیرند.

panelCapacityWatts

number

ظرفیت پنل مورد استفاده در محاسبات، بر حسب وات.

panelHeightMeters

number

ارتفاع پنل مورد استفاده در محاسبات، بر حسب متر در حالت عمودی.

panelWidthMeters

number

عرض پنل مورد استفاده در محاسبات، بر حسب متر در حالت عمودی.

panelLifetimeYears

integer

طول عمر مورد انتظار پنل‌های خورشیدی (برحسب سال). این عدد در محاسبات مالی استفاده می‌شود.

maxArrayAreaMeters2

number

اندازه، بر حسب متر مربع، حداکثر آرایه.

maxSunshineHoursPerYear

number

حداکثر تعداد ساعات آفتابی دریافتی در هر سال، توسط هر نقطه روی پشت بام. ساعات آفتابی معیاری از کل میزان تابش (انرژی) دریافتی در هر سال است. 1 ساعت آفتابی = 1 کیلووات ساعت به ازای هر کیلووات (که در آن کیلووات به کیلووات ظرفیت تحت شرایط آزمایش استاندارد اشاره دارد).

carbonOffsetFactorKgPerMwh

number

مقدار معادل CO2 تولید شده به ازای هر مگاوات ساعت برق شبکه. این معیاری از شدت کربن برق شبکه است که توسط برق خورشیدی جایگزین شده است.

wholeRoofStats

object ( SizeAndSunshineStats )

اندازه کل و مقادیر نور خورشید برای بخشی از سقف که به بخشی از سقف اختصاص داده شده است. برخلاف نامش، این ممکن است شامل کل ساختمان نباشد. به buildingStats مراجعه کنید.

buildingStats

object ( SizeAndSunshineStats )

مقادیر اندازه و نور خورشید برای کل ساختمان، شامل بخش‌هایی از سقف که به برخی از بخش‌های سقف اختصاص داده نشده‌اند. از آنجا که جهت‌گیری این بخش‌ها به خوبی مشخص نشده است، تخمین مساحت سقف غیرقابل اعتماد است، اما تخمین مساحت زمین قابل اعتماد است. ممکن است بتوان با مقیاس‌بندی مساحت سقف از wholeRoofStats بر اساس نسبت مساحت زمین buildingStats و wholeRoofStats ، مساحت کل سقف ساختمان را که قابل اعتمادتر است، به دست آورد.

roofSegmentStats[]

object ( RoofSegmentSizeAndSunshineStats )

اندازه و کمیت‌های نور خورشید برای هر بخش از سقف.

solarPanels[]

object ( SolarPanel )

هر SolarPanel یک پنل خورشیدی واحد را توصیف می‌کند. آن‌ها به ترتیبی که الگوریتم چیدمان پنل آن را قرار داده است، فهرست شده‌اند. این معمولاً، البته نه همیشه، به ترتیب نزولی تولید انرژی سالانه است.

solarPanelConfigs[]

object ( SolarPanelConfig )

هر SolarPanelConfig چیدمان متفاوتی از پنل‌های خورشیدی روی پشت بام را توصیف می‌کند. آنها به ترتیب افزایش تعداد پنل‌ها هستند. SolarPanelConfig با panelsCount =N بر اساس N پنل اول در لیست solarPanels محاسبه می‌شود. این فیلد فقط در صورتی پر می‌شود که حداقل ۴ پنل بتوانند روی یک سقف قرار بگیرند.

financialAnalyses[]

object ( FinancialAnalysis )

یک FinancialAnalysis میزان صرفه‌جویی حاصل از استفاده از انرژی خورشیدی را با فرض یک صورتحساب ماهانه مشخص و یک تأمین‌کننده برق مشخص، ارائه می‌دهد. این صرفه‌جویی‌ها به ترتیب افزایش مبلغ صورتحساب ماهانه هستند. این فیلد برای ساختمان‌هایی که در مناطقی قرار دارند که API خورشیدی اطلاعات کافی برای انجام محاسبات مالی آنها را ندارد، خالی خواهد بود.

SizeAndSunshineStats

کمیت‌های اندازه و میزان آفتاب‌گیری یک سقف یا بخشی از یک سقف.

نمایش JSON
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
فیلدها
areaMeters2

number

مساحت سقف یا قطعه سقف، بر حسب متر مربع. این مساحت سقف (با احتساب شیب) است، نه مساحت سطح زمین.

sunshineQuantiles[]

number

کوانتایل‌های میزان تابش نقطه‌ای خورشید در سراسر منطقه. اگر N مقدار در اینجا وجود داشته باشد، این نشان دهنده (N-1)-iles است. برای مثال، اگر 5 مقدار وجود داشته باشد، آنها کوارتیل‌ها (min، 25%، 50%، 75%، max) خواهند بود. مقادیر بر حسب kWh/kW سالانه هستند، مانند maxSunshineHoursPerYear .

groundAreaMeters2

number

مساحت سطح زمین تحت پوشش سقف یا قطعه سقف، بر حسب متر مربع.

RoofSegmentSizeAndSunshineStats

اطلاعات مربوط به اندازه و مقادیر آفتابی بودن یک بخش از سقف.

نمایش JSON
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
فیلدها
stats

object ( SizeAndSunshineStats )

اندازه کل و مقادیر تابش نور خورشید برای بخش سقف.

center

object ( LatLng )

نقطه‌ای نزدیک به مرکز بخش سقف.

boundingBox

object ( LatLngBox )

جعبه‌ی محصورکننده‌ی قطعه‌ی سقف.

pitchDegrees

number

زاویه قطعه سقف نسبت به صفحه زمین فرضی. ۰ = موازی با زمین، ۹۰ = عمود بر زمین.

azimuthDegrees

number

جهت قطب‌نمایی که قطعه سقف به آن اشاره می‌کند. ۰ = شمال، ۹۰ = شرق، ۱۸۰ = جنوب. برای یک قطعه سقف "مسطح" ( pitchDegrees بسیار نزدیک به ۰)، آزیموت به خوبی تعریف نشده است، بنابراین برای سازگاری، آن را به طور دلخواه ۰ (شمال) تعریف می‌کنیم.

planeHeightAtCenterMeters

number

ارتفاع صفحه قطعه سقف، بر حسب متر از سطح دریا، در نقطه‌ای که با center مشخص شده است. این پارامتر به همراه شیب، آزیموت و موقعیت مرکز، صفحه قطعه سقف را به طور کامل تعریف می‌کند.

پنل خورشیدی

SolarPanel موقعیت، جهت‌گیری و تولید یک پنل خورشیدی واحد را توصیف می‌کند. برای اطلاعات در مورد پارامترهای پنل، به فیلدهای panelHeightMeters ، panelWidthMeters و panelCapacityWatts در SolarPotential مراجعه کنید.

نمایش JSON
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
فیلدها
center

object ( LatLng )

مرکز پنل.

orientation

enum ( SolarPanelOrientation )

جهت گیری پنل.

yearlyEnergyDcKwh

number

این طرح در طول یک سال چه مقدار انرژی نور خورشید را جذب می‌کند، بر حسب کیلووات ساعت DC.

segmentIndex

integer

ایندکس در roofSegmentStats مربوط به RoofSegmentSizeAndSunshineStats که مربوط به قطعه سقفی است که این پنل روی آن قرار گرفته است.

جهت پنل خورشیدی

جهت قرارگیری پنل خورشیدی. این جهت باید نسبت به آزیموت قسمتی از سقف که پنل روی آن قرار گرفته است، تفسیر شود.

انوم‌ها
SOLAR_PANEL_ORIENTATION_UNSPECIFIED جهت پنل مشخص نیست.
LANDSCAPE لبه بلند یک پنل LANDSCAPE عمود بر جهت آزیموت قسمتی از سقف است که روی آن قرار گرفته است.
PORTRAIT لبه بلند پنل PORTRAIT موازی با جهت آزیموت قسمتی از سقف است که روی آن قرار گرفته است.

پیکربندی پنل خورشیدی

SolarPanelConfig نحوه قرارگیری خاص پنل‌های خورشیدی روی پشت بام را توصیف می‌کند.

نمایش JSON
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
فیلدها
panelsCount

integer

تعداد کل پنل‌ها. توجه داشته باشید که این تعداد، افزون بر (مجموع) فیلدهای مربوطه در roofSegmentSummaries است.

yearlyEnergyDcKwh

number

این طرح با فرض پنل‌های توضیح داده شده در بالا، چه مقدار انرژی نور خورشید را در طول یک سال، بر حسب کیلووات ساعت DC، جذب می‌کند.

roofSegmentSummaries[]

object ( RoofSegmentSummary )

اطلاعات مربوط به تولید هر بخش سقف که حداقل یک پنل در این طرح دارد. roofSegmentSummaries[i] بخش سقف i ام را شرح می‌دهد، از جمله اندازه، تولید مورد انتظار و جهت‌گیری آن.

خلاصه بخش سقف

اطلاعات مربوط به یک بخش از سقف ساختمان، به همراه تعدادی پنل که روی آن قرار گرفته‌اند.

نمایش JSON
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
فیلدها
panelsCount

integer

تعداد کل پنل‌های موجود در این بخش.

yearlyEnergyDcKwh

number

با فرض پنل‌های توضیح داده شده در بالا، این بخش از طرح در طول یک سال چه مقدار انرژی نور خورشید را بر حسب کیلووات ساعت DC جذب می‌کند.

pitchDegrees

number

زاویه قطعه سقف نسبت به صفحه زمین فرضی. ۰ = موازی با زمین، ۹۰ = عمود بر زمین.

azimuthDegrees

number

جهت قطب‌نمایی که قطعه سقف به آن اشاره می‌کند. ۰ = شمال، ۹۰ = شرق، ۱۸۰ = جنوب. برای یک قطعه سقف "مسطح" ( pitchDegrees بسیار نزدیک به ۰)، آزیموت به خوبی تعریف نشده است، بنابراین برای سازگاری، آن را به طور دلخواه ۰ (شمال) تعریف می‌کنیم.

segmentIndex

integer

ایندکس در roofSegmentStats مربوط به RoofSegmentSizeAndSunshineStats .

تحلیل مالی

تحلیل هزینه و مزایای طرح بهینه خورشیدی برای یک اندازه قبض برق خاص.

نمایش JSON
{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}
فیلدها
monthlyBill

object ( Money )

قبض برق ماهانه‌ای که این تحلیل در نظر می‌گیرد.

defaultBill

boolean

آیا این اندازه صورتحساب، به عنوان صورتحساب پیش‌فرض برای منطقه‌ای که این ساختمان در آن قرار دارد انتخاب شده است یا خیر. دقیقاً یک FinancialAnalysis در BuildingSolarPotential باید defaultBill داشته باشد.

averageKwhPerMonth

number

میزان مصرف برق خانه در یک ماه به طور متوسط، بر اساس مبلغ قبض و نرخ برق محلی.

financialDetails

object ( FinancialDetails )

اطلاعات مالی که صرف نظر از روش تأمین مالی مورد استفاده، کاربرد دارد.

leasingSavings

object ( LeasingSavings )

هزینه و مزایای اجاره پنل‌های خورشیدی

cashPurchaseSavings

object ( CashPurchaseSavings )

هزینه و سود خرید پنل‌های خورشیدی با پول نقد.

financedPurchaseSavings

object ( FinancedPurchaseSavings )

هزینه و سود خرید پنل‌های خورشیدی با تأمین مالی خرید.

panelConfigIndex

integer

فهرست در solarPanelConfigs از طرح بهینه خورشیدی برای این اندازه صورتحساب. این می‌تواند -1 باشد که نشان می‌دهد هیچ طرحی وجود ندارد. در این حالت، زیرپیام‌های باقی مانده حذف خواهند شد.

پول

نشان دهنده مقدار پول به همراه نوع ارز آن است.

نمایش JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
فیلدها
currencyCode

string

کد ارزی سه حرفی که در استاندارد ISO 4217 تعریف شده است.

units

string ( int64 format)

کل واحدهای مبلغ. برای مثال اگر currencyCode برابر با "USD" باشد، هر واحد برابر با یک دلار آمریکا است.

nanos

integer

تعداد نانو (10^-9) واحد از مبلغ. مقدار باید بین -999,999,999 و +999,999,999 باشد. اگر units مثبت باشد، nanos باید مثبت یا صفر باشد. اگر units صفر باشد، nanos می‌تواند مثبت، صفر یا منفی باشد. اگر units منفی باشد، nanos باید منفی یا صفر باشد. به عنوان مثال، -1.75 دلار به صورت units = -1 و nanos = -750,000,000 نمایش داده می‌شود.

جزئیات مالی

جزئیات یک تحلیل مالی. برخی از این جزئیات از قبل در سطوح بالاتر ذخیره شده‌اند (مثلاً هزینه از جیب). کل مبالغ در طول یک دوره عمر که توسط فیلد panelLifetimeYears در SolarPotential تعریف شده است، محاسبه می‌شوند. توجه: هزینه از جیب خرید پنل‌ها در فیلد outOfPocketCost در CashPurchaseSavings ارائه شده است.

نمایش JSON
{
  "initialAcKwhPerYear": number,
  "remainingLifetimeUtilityBill": {
    object (Money)
  },
  "federalIncentive": {
    object (Money)
  },
  "stateIncentive": {
    object (Money)
  },
  "utilityIncentive": {
    object (Money)
  },
  "lifetimeSrecTotal": {
    object (Money)
  },
  "costOfElectricityWithoutSolar": {
    object (Money)
  },
  "netMeteringAllowed": boolean,
  "solarPercentage": number,
  "percentageExportedToGrid": number
}
فیلدها
initialAcKwhPerYear

number

فکر می‌کنیم پنل‌های خورشیدی در سال اول خود چند کیلووات ساعت برق متناوب تولید خواهند کرد.

remainingLifetimeUtilityBill

object ( Money )

قبض برق برای برقی که توسط پنل‌های خورشیدی تولید نمی‌شود، برای طول عمر پنل‌ها.

federalIncentive

object ( Money )

میزان بودجه‌ای که از محل مشوق‌های فدرال در دسترس است؛ این مبلغ در صورتی اعمال می‌شود که کاربر (با وام یا بدون وام) پنل‌ها را خریداری کند.

stateIncentive

object ( Money )

میزان بودجه‌ای که از محل مشوق‌های دولتی در دسترس است؛ این مبلغ در صورتی اعمال می‌شود که کاربر (با وام یا بدون وام) پنل‌ها را خریداری کند.

utilityIncentive

object ( Money )

میزان پولی که از محل مشوق‌های رفاهی در دسترس است؛ این موضوع در صورتی اعمال می‌شود که کاربر (با وام یا بدون وام) پنل‌ها را خریداری کند.

lifetimeSrecTotal

object ( Money )

میزان پولی که کاربر در طول عمر پنل از محل اعتبارات انرژی تجدیدپذیر خورشیدی دریافت خواهد کرد؛ این مبلغ در صورتی اعمال می‌شود که کاربر پنل‌ها را (با وام یا بدون وام) خریداری کند.

costOfElectricityWithoutSolar

object ( Money )

کل هزینه برقی که کاربر در طول عمر خود در صورت عدم نصب پنل خورشیدی باید پرداخت می‌کرد.

netMeteringAllowed

boolean

آیا اندازه‌گیری خالص مجاز است؟

solarPercentage

number

درصد (۰-۱۰۰) از برق مصرفی کاربر که توسط انرژی خورشیدی تأمین می‌شود. برای سال اول معتبر است اما تقریباً برای سال‌های آینده صحیح است.

percentageExportedToGrid

number

درصد (0-100) تولید برق خورشیدی که ما فرض کردیم به شبکه برق صادر می‌شود، بر اساس سه ماهه اول تولید. اگر اندازه‌گیری خالص مجاز نباشد، این موضوع بر محاسبات تأثیر می‌گذارد.

پس‌اندازهای لیزینگ

هزینه و سود اجاره پیکربندی خاصی از پنل‌های خورشیدی با مصرف برق خاص.

نمایش JSON
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
فیلدها
leasesAllowed

boolean

آیا اجاره نامه در این حوزه قضایی مجاز است (در برخی ایالت ها اجاره نامه مجاز نیست). اگر این فیلد نادرست باشد، احتمالاً باید مقادیر این پیام نادیده گرفته شوند.

leasesSupported

boolean

اینکه آیا اجاره‌ها در این حوزه قضایی توسط موتور محاسبات مالی پشتیبانی می‌شوند یا خیر. اگر این فیلد نادرست باشد، احتمالاً باید مقادیر این پیام نادیده گرفته شوند. این مستقل از leasesAllowed است: در برخی مناطق، اجاره‌ها مجاز هستند، اما تحت شرایطی که توسط مدل‌های مالی مدیریت نمی‌شوند.

annualLeasingCost

object ( Money )

هزینه تخمینی اجاره سالانه

savings

object ( SavingsOverTime )

چه مقدار در طول عمر پس‌انداز می‌شود (یا نمی‌شود).

پس‌انداز در طول زمان

اطلاعات مالی که بین روش‌های مختلف تأمین مالی به اشتراک گذاشته می‌شود.

نمایش JSON
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
فیلدها
savingsYear1

object ( Money )

صرفه‌جویی در سال اول پس از نصب پنل.

savingsYear20

object ( Money )

صرفه‌جویی در بیست سال اول پس از نصب پنل.

presentValueOfSavingsYear20

object ( Money )

با استفاده از نرخ تنزیل فرضی، ارزش فعلی کل پس‌انداز ۲۰ ساله چقدر است؟

savingsLifetime

object ( Money )

صرفه‌جویی در کل طول عمر پنل.

presentValueOfSavingsLifetime

object ( Money )

با استفاده از نرخ تنزیل فرضی، ارزش فعلی کل پس‌اندازهای مادام‌العمر چقدر است؟

financiallyViable

boolean

نشان می‌دهد که آیا این سناریو از نظر مالی قابل اجرا است یا خیر. برای سناریوهایی با قابلیت اجرا مالی ضعیف (مثلاً ضرر مالی) نادرست خواهد بود.

خرید نقدیپس‌انداز

هزینه و سود خرید قطعی یک پیکربندی خاص از پنل‌های خورشیدی با مصرف برق خاص.

نمایش JSON
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
فیلدها
outOfPocketCost

object ( Money )

هزینه اولیه قبل از مشوق‌های مالیاتی: مبلغی که باید از جیب پرداخت شود. در مقابل upfrontCost ، که پس از مشوق‌های مالیاتی است.

upfrontCost

object ( Money )

هزینه اولیه پس از مشوق‌های مالیاتی: مبلغی است که باید در طول سال اول پرداخت شود. در مقابل، outOfPocketCost ، قبل از مشوق‌های مالیاتی است.

rebateValue

object ( Money )

ارزش تمام تخفیف‌های مالیاتی.

savings

object ( SavingsOverTime )

چه مقدار در طول عمر پس‌انداز می‌شود (یا نمی‌شود).

paybackYears

number

تعداد سال‌هایی که تا زمان بازگشت سرمایه باقی مانده است. مقدار منفی به این معنی است که بازگشت سرمایه هرگز در طول دوره عمر رخ نمی‌دهد.

خرید تأمین مالیپس‌انداز

هزینه و فایده استفاده از وام برای خرید پیکربندی خاصی از پنل‌های خورشیدی با مصرف برق خاص.

نمایش JSON
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
فیلدها
annualLoanPayment

object ( Money )

پرداخت وام سالانه.

rebateValue

object ( Money )

ارزش تمام تخفیف‌های مالیاتی (شامل اعتبار مالیاتی سرمایه‌گذاری فدرال (ITC)).

loanInterestRate

number

نرخ بهره وام‌های فرض شده در این مجموعه محاسبات.

savings

object ( SavingsOverTime )

چه مقدار در طول عمر پس‌انداز می‌شود (یا نمی‌شود).