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)

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

المنطقة الإدارية 1 (مثل الولاية في الولايات المتحدة) التي يقع فيها هذا المبنى على سبيل المثال، في الولايات المتحدة، قد يكون الاختصار "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

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

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

DetectedArrays

معلومات عن ألواح الطاقة الشمسية التي تم رصدها على المبنى

تمثيل JSON 
{
  "detectionStatus": enum (DetectionStatus),
  "latestCaptureDate": {
    object (Date)
  }
}
الحقول
detectionStatus

enum (DetectionStatus)

تشير هذه السمة إلى حالة رصد ألواح الطاقة الشمسية لهذا المبنى.
latestCaptureDate

object (Date)

التاريخ الذي يشير إلى وقت الحصول على أحدث بيانات الألواح الشمسية.

DetectionStatus

تشير هذه السمة إلى حالة رصد ألواح الطاقة الشمسية لهذا المبنى.

عمليات التعداد
DETECTION_STATUS_UNSPECIFIED حالة غير محدَّدة
DETECTION_STATUS_DATA_UNAVAILABLE لا تتوفّر بيانات عن ألواح الطاقة الشمسية التي تم رصدها لهذا المبنى.
DETECTION_STATUS_ARRAYS_DETECTED تم رصد مجموعة واحدة على الأقل من الألواح الشمسية لهذا المبنى.
DETECTION_STATUS_NO_ARRAYS_DETECTED لم يتم رصد أي ألواح شمسية لهذا المبنى.