Method: buildingInsights.findClosest

Merkez noktası, sorgu noktasına en yakın olan binayı bulur. Sorgu noktasının yaklaşık 50 m yakınında bina yoksa NOT_FOUND kodlu bir hata döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
location

object (LatLng)

Zorunlu. API'nin bilinen en yakın binayı aradığı boylam ve enlem.

requiredQuality

enum (ImageryQuality)

İsteğe bağlıdır. Sonuçlarda izin verilen minimum kalite seviyesi. Bu kaliteden daha düşük kalitede sonuç döndürülmez. Bu değerin belirtilmemesi, yalnızca YÜKSEK kaliteyle kısıtlama yapılmasına eşdeğerdir.

exactQualityRequired

boolean

İsteğe bağlıdır. Görüntülerin tam kalitesinin gerekli olup olmadığı. "False" olarak ayarlanırsa requiredQuality alanı, gerekli minimum kalite olarak yorumlanır. Böylece requiredQuality, "MEDIUM" olarak ayarlandığında yüksek kalitede görüntüler döndürülebilir. Doğru değerine ayarlanırsa requiredQuality, tam olarak gerekli kalite olarak yorumlanır ve requiredQuality, MEDIUM değerine ayarlanırsa yalnızca MEDIUM kalitesinde görüntüler döndürülür.

experiments[]

enum (Experiment)

İsteğe bağlıdır. Etkinleştirilecek GKST öncesi denemeleri belirtir. Bu alanı kullanan istekler, Google Haritalar Platformu Hizmete Özgü Şartları kapsamında GKST öncesi teklif olarak sınıflandırılır. Daha fazla bilgi için lansman aşaması açıklamalarına bakın.

additionalInsights[]

enum (AdditionalInsights)

İsteğe bağlıdır. Yanıta dahil edilecek additionalInsights listesi.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Solar.FindClosestBuildingInsights için yanıt mesajı. Bir binanın konumu, boyutları ve güneş enerjisi potansiyeli hakkında bilgiler.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "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)
  }
}
Alanlar
name

string

Binanın kaynak adı (buildings/{place_id} biçiminde).

center

object (LatLng)

Binanın merkezine yakın bir nokta.

boundingBox

object (LatLngBox)

Binanın sınırlayıcı kutusu.

imageryDate

object (Date)

Temel görüntülerin alındığı tarih. Bu yaklaşık bir değerdir.

imageryProcessedDate

object (Date)

Bu görüntülerin işlenmesinin tamamlandığı tarih.

postalCode

string

Bu binanın bulunduğu posta kodu (ör. ABD posta kodu).

administrativeArea

string

Bu binanın bağlı olduğu yer 1 (ör. ABD'de eyalet). Örneğin, ABD'de kısaltma "MA" veya "CA" olabilir.

statisticalArea

string

Bu binanın bulunduğu istatistiksel alan (ör. ABD nüfus sayımı bölgesi).

regionCode

string

Bu binanın bulunduğu ülkenin (veya bölgenin) bölge kodu.

solarPotential

object (SolarPotential)

Binanın güneş enerjisi potansiyeli.

imageryQuality

enum (ImageryQuality)

Bu binanın verilerini hesaplamak için kullanılan görüntülerin kalitesi.

detectedArrays

object (DetectedArrays)

Binada güneş panelleri tespit edildi. Bu alan yalnızca isteğin FindClosestBuildingInsightsRequest.additional_insights parametresine DETECTED_ARRAYS dahil edilmişse doldurulur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

AdditionalInsights

BuildingInsights'ta döndürülebilen çatı geometrisi ve güneş paneli dizileri gibi ek bina bilgileri.

Sıralamalar
ADDITIONAL_INSIGHTS_UNSPECIFIED Varsayılan değer. Varsayılan BuildingInsights döndürülür.
DETECTED_ARRAYS

Yanıtın algılanan dizileri içerip içermeyeceğini belirler.

Belirtilirse yanıtta detectedArrays alanı doldurulur.

LatLngBox

Enlem/boylam koordinatlarında bir sınırlayıcı kutu.

JSON gösterimi
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
Alanlar
sw

object (LatLng)

Kutunun güneybatı köşesi.

ne

object (LatLng)

Kutunun kuzeydoğu köşesi.

SolarPotential

Bir binanın güneş enerjisi potansiyeli hakkında bilgi. Bu belgedeki bazı alanlar "panel" olarak tanımlanmıştır. panelCapacityWatts, panelHeightMeters ve panelWidthMeters alanları, bu hesaplamalarda kullanılan panel modelinin parametrelerini açıklar.

JSON gösterimi
{
  "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)
    }
  ]
}
Alanlar
maxArrayPanelsCount

integer

Maksimum panel dizisinin boyutu (çatıya sığabilecek maksimum panel sayısı).

panelCapacityWatts

number

Hesaplamalarda kullanılan panelin watt cinsinden kapasitesi.

panelHeightMeters

number

Hesaplamalarda kullanılan panelin dikey yönde metre cinsinden yüksekliği.

panelWidthMeters

number

Hesaplamalarda kullanılan panelin dikey yöndeki genişliği (metre cinsinden).

panelLifetimeYears

integer

Güneş panellerinin yıl cinsinden beklenen kullanım ömrü. Bu, finansal hesaplamalarda kullanılır.

maxArrayAreaMeters2

number

Maksimum dizinin metrekare cinsinden boyutu.

maxSunshineHoursPerYear

number

Çatının herhangi bir noktasının yılda aldığı maksimum güneş ışığı saati sayısı. Güneşli saatler, yıllık toplam güneşlenme (enerji) miktarının bir ölçüsüdür. 1 güneşli saat = kW başına 1 kWh (kW, Standart Test Koşulları'ndaki kW kapasitesini ifade eder).

carbonOffsetFactorKgPerMwh

number

Şebeke elektriğinin MW/sa başına üretilen eşdeğer CO2 miktarı. Bu, güneş enerjisiyle üretilen elektriğin yerini aldığı şebeke elektriğinin karbon yoğunluğunun bir ölçüsüdür.

wholeRoofStats

object (SizeAndSunshineStats)

Çatının bir çatı segmentine atanmış bölümü için toplam boyut ve güneş ışığı miktarları. Adına rağmen bu, tüm binayı kapsamayabilir. Şu sayfaya göz atın: buildingStats.

buildingStats

object (SizeAndSunshineStats)

Çatının bazı segmentlerine atanmamış kısımları da dahil olmak üzere tüm binanın boyut ve güneş ışığı miktarı. Bu parçaların yönleri iyi tanımlanmadığından çatı alanı tahmini güvenilir değildir ancak zemin alanı tahmini güvenilirdir. wholeRoofStats adresindeki çatı alanını buildingStats ve wholeRoofStats adreslerindeki zemin alanlarının oranına göre ölçeklendirerek tüm binanın çatı alanı için daha güvenilir bir değer elde edilebilir.

roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

Her çatı segmenti için boyut ve güneş ışığı miktarları.

solarPanels[]

object (SolarPanel)

Her SolarPanel, tek bir güneş panelini tanımlar. Bunlar, panel düzeni algoritmasının yerleştirdiği sırayla listelenir. Bu sıralama her zaman olmasa da genellikle yıllık enerji üretiminin azalan sırasına göredir.

solarPanelConfigs[]

object (SolarPanelConfig)

Her SolarPanelConfig, çatıdaki farklı bir güneş paneli düzenini açıklar. Panel sayısına göre artan sırada gösterilirler. panelsCount=N olan SolarPanelConfig, solarPanels listesindeki ilk N paneli temel alır. Bu alan yalnızca bir çatıya en az 4 panel sığabiliyorsa doldurulur.

financialAnalyses[]

object (FinancialAnalysis)

FinancialAnalysis, belirli bir aylık fatura ve belirli bir elektrik sağlayıcı varsayımıyla güneş enerjisine geçişten elde edilen tasarrufu gösterir. Aylık fatura tutarının artan sırasına göre sıralanır. Solar API'nin finansal hesaplamalar yapmak için yeterli bilgiye sahip olmadığı bölgelerdeki binalar için bu alan boş bırakılır.

SizeAndSunshineStats

Bir çatının veya çatının bir bölümünün boyut ve güneşlilik nicelikleri.

JSON gösterimi
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
Alanlar
areaMeters2

number

Çatının veya çatı segmentinin m^2 cinsinden alanı. Bu, zemin ayak izi alanı değil, çatı alanıdır (eğim hesaba katılır).

sunshineQuantiles[]

number

Bölge genelinde noktasal güneşlilik miktarının yüzdelik dilimleri. Burada N değer varsa bu, (N-1)-ile'leri temsil eder. Örneğin, 5 değer varsa bunlar çeyreklikler (min, %25, %50, %75, maks) olur. Değerler, maxSunshineHoursPerYear gibi yıllık kW/sa/kW cinsindendir.

groundAreaMeters2

number

Çatının veya çatı segmentinin kapladığı zemin ayak izi alanı (m^2 cinsinden).

RoofSegmentSizeAndSunshineStats

Çatı segmentinin boyutu ve güneş alma miktarı dilimleri hakkında bilgi.

JSON gösterimi
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
Alanlar
stats

object (SizeAndSunshineStats)

Çatı segmenti için toplam boyut ve güneş ışığı miktarları.

center

object (LatLng)

Çatı segmentinin merkezine yakın bir nokta.

boundingBox

object (LatLngBox)

Çatı segmentinin sınırlayıcı kutusu.

pitchDegrees

number

Çatı segmentinin teorik zemin düzlemine göre açısı. 0 = yere paralel, 90 = yere dik.

azimuthDegrees

number

Çatı segmentinin baktığı pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti için (pitchDegrees 0'a çok yakın) azimut iyi tanımlanmamıştır. Bu nedenle, tutarlılık açısından bunu isteğe bağlı olarak 0 (Kuzey) olarak tanımlarız.

planeHeightAtCenterMeters

number

center ile belirtilen noktada, deniz seviyesinden metre cinsinden yükseklik olarak çatı segmenti düzleminin yüksekliği. Eğim, azimut ve merkez konumla birlikte bu değer, çatı segmenti düzlemini tam olarak tanımlar.

SolarPanel

SolarPanel, tek bir güneş panelinin konumunu, yönünü ve üretimini açıklar. Panelin parametreleri hakkında bilgi edinmek için SolarPotential içindeki panelHeightMeters, panelWidthMeters ve panelCapacityWatts alanlarına bakın.

JSON gösterimi
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
Alanlar
center

object (LatLng)

Panelin ortası.

orientation

enum (SolarPanelOrientation)

Panelin yönü.

yearlyEnergyDcKwh

number

Bu yerleşimin bir yıl boyunca yakaladığı güneş ışığı enerjisi miktarı (DC kWh cinsinden).

segmentIndex

integer

Bu panelin yerleştirildiği çatı segmentine karşılık gelen RoofSegmentSizeAndSunshineStats dizini (roofSegmentStats cinsinden).

SolarPanelOrientation

Güneş panelinin yönü. Bu değer, panelin yerleştirildiği çatı segmentinin azimutuna göre yorumlanmalıdır.

Sıralamalar
SOLAR_PANEL_ORIENTATION_UNSPECIFIED Panel yönü bilinmiyor.
LANDSCAPE LANDSCAPE panelin uzun kenarı, yerleştirildiği çatı segmentinin azimut yönüne diktir.
PORTRAIT PORTRAIT panelin uzun kenarı, yerleştirildiği çatı segmentinin azimut yönüne paraleldir.

SolarPanelConfig

SolarPanelConfig, güneş panellerinin çatıdaki belirli bir yerleşimini açıklar.

JSON gösterimi
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
Alanlar
panelsCount

integer

Toplam panel sayısı. Bu değerin, roofSegmentSummaries içindeki ilgili alanların (toplamı) için gereksiz olduğunu unutmayın.

yearlyEnergyDcKwh

number

Yukarıda açıklanan panellerin kullanıldığı varsayılarak bu yerleşimin bir yıl boyunca yakaladığı güneş ışığı enerjisi miktarı (DC kWh cinsinden).

roofSegmentSummaries[]

object (RoofSegmentSummary)

Bu düzende en az bir panel taşıyan her çatı segmentinin üretimiyle ilgili bilgiler. roofSegmentSummaries[i], i. çatı segmentini (boyutu, beklenen üretimi ve yönü dahil) açıklar.

RoofSegmentSummary

Binadaki bir çatı segmenti ve üzerine yerleştirilen panel sayısı hakkında bilgi.

JSON gösterimi
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
Alanlar
panelsCount

integer

Bu segmentteki toplam panel sayısı.

yearlyEnergyDcKwh

number

Yukarıda açıklanan paneller varsayılarak, yerleşimin bu bölümünün bir yıl boyunca yakaladığı güneş ışığı enerjisi miktarı (DC kWh cinsinden).

pitchDegrees

number

Çatı segmentinin teorik zemin düzlemine göre açısı. 0 = yere paralel, 90 = yere dik.

azimuthDegrees

number

Çatı segmentinin baktığı pusula yönü. 0 = Kuzey, 90 = Doğu, 180 = Güney. "Düz" bir çatı segmenti için (pitchDegrees 0'a çok yakın) azimut iyi tanımlanmamıştır. Bu nedenle, tutarlılık açısından bunu isteğe bağlı olarak 0 (Kuzey) olarak tanımlarız.

segmentIndex

integer

İlgili RoofSegmentSizeAndSunshineStats için roofSegmentStats içindeki dizin.

FinancialAnalysis

Belirli bir elektrik faturası tutarı için optimum güneş enerjisi düzeninin maliyet ve fayda analizi.

JSON gösterimi
{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}
Alanlar
monthlyBill

object (Money)

Bu analizde varsayılan aylık elektrik faturası.

defaultBill

boolean

Bu binanın bulunduğu bölge için varsayılan fatura olarak seçilen fatura boyutu olup olmadığı. BuildingSolarPotential içindeki tam olarak bir FinancialAnalysis için defaultBill ayarlanmalıdır.

averageKwhPerMonth

number

Fatura tutarına ve yerel elektrik tarifelerine göre evin ortalama bir ayda kullandığı elektrik miktarı.

financialDetails

object (FinancialDetails)

Kullanılan finansman yönteminden bağımsız olarak geçerli olan finansal bilgiler.

leasingSavings

object (LeasingSavings)

Güneş panellerini kiralamanın maliyeti ve avantajı.

cashPurchaseSavings

object (CashPurchaseSavings)

Güneş panellerini nakit olarak satın almanın maliyeti ve avantajı.

financedPurchaseSavings

object (FinancedPurchaseSavings)

Satın alma işlemini finanse ederek güneş panelleri satın almanın maliyeti ve avantajı.

panelConfigIndex

integer

Bu fatura tutarı için optimum güneş enerjisi düzeninin solarPanelConfigs cinsinden dizini. Bu değer -1 olabilir. Bu, düzen olmadığını gösterir. Bu durumda, kalan alt mesajlar atlanır.

Para

Para birimi türüyle birlikte para miktarını temsil eder.

JSON gösterimi
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Alanlar
currencyCode

string

ISO 4217'de tanımlanan üç harfli para birimi kodu.

units

string (int64 format)

Tutarın tam birimleri. Örneğin, currencyCode "USD" ise 1 birim, bir ABD dolarıdır.

nanos

integer

Miktarın nano (10^-9) birim sayısı. Değer, -999.999.999 ile +999.999.999 arasında (değerler dahil) olmalıdır. units pozitifse nanos pozitif veya sıfır olmalıdır. units sıfırsa nanos pozitif, sıfır veya negatif olabilir. units negatifse nanos negatif veya sıfır olmalıdır. Örneğin, -1,75 ABD doları units=-1 ve nanos=-750.000.000 olarak gösterilir.

FinancialDetails

Finansal analizin ayrıntıları. Bu ayrıntılardan bazıları zaten daha yüksek seviyelerde (ör. cepten yapılan harcama) depolanır. Toplam para tutarları, SolarPotential içindeki panelLifetimeYears alanı tarafından tanımlanan bir kullanım süresi boyunca geçerlidir. Not: Panelleri satın almanın cepten yapılan harcaması, CashPurchaseSavings cinsinden outOfPocketCost alanında belirtilir.

JSON gösterimi
{
  "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
}
Alanlar
initialAcKwhPerYear

number

Güneş panellerinin ilk yılında kaç AC kWh üreteceğini tahmin ediyoruz.

remainingLifetimeUtilityBill

object (Money)

Panellerin kullanım ömrü boyunca güneş enerjisiyle üretilmeyen elektrik için ödenecek altyapı hizmeti faturası.

federalIncentive

object (Money)

Federal teşviklerden elde edilebilecek para miktarı. Bu miktar, kullanıcı panelleri satın alırsa (krediyle veya kredisiz) geçerlidir.

stateIncentive

object (Money)

Eyalet teşviklerinden elde edilebilecek para miktarı. Bu, kullanıcının panelleri satın alması (krediyle veya kredisiz) durumunda geçerlidir.

utilityIncentive

object (Money)

Kamu hizmeti teşviklerinden elde edilebilecek para miktarı. Bu miktar, kullanıcının panelleri satın alması (krediyle veya kredisiz) durumunda geçerlidir.

lifetimeSrecTotal

object (Money)

Kullanıcının panel kullanım ömrü boyunca Güneş Enerjisi Yenilenebilir Enerji Kredilerinden alacağı para miktarı. Bu, kullanıcının panelleri satın alması (krediyle veya kredisiz) durumunda geçerlidir.

costOfElectricityWithoutSolar

object (Money)

Kullanıcının güneş enerjisi sistemi kurmaması durumunda kullanım ömrü boyunca ödeyeceği toplam elektrik maliyeti.

netMeteringAllowed

boolean

Net ölçüme izin verilip verilmediği.

solarPercentage

number

Kullanıcının güneş enerjisinden sağlanan gücünün yüzdesi (0-100). İlk yıl için geçerlidir ancak sonraki yıllar için yaklaşık olarak doğrudur.

percentageExportedToGrid

number

Üretimin ilk çeyreğine göre şebekeye aktarıldığını varsaydığımız güneş enerjisi kaynaklı elektrik üretiminin yüzdesi (0-100). Net ölçmeye izin verilmiyorsa bu durum hesaplamaları etkiler.

LeasingSavings

Belirli bir elektrik kullanımına sahip belirli bir güneş paneli yapılandırmasını kiralamanın maliyeti ve avantajı.

JSON gösterimi
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
Alanlar
leasesAllowed

boolean

Bu yargı alanında kiralamaya izin verilip verilmediği (bazı eyaletlerde kiralamaya izin verilmez). Bu alan yanlışsa bu mesajdaki değerler muhtemelen yoksayılmalıdır.

leasesSupported

boolean

Bu yargı alanında finansal hesaplama motoru tarafından kiralamaların desteklenip desteklenmediği. Bu alan yanlışsa bu mesajdaki değerler muhtemelen yoksayılmalıdır. Bu durum leasesAllowed ile ilgili değildir: Bazı bölgelerde kiralamaya izin verilir ancak finansal modeller tarafından ele alınmayan koşullar geçerlidir.

annualLeasingCost

object (Money)

Tahmini yıllık kiralama maliyeti.

savings

object (SavingsOverTime)

Kullanım ömrü boyunca ne kadar tasarruf edildiği (veya edilmediği).

SavingsOverTime

Farklı finansman yöntemleri arasında paylaşılan finansal bilgiler.

JSON gösterimi
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
Alanlar
savingsYear1

object (Money)

Panel kurulumundan sonraki ilk yılda elde edilen tasarruf.

savingsYear20

object (Money)

Panel kurulumundan sonraki ilk yirmi yılda elde edilen tasarruf.

presentValueOfSavingsYear20

object (Money)

Varsayılan indirim oranı kullanıldığında, 20 yıllık kümülatif tasarrufun bugünkü değeri nedir?

savingsLifetime

object (Money)

Panelin kullanım ömrü boyunca elde edilen tasarruf.

presentValueOfSavingsLifetime

object (Money)

Varsayılan indirim oranı kullanıldığında, kümülatif yaşam boyu tasarrufların bugünkü değeri nedir?

financiallyViable

boolean

Bu senaryonun finansal açıdan uygulanabilir olup olmadığını gösterir. Finansal açıdan yeterli olmayan senaryolar (ör. para kaybettiren) için "false" değerini alır.

CashPurchaseSavings

Belirli bir elektrik kullanımına sahip belirli bir güneş paneli yapılandırmasını doğrudan satın almanın maliyeti ve avantajı.

JSON gösterimi
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
Alanlar
outOfPocketCost

object (Money)

Vergiler hariç ilk maliyet: Cebinizden ödemeniz gereken tutar. Vergi teşviklerinden sonraki upfrontCost ile karşılaştırın.

upfrontCost

object (Money)

Vergi teşviklerinden sonraki ilk maliyet: İlk yıl içinde ödenmesi gereken tutardır. Vergi teşviklerinden önceki outOfPocketCost ile karşılaştırın.

rebateValue

object (Money)

Tüm vergi iadelerinin değeri.

savings

object (SavingsOverTime)

Kullanım ömrü boyunca ne kadar tasarruf edildiği (veya edilmediği).

paybackYears

number

Geri ödeme gerçekleşene kadar geçen yıl sayısı. Negatif değer, yaşam boyu dönemde hiçbir zaman geri ödeme yapılmadığı anlamına gelir.

FinancedPurchaseSavings

Belirli bir elektrik kullanımına sahip belirli bir güneş paneli yapılandırmasını satın almak için kredi kullanmanın maliyeti ve avantajı.

JSON gösterimi
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
Alanlar
annualLoanPayment

object (Money)

Yıllık kredi ödemeleri.

rebateValue

object (Money)

Federal Yatırım Vergisi İndirimi (ITC) dahil olmak üzere tüm vergi iadelerinin değeri.

loanInterestRate

number

Bu hesaplama grubunda varsayılan kredi faiz oranı.

savings

object (SavingsOverTime)

Yaşam boyu dönemde ne kadar tasarruf edildiği (veya edilmediği).

DetectedArrays

Binada algılanan güneş paneli dizileri hakkında bilgi.

JSON gösterimi
{
  "detectionStatus": enum (DetectionStatus),
  "arrays": [
    {
      object (SolarArray)
    }
  ],
  "latestCaptureDate": {
    object (Date)
  }
}
Alanlar
detectionStatus

enum (DetectionStatus)

Bu bina için güneş panellerinin algılanma durumunu gösterir.

arrays[]

object (SolarArray)

Binada algılanan güneş paneli gruplarının listesi.

latestCaptureDate

object (Date)

En son güneş paneli verilerinin ne zaman alındığını gösteren tarih.

DetectionStatus

Bu bina için güneş panellerinin algılanma durumunu gösterir.

Sıralamalar
DETECTION_STATUS_UNSPECIFIED Belirtilmemiş durum.
DETECTION_STATUS_DATA_UNAVAILABLE Bu bina için algılanan güneş paneli verisi yok.
DETECTION_STATUS_ARRAYS_DETECTED Bu bina için en az bir güneş paneli dizisi algılandı.
DETECTION_STATUS_NO_ARRAYS_DETECTED Bu bina için güneş paneli dizisi algılanmadı.

SolarArray

Algılanan tek bir güneş enerjisi paneliyle ilgili ayrıntılar.

JSON gösterimi
{
  "polygonGeojson": {
    object
  }
}
Alanlar
polygonGeojson

object (Struct format)

Güneş panellerinin algılandığı bina alanının GeoJSON gösterimi.

GeoJSON verileri RFC 7946 biçiminde olmalı ve tek bir bitişik alan için bir poligonu temsil etmelidir.

Poligon, delikler içerdiğinde birkaç döngüyle temsil edilir.

Örnek:

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