Method: buildingInsights.findClosest

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

طلب HTTP

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

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

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

المعلمات
location

object (LatLng)

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

enum (ImageryQuality)

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

boolean

اختيارية: تحديد ما إذا كان يجب توفّر جودة دقيقة للصور إذا تم ضبطها على false، سيتم تفسير الحقل requiredQuality على أنّه الحد الأدنى للجودة المطلوبة، وبالتالي قد يتم عرض صور عالية الجودة عندما يتم ضبط requiredQuality على MEDIUM. في حال ضبطها على "صحيح"، سيتم تفسير requiredQuality على أنّه الجودة المطلوبة تمامًا، ولن يتم عرض صور بجودة MEDIUM إلا إذا تم ضبط requiredQuality على MEDIUM.
experiments[]

enum (Experiment)

اختيارية: تحدّد هذه السمة ميزات ما قبل الإصدار العام التي سيتم تفعيلها.

نص الطلب

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

نص الاستجابة

رسالة الردّ على السؤال 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

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

تصف السمة 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

ما إذا كان يُسمح بعقود الإيجار في هذه الولاية القضائية (لا يُسمح بعقود الإيجار في بعض الولايات) إذا كانت قيمة هذا الحقل هي "false"، من المحتمل أنّه يجب تجاهل القيم الواردة في هذه الرسالة.
leasesSupported

boolean

تُستخدَم لتحديد ما إذا كانت عقود الإيجار متاحة في هذه الولاية القضائية من خلال محرّك العمليات الحسابية المالية. إذا كانت قيمة هذا الحقل هي "false"، من المحتمل أنّه يجب تجاهل القيم الواردة في هذه الرسالة. هذا مستقل عن 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

تشير هذه السمة إلى ما إذا كان هذا السيناريو قابلاً للتطبيق من الناحية المالية. ستكون القيمة false في السيناريوهات التي تكون فيها الجدوى المالية ضعيفة (على سبيل المثال، خسارة الأموال).

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)

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