Method: buildingInsights.findClosest

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

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

پارامترهای پُرسمان

پارامترها
location

object (LatLng)

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

enum (ImageryQuality)

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

boolean

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

enum (Experiment)

اختیاری. آزمایش‌های پیش‌از دردسترس عموم را برای فعال کردن مشخص می‌کند. درخواست‌هایی که از این فیلد استفاده می‌کنند، طبق شرایط ویژه سرویس Google Maps Platform، به‌عنوان پیشنهاد پیش‌از دردسترس عموم طبقه‌بندی می‌شوند. برای جزئیات بیشتر، شرح مراحل راه‌اندازی را ببینید.
additionalInsights[]

enum (AdditionalInsights)

اختیاری. فهرستی از additionalInsights که باید در پاسخ گنجانده شود.

متن درخواست

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

بدنه پاسخ

پیام پاسخ برای 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),
  "detectedArrays": {
    object (DetectedArrays)
  }
}
فیلدها
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)

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

object (DetectedArrays)

آرایه‌های خورشیدی شناسایی‌شده در ساختمان. این فیلد فقط درصورتی پر می‌شود که DETECTED_ARRAYS در FindClosestBuildingInsightsRequest.additional_insights درخواست گنجانده شده باشد.

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

به گستره OAuth زیر نیاز دارد:

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

AdditionalInsights

اطلاعات اضافی ساختمان مانند هندسه سقف و آرایه‌های صفحه خورشیدی که می‌تواند در BuildingInsights برگردانده شود.

شمارشی‌ها
ADDITIONAL_INSIGHTS_UNSPECIFIED مقدار پیش‌فرض. BuildingInsights پیش‌فرض برگردانده خواهد شد.
DETECTED_ARRAYS

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

اگر مشخص شده باشد، فیلد detectedArrays در پاسخ درج خواهد شد.

LatLngBox

چارگوش محصورکننده در مختصات عرض/طول جغرافیایی.

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

object (LatLng)

گوشه جنوب غربی چارگوش.
ne

object (LatLng)

گوشه شمال شرقی چارگوش.

SolarPotential

اطلاعات درباره انرژی خورشیدی بالقوه ساختمان. تعدادی از فیلدها در این بخش براساس «پانل‌ها» تعریف شده‌اند. فیلدهای 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

حداکثر تعداد ساعت‌های آفتابی دریافتی در سال، توسط هر نقطه‌ای از پشت‌بام. ساعت‌های آفتابی مقیاسی از مقدار کل تابش خورشیدی (انرژی) دریافتی در سال است. ۱ ساعت آفتابی = ۱ کیلووات‌ساعت به‌ازای هر کیلووات (که کیلووات به کیلووات ظرفیت تحت «شرایط آزمایش استاندارد» اشاره دارد).
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 میزان صرفه‌جویی حاصل از استفاده از انرژی خورشیدی را با فرض یک قبض ماهانه مشخص و یک ارائه‌دهنده برق مشخص نشان می‌دهد. این موارد به‌ترتیب صعودی مبلغ صورت‌حساب ماهانه مرتب شده‌اند. این فیلد برای ساختمان‌هایی که در مناطقی قرار دارند که Solar API اطلاعات کافی برای انجام محاسبات مالی آن‌ها ندارد خالی خواهد بود.

SizeAndSunshineStats

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

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

number

مساحت پشت‌بام یا بخش پشت‌بام، به متر مربع. این سطح پشت‌بام (با احتساب شیب) است، نه سطح ردپای زمین.
sunshineQuantiles[]

number

چندک‌های آفتابی بودن نقطه‌ای در سراسر منطقه. اگر N مقدار در اینجا وجود داشته باشد، این نشان‌دهنده (N-1)-iles است. برای مثال، اگر ۵ مقدار وجود داشته باشد، این مقادیر چارک‌ها خواهند بود (حداقل، ۲۵٪، ۵۰٪، ۷۵٪، حداکثر). مقادیر به‌صورت کیلووات‌ساعت بر کیلووات سالانه است، مثل 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

زاویه بخش پشت‌بام نسبت به صفحه نظری زمین. ‫0 = موازی با زمین، 90 = عمود بر زمین.
azimuthDegrees

number

جهت قطب‌نمایی که بخش پشت‌بام به آن اشاره می‌کند. ‫0 = شمال، 90 = شرق، 180 = جنوب. برای بخش پشت‌بام «تخت» (pitchDegrees بسیار نزدیک به ۰)، سمت به‌خوبی تعریف نشده است، بنابراین برای سازگاری، آن را به‌طور دلخواه ۰ (شمال) تعریف می‌کنیم.
planeHeightAtCenterMeters

number

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

SolarPanel

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 که با بخش پشت‌بامی که این پانل روی آن قرار گرفته است مطابقت دارد.

SolarPanelOrientation

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

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

SolarPanelConfig

SolarPanelConfig یک چیدمان خاص از صفحه‌های خورشیدی روی سقف را توصیف می‌کند.

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

integer

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

number

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

object (RoofSegmentSummary)

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

RoofSegmentSummary

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

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

integer

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

number

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

number

زاویه بخش پشت‌بام نسبت به صفحه نظری زمین. ‫0 = موازی با زمین، 90 = عمود بر زمین.
azimuthDegrees

number

جهت قطب‌نمایی که بخش پشت‌بام به آن اشاره می‌کند. ‫0 = شمال، 90 = شرق، 180 = جنوب. برای بخش پشت‌بام «تخت» (pitchDegrees بسیار نزدیک به ۰)، سمت به‌خوبی تعریف نشده است، بنابراین برای سازگاری، آن را به‌طور دلخواه ۰ (شمال) تعریف می‌کنیم.
segmentIndex

integer

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

FinancialAnalysis

تجزیه‌وتحلیل هزینه و مزایای چیدمان خورشیدی بهینه برای اندازه خاصی از صورت‌حساب برق.

نمایش 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

تعداد واحدهای نانو (۱۰^-۹) مبلغ. مقدار باید بین ۹۹۹٬۹۹۹٬۹۹۹- و ۹۹۹٬۹۹۹٬۹۹۹+ باشد و می‌تواند این دو عدد را نیز دربر بگیرد. اگر units مثبت باشد، nanos باید مثبت یا صفر باشد. اگر units صفر باشد، nanos می‌تواند مثبت، صفر، یا منفی باشد. اگر units منفی باشد، nanos باید منفی یا صفر باشد. برای مثال، ۱٫۷۵- دلار به‌صورت units=-۱ و nanos=-۷۵۰٬۰۰۰٬۰۰۰ نشان داده می‌شود.

FinancialDetails

جزئیات تحلیل مالی. برخی‌از این جزئیات قبلاً در سطوح بالاتر ذخیره شده‌اند (مثلاً هزینه شخصی). مبالغ کل پول مربوط به دوره مادام‌العمر است که با فیلد 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

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

object (Money)

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

object (Money)

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

object (Money)

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

object (Money)

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

object (Money)

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

object (Money)

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

boolean

اینکه آیا سنجش خالص مجاز است یا نه.
solarPercentage

number

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

number

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

LeasingSavings

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

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

boolean

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

boolean

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

object (Money)

هزینه تخمینی کرایه سالانه.
savings

object (SavingsOverTime)

چه مقدار درطول دوره عمر ذخیره می‌شود (یا نمی‌شود).

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

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

CashPurchaseSavings

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

نمایش 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

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

FinancedPurchaseSavings

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

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

object (Money)

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

object (Money)

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

number

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

object (SavingsOverTime)

چه مقدار درطول دوره عمر ذخیره می‌شود (یا نمی‌شود).

DetectedArrays

اطلاعات درباره آرایه‌های خورشیدی شناسایی‌شده در ساختمان.

نمایش JSON 
{
  "detectionStatus": enum (DetectionStatus),
  "arrays": [
    {
      object (SolarArray)
    }
  ],
  "latestCaptureDate": {
    object (Date)
  }
}
فیلدها
detectionStatus

enum (DetectionStatus)

وضعیت تشخیص آرایه‌های خورشیدی را برای این ساختمان نشان می‌دهد.
arrays[]

object (SolarArray)

فهرستی از آرایه‌های خورشیدی شناسایی‌شده در ساختمان.
latestCaptureDate

object (Date)

تاریخی که نشان می‌دهد آخرین داده‌های آرایه خورشیدی چه زمانی ثبت شده است.

DetectionStatus

وضعیت تشخیص آرایه‌های خورشیدی را برای این ساختمان نشان می‌دهد.

شمارشی‌ها
DETECTION_STATUS_UNSPECIFIED وضعیت نامشخص.
DETECTION_STATUS_DATA_UNAVAILABLE داده‌های آرایه خورشیدی شناسایی‌شده برای این ساختمان دردسترس نیست.
DETECTION_STATUS_ARRAYS_DETECTED حداقل یک آرایه خورشیدی برای این ساختمان شناسایی شده است.
DETECTION_STATUS_NO_ARRAYS_DETECTED هیچ آرایه خورشیدی‌ای برای این ساختمان شناسایی نشد.

SolarArray

جزئیات یک آرایه خورشیدی شناسایی‌شده.

نمایش JSON 
{
  "polygonGeojson": {
    object
  }
}
فیلدها
polygonGeojson

object (Struct format)

نمایش GeoJSON از منطقه ساختمان که پانل‌های خورشیدی در آن شناسایی شده است.

داده‌های GeoJSON باید در قالب RFC 7946 باشد و یک «چندضلعی» را برای یک منطقه پیوسته نشان دهد.

وقتی چندضلعی دارای حفره باشد، با چند حلقه نشان داده می‌شود.

مثال:

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }