Method: buildingInsights.findClosest

لتحديد موقع أقرب مبنى إلى نقطة طلب بحث. تعرض خطأ مع الرمز NOT_FOUND إذا لم تكن هناك مبانٍ في نطاق 50 مترًا تقريبًا من نقطة طلب البحث.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات طلب البحث

المَعلمات
location

object (LatLng)

مطلوبة. يشير ذلك المصطلح إلى خط الطول وخط العرض الذي تبحث منه واجهة برمجة التطبيقات عن أقرب مبنى معروف.

requiredQuality

enum (ImageryQuality)

اختياريّ. الحدّ الأدنى لمستوى الجودة المسموح به في النتائج. لن يتم عرض أي نتائج ذات جودة أقل. عدم تحديد هذا الاسم يعادل قصرًا على الجودة العالية فقط.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الرد لـ "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

تمثّل هذه السمة اسم المورد للمبنى بالتنسيق building/<place ID>.

center

object (LatLng)

نقطة بالقرب من وسط المبنى.

boundingBox

object (LatLngBox)

المربع المحيط بالمبنى.

imageryDate

object (Date)

تاريخ الحصول على الصور الأساسية هذا تقريبي.

imageryProcessedDate

object (Date)

عند اكتمال معالجة هذه الصور.

postalCode

string

الرمز البريدي (على سبيل المثال، الرمز البريدي في الولايات المتحدة) يحتوي على هذا المبنى.

administrativeArea

string

المنطقة الإدارية 1 (على سبيل المثال، في الولايات المتحدة، الولاية) التي تضم هذا المبنى على سبيل المثال، في الولايات المتحدة، قد يكون الاختصار "MA" أو "CA".

statisticalArea

string

المنطقة الإحصائية (مثل منطقة تعداد الولايات المتحدة) يقع فيها هذا المبنى.

regionCode

string

رمز المنطقة للبلد (أو المنطقة) التي يقع فيها هذا المبنى.

solarPotential

object (SolarPotential)

إمكانات توليد الطاقة الشمسية للمبنى.

imageryQuality

enum (ImageryQuality)

جودة الصور المستخدمة في احتساب بيانات هذا المبنى.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

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

الحد الأقصى لعدد ساعات أشعة الشمس المستلَمة سنويًا، عند أي نقطة على السطح ساعات أشعة الشمس هي مقياس لإجمالي كمية العزل (الطاقة) الواردة سنويًا. 1 ساعة مشمسة = 1 كيلوواط في الساعة لكل كيلوواط (حيث تشير "كيلوواط" إلى السعة بموجب "شروط الاختبار العادية").

carbonOffsetFactorKgPerMwh

number

كمية ثاني أكسيد الكربون المكافئة التي يتم إنتاجها لكل ميغاواط من الساعة من كهرباء الشبكة. هذا قياس لكثافة الكربون من الشبكة الكهربائية الناتجة عن الكهرباء التي يتم توليدها من الطاقة الشمسية.

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. لا يتم ملء هذا الحقل إلا إذا كان من الممكن احتواء 4 لوحات على الأقل على السطح.

financialAnalyses[]

object (FinancialAnalysis)

توفّر بطاقة "FinancialAnalysis" المبالغ التي يمكن توفيرها من استخدام الطاقة الشمسية بافتراض تلقّي فاتورة شهرية محدّدة ومقدّم خدمة كهرباء معيّن. إنها مرتبة ترتيبًا متزايدًا لمبلغ الفاتورة الشهرية. سيكون هذا الحقل فارغًا للمباني في المناطق التي لا تحتوي واجهة برمجة التطبيقات Solar API على معلومات كافية لها لإجراء عمليات حسابية مالية.

SizeAndSunshineStats

أجزاء الحجم والتعرُّض للسقف أو جزء من السقف

تمثيل JSON
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
الحقول
areaMeters2

number

مساحة السطح أو السقف بالمتر المربّع هذه هي منطقة السطح (مع مراعاة الإمالة)، وليس منطقة البصمة الأرضية.

sunshineQuantiles[]

number

الكميات من التلوث المتوسطات في جميع أنحاء المنطقة. إذا كانت هناك قيم N هنا، فإن هذا يمثل (N-1). على سبيل المثال، إذا كانت هناك 5 قيم، فستكون هي الأرباع (الحد الأدنى، 25%، 50%، 75%، الحد الأقصى). القيم السنوية بالكيلوواط ساعة/كيلوواط مثل 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 الذي يكون قريبًا جدًا من 0)، لم يتم تحديد قيمة السمت بشكل جيد، لذا من أجل الاتساق، نحدِّدها عشوائيًا لتكون 0 (شمال).

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 الذي يتوافق مع الجزء من السطح الذي تم وضع هذه اللوحة عليه.

SolarPanelOrientation

اتجاه اللوحة الشمسية. يجب تفسير ذلك بالنسبة إلى سمت جزء السطح الذي يتم وضع اللوحة عليه.

عمليات التعداد
SOLAR_PANEL_ORIENTATION_UNSPECIFIED لا يُعرف اتجاه اللوحة.
LANDSCAPE تتميز لوحة LANDSCAPE بحافة طويلة بشكل عمودي مع اتجاه سمت جزء السطح الذي يتم وضعها عليه.
PORTRAIT تتميز لوحة PORTRAIT بحافة طويلة متوازية مع اتجاه سمت جزء السطح الذي يتم وضعها عليه.

SolarPanelConfig

تصف تقنية Solar PanelConfig وضعًا معينًا لألواح الطاقة الشمسية على السطح.

تمثيل JSON
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
الحقول
panelsCount

integer

إجمالي عدد اللوحات يُرجى العلم أنّ هذا الإجراء مكرّر في (مجموع) الحقول المقابلة في roofSegmentSummaries.

yearlyEnergyDcKwh

number

مقدار الطاقة من ضوء الشمس الذي يلتقطه هذا التخطيط على مدار العام، بوحدة الطاقة الكهربائية بالكيلوواط ساعة، بافتراض أنّ اللوحات الموضحة أعلاه.

roofSegmentSummaries[]

object (RoofSegmentSummary)

معلومات حول إنتاج كل جزء من السطح يحتوي على لوحة واحدة على الأقل في هذا التصميم. تصف السمة roofSegmentSummaries[i] الجزء i من السطح، بما في ذلك حجمه ودرجة إنتاجه واتجاهه المتوقّع.

RoofSegmentSummary

معلومات حول جزء من السطح في المبنى، مع وضع بعض الألواح عليه.

تمثيل JSON
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
الحقول
panelsCount

integer

إجمالي عدد اللوحات في هذا الجزء.

yearlyEnergyDcKwh

number

مقدار طاقة ضوء الشمس الذي يلتقطه هذا الجزء من التخطيط على مدار عام، بوحدة الطاقة الكهربائية بالكيلوواط في الساعة، بافتراض اللوحات الموضحة أعلاه.

pitchDegrees

number

زاوية جزء السطح بالنسبة إلى مستوى الأرض النظري. 0 = موازٍ للأرض، 90 = عمودي للأرض.

azimuthDegrees

number

اتجاه البوصلة الذي يشير إليه جزء السطح. 0 = الشمال، 90 = الشرق، 180 = الجنوب. بالنسبة إلى جزء السطح "المسطح" (pitchDegrees الذي يكون قريبًا جدًا من 0)، لم يتم تحديد قيمة السمت بشكل جيد، لذا من أجل الاتساق، نحدِّدها عشوائيًا لتكون 0 (شمال).

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

ما إذا كان هذا هو حجم الفاتورة المحدد ليكون الفاتورة التلقائية للمنطقة التي يقع فيها هذا المبنى. يجب ضبط defaultBill واحد لـ FinancialAnalysis في BuildingSolarPotential.

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.

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

النسبة المئوية (0-100) من طاقة المستخدم التي توفّرها الطاقة الشمسية صالح للسنة الأولى ولكنه صحيح تقريبًا للسنوات المستقبلية.

percentageExportedToGrid

number

النسبة المئوية (0-100) من إنتاج الكهرباء من الطاقة الشمسية التي افترضناها أنه تم تصديرها إلى الشبكة، بناءً على الربع الأول من الإنتاج. يؤثر هذا في العمليات الحسابية إذا كان صافي القياس غير مسموح به.

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)

باستخدام معدل الخصم الافتراضي، ما القيمة الحالية للمدخرات التراكمية لمدة 20 عامًا؟

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)

المبلغ الذي يتم توفيره (أو لا يتم توفيره) على مدار الفترة منذ الإنشاء.