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

اسم المرجع للمبنى بالتنسيق buildings/{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

الحد الأقصى لعدد ساعات سطوع الشمس التي يتم تلقّيها سنويًا في أي نقطة على السطح ساعات سطوع الشمس هي مقياس لإجمالي مقدار الإشعاع الشمسي (الطاقة) الذي يتم تلقّيه سنويًا. ساعة شمسية واحدة = كيلوواط ساعة واحدة لكل كيلوواط (حيث يشير كيلوواط إلى سعة كيلوواط في ظل ظروف الاختبار العادية).
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

تصف سمة SolarPanel موضع لوحة شمسية واحدة واتجاهها وإنتاجها. اطّلِع على حقول panelHeightMeters وpanelWidthMeters وpanelCapacityWatts في SolarPotential للحصول على معلومات عن مَعلمات اللوحة.

تمثيل JSON 
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
الحقول
center

object (LatLng)

وسط اللوحة
orientation

enum (SolarPanelOrientation)

اتجاه اللوحة
yearlyEnergyDcKwh

number

مقدار طاقة ضوء الشمس التي يجمعها هذا التصميم على مدار عام، بالكيلوواط ساعة من التيار المباشر
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

مقدار طاقة ضوء الشمس التي يجمعها هذا التصميم على مدار عام، بالكيلوواط ساعة من التيار المباشر، بافتراض استخدام الألواح الموضّحة أعلاه
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

عدد كيلوواط ساعة من التيار المتردد الذي نعتقد أنّ الألواح الشمسية ستولده في السنة الأولى
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)

قيمة جميع الخصومات الضريبية (بما في ذلك "الخصم الضريبي الفيدرالي على الاستثمار")
loanInterestRate

number

معدّل الفائدة على القروض المستخدَم في هذه المجموعة من العمليات الحسابية
savings

object (SavingsOverTime)

المبلغ الذي تم توفيره (أو عدم توفيره) خلال فترة الاستخدام