Method: buildingInsights.findClosest

Wyszukuje budynek, którego środek ciężkości znajduje się najbliżej punktu zapytania. Zwraca błąd o kodzie NOT_FOUND, jeśli w odległości około 50 m od punktu zapytania nie ma żadnych budynków.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
location

object (LatLng)

Wymagane. Długość i szerokość geograficzna, na podstawie których interfejs API wyszukuje najbliższy znany budynek.

requiredQuality

enum (ImageryQuality)

Opcjonalnie. Minimalny poziom jakości dozwolony w wynikach. Nie zostaną zwrócone żadne wyniki o niższej jakości. Nieokreślenie tego parametru jest równoznaczne z ograniczeniem do jakości WYSOKIEJ.

exactQualityRequired

boolean

Opcjonalnie. Określa, czy wymagana jest dokładna jakość zdjęć. Jeśli wartość tego pola to „false”, pole requiredQuality jest interpretowane jako minimalna wymagana jakość, co oznacza, że obrazy o wysokiej jakości mogą być zwracane, gdy wartość pola requiredQuality to „MEDIUM”. Jeśli ma wartość „true”, requiredQuality jest interpretowane jako dokładna wymagana jakość i zwracane są tylko obrazy o jakości MEDIUM, jeśli requiredQuality ma wartość MEDIUM.

experiments[]

enum (Experiment)

Opcjonalnie. Określa eksperymenty przed GA, które mają zostać włączone. Żądania korzystające z tego pola są klasyfikowane jako oferta przed GA zgodnie ze szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w opisach etapu uruchamiania.

additionalInsights[]

enum (AdditionalInsights)

Opcjonalnie. Lista additionalInsights, które mają być uwzględnione w odpowiedzi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Wiadomość z odpowiedzią dla Solar.FindClosestBuildingInsights. Informacje o lokalizacji, wymiarach i potencjale paneli słonecznych danego budynku.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis 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)
  }
}
Pola
name

string

Nazwa zasobu budynku w formacie buildings/{place_id}.

center

object (LatLng)

Punkt w pobliżu środka budynku.

boundingBox

object (LatLngBox)

Ramka ograniczająca budynku.

imageryDate

object (Date)

Data pozyskania zdjęć bazowych. To jest wartość przybliżona.

imageryProcessedDate

object (Date)

Kiedy zakończono przetwarzanie tych zdjęć.

postalCode

string

Kod pocztowy (np. kod pocztowy w USA), w którym znajduje się ten budynek.

administrativeArea

string

Region administracyjny 1 (np. w Stanach Zjednoczonych stan), w którym znajduje się ten budynek. Na przykład w Stanach Zjednoczonych skrót może brzmieć „MA” lub „CA”.

statisticalArea

string

Obszar statystyczny (np. okręg spisowy w USA), w którym znajduje się budynek.

regionCode

string

Kod regionu kraju (lub regionu), w którym znajduje się ten budynek.

solarPotential

object (SolarPotential)

Potencjał paneli słonecznych na budynku.

imageryQuality

enum (ImageryQuality)

Jakość zdjęć użytych do obliczenia danych dla tego budynku.

detectedArrays

object (DetectedArrays)

Moduły fotowoltaiczne wykryte na budynku. To pole jest wypełniane tylko wtedy, gdy w polu FindClosestBuildingInsightsRequest.additional_insights żądania znajduje się wartość DETECTED_ARRAYS.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

AdditionalInsights

Dodatkowe informacje o budynku, takie jak geometria dachu i układy paneli słonecznych, które mogą być zwracane w BuildingInsights.

Wartości w polu enum
ADDITIONAL_INSIGHTS_UNSPECIFIED Wartość domyślna. Zostanie zwrócony domyślny obiekt BuildingInsights.
DETECTED_ARRAYS

Określa, czy odpowiedź będzie zawierać wykryte tablice.

Jeśli jest określone, w odpowiedzi zostanie wypełnione pole detectedArrays.

LatLngBox

Ramka ograniczająca w postaci współrzędnych geograficznych.

Zapis JSON
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
Pola
sw

object (LatLng)

Południowo-zachodni róg pola.

ne

object (LatLng)

Północno-wschodni róg pola.

SolarPotential

Informacje o potencjale paneli słonecznych w przypadku budynku. Wiele pól jest w nim zdefiniowanych w kategoriach „paneli”. Pola panelCapacityWatts, panelHeightMeterspanelWidthMeters opisują parametry modelu panelu użytego w tych obliczeniach.

Zapis 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)
    }
  ]
}
Pola
maxArrayPanelsCount

integer

Rozmiar maksymalnej tablicy, czyli maksymalna liczba paneli, które zmieszczą się na dachu.

panelCapacityWatts

number

Moc panelu w watach użyta w obliczeniach.

panelHeightMeters

number

Wysokość panelu używanego w obliczeniach w metrach w orientacji pionowej.

panelWidthMeters

number

Szerokość panelu używanego w obliczeniach w metrach w orientacji pionowej.

panelLifetimeYears

integer

Oczekiwany okres użytkowania paneli słonecznych w latach. Jest on używany w obliczeniach finansowych.

maxArrayAreaMeters2

number

Rozmiar maksymalnej tablicy w metrach kwadratowych.

maxSunshineHoursPerYear

number

Maksymalna liczba godzin nasłonecznienia w ciągu roku w dowolnym punkcie dachu. Liczba godzin słonecznych to miara łącznej ilości nasłonecznienia (energii) otrzymywanej w ciągu roku. 1 godzina nasłonecznienia = 1 kWh na 1 kW (gdzie kW oznacza moc w kW w standardowych warunkach testowych).

carbonOffsetFactorKgPerMwh

number

Równoważna ilość CO₂ wytwarzana na MWh energii elektrycznej z sieci. Jest to wskaźnik emisji dwutlenku węgla w energii elektrycznej z sieci, która została zastąpiona energią słoneczną.

wholeRoofStats

object (SizeAndSunshineStats)

Łączny rozmiar i kwantyle światła słonecznego dla części dachu przypisanej do segmentu dachu. Pomimo nazwy może nie obejmować całego budynku. Zobacz buildingStats.

buildingStats

object (SizeAndSunshineStats)

Kwantyle wielkości i nasłonecznienia dla całego budynku, w tym części dachu, które nie zostały przypisane do żadnego segmentu dachu. Orientacja tych części nie jest dobrze określona, więc szacunkowa powierzchnia dachu jest niewiarygodna, ale szacunkowa powierzchnia gruntu jest wiarygodna. Bardziej wiarygodną powierzchnię dachu całego budynku można uzyskać, skalując powierzchnię dachu z wholeRoofStats o stosunek powierzchni gruntu buildingStatswholeRoofStats.

roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

kwantyle rozmiaru i nasłonecznienia dla każdego segmentu dachu;

solarPanels[]

object (SolarPanel)

Każdy symbol SolarPanel opisuje jeden panel słoneczny. Są one wymienione w kolejności, w jakiej umieścił je algorytm układu panelu. Zwykle, choć nie zawsze, są one podane w kolejności malejącej rocznej produkcji energii.

solarPanelConfigs[]

object (SolarPanelConfig)

Każdy SolarPanelConfig opisuje inny układ paneli słonecznych na dachu. Są one uporządkowane według rosnącej liczby paneli. Wartość SolarPanelConfig z parametrem panelsCount=N jest oparta na pierwszych N panelach na liście solarPanels. To pole jest wypełniane tylko wtedy, gdy na dachu można zmieścić co najmniej 4 panele.

financialAnalyses[]

object (FinancialAnalysis)

FinancialAnalysis – oszczędności wynikające z korzystania z energii słonecznej przy danym miesięcznym rachunku i danym dostawcy energii elektrycznej. Są one uporządkowane według rosnącej kwoty miesięcznego rachunku. To pole będzie puste w przypadku budynków znajdujących się na obszarach, dla których interfejs Solar API nie ma wystarczających informacji, aby przeprowadzić obliczenia finansowe.

SizeAndSunshineStats

kwantyle rozmiaru i nasłonecznienia dachu lub jego części;

Zapis JSON
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
Pola
areaMeters2

number

Powierzchnia dachu lub jego fragmentu w m². Jest to powierzchnia dachu (z uwzględnieniem nachylenia), a nie powierzchnia zajmowana przez budynek na ziemi.

sunshineQuantiles[]

number

Kwantyle nasłonecznienia punktowego na danym obszarze. Jeśli jest tu N wartości, reprezentują one (N-1)-ile. Jeśli na przykład jest 5 wartości, będą to kwartyle (min, 25%, 50%, 75%, max). Wartości są podawane w kWh/kW rocznie, np. maxSunshineHoursPerYear.

groundAreaMeters2

number

Powierzchnia rzutu dachu lub jego segmentu na ziemię w m².

RoofSegmentSizeAndSunshineStats

Informacje o kwantylach rozmiaru i nasłonecznienia segmentu dachu.

Zapis JSON
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
Pola
stats

object (SizeAndSunshineStats)

Całkowity rozmiar i kwantyle nasłonecznienia segmentu dachu.

center

object (LatLng)

Punkt w pobliżu środka segmentu dachu.

boundingBox

object (LatLngBox)

Ramka ograniczająca segment dachu.

pitchDegrees

number

Kąt segmentu dachu względem teoretycznej płaszczyzny podłoża. 0 = równoległe do podłoża, 90 = prostopadłe do podłoża.

azimuthDegrees

number

Kierunek kompasu, w którym zwrócony jest segment dachu. 0 = północ, 90 = wschód, 180 = południe. W przypadku segmentu dachu „płaskiego” (pitchDegrees bardzo blisko 0) azymut nie jest dobrze zdefiniowany, więc dla spójności arbitralnie przyjmujemy wartość 0 (północ).

planeHeightAtCenterMeters

number

Wysokość płaszczyzny segmentu dachu w metrach nad poziomem morza w punkcie oznaczonym symbolem center. Wraz z nachyleniem, azymutem i lokalizacją środka w pełni określa płaszczyznę segmentu dachu.

SolarPanel

SolarPanel opisuje położenie, orientację i produkcję pojedynczego panelu słonecznego. Informacje o parametrach panelu znajdziesz w polach panelHeightMeters, panelWidthMeterspanelCapacityWattsSolarPotential.

Zapis JSON
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
Pola
center

object (LatLng)

środek panelu.

orientation

enum (SolarPanelOrientation)

Orientacja panelu.

yearlyEnergyDcKwh

number

Ile energii słonecznej w kWh prądu stałego jest przechwytywane przez tę konfigurację w ciągu roku.

segmentIndex

integer

Indeks w roofSegmentStats RoofSegmentSizeAndSunshineStats, który odpowiada segmentowi dachu, na którym umieszczony jest ten panel.

SolarPanelOrientation

Orientacja panelu słonecznego. Należy to interpretować w odniesieniu do azymutu segmentu dachu, na którym umieszczony jest panel.

Wartości w polu enum
SOLAR_PANEL_ORIENTATION_UNSPECIFIED Nieznana orientacja panelu.
LANDSCAPE Dłuższy bok panelu LANDSCAPE jest prostopadły do kierunku azymutu segmentu dachu, na którym jest umieszczony.
PORTRAIT Dłuższy bok panelu PORTRAIT jest równoległy do kierunku azymutu segmentu dachu, na którym jest umieszczony.

SolarPanelConfig

SolarPanelConfig opisuje konkretne rozmieszczenie paneli słonecznych na dachu.

Zapis JSON
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
Pola
panelsCount

integer

Łączna liczba paneli. Pamiętaj, że jest to redundantne w stosunku do (sumy) odpowiednich pól w roofSegmentSummaries.

yearlyEnergyDcKwh

number

Ile energii słonecznej w kWh prądu stałego może zostać przechwycone w ciągu roku przy założeniu, że panele są takie jak opisane powyżej.

roofSegmentSummaries[]

object (RoofSegmentSummary)

Informacje o produkcji każdego segmentu dachu, na którym znajduje się co najmniej 1 panel w tym układzie. roofSegmentSummaries[i] opisuje i-ty segment dachu, w tym jego rozmiar, oczekiwaną produkcję i orientację.

RoofSegmentSummary

Informacje o fragmencie dachu budynku, na którym znajduje się pewna liczba paneli.

Zapis JSON
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
Pola
panelsCount

integer

Łączna liczba paneli w tym segmencie.

yearlyEnergyDcKwh

number

Ile energii słonecznej ta część instalacji przechwytuje w ciągu roku (w kWh DC) przy założeniu, że panele są takie jak opisane powyżej.

pitchDegrees

number

Kąt segmentu dachu względem teoretycznej płaszczyzny podłoża. 0 = równoległe do podłoża, 90 = prostopadłe do podłoża.

azimuthDegrees

number

Kierunek kompasu, w którym zwrócony jest segment dachu. 0 = północ, 90 = wschód, 180 = południe. W przypadku segmentu dachu „płaskiego” (pitchDegrees bardzo blisko 0) azymut nie jest dobrze zdefiniowany, więc dla spójności arbitralnie przyjmujemy wartość 0 (północ).

segmentIndex

integer

Indeks w roofSegmentStats odpowiedniego RoofSegmentSizeAndSunshineStats.

FinancialAnalysis

Analiza kosztów i korzyści wynikających z optymalnego rozmieszczenia paneli słonecznych w przypadku określonej wysokości rachunku za prąd.

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

object (Money)

Miesięczny rachunek za prąd, który został przyjęty w tej analizie.

defaultBill

boolean

Czy jest to rozmiar rachunku wybrany jako domyślny dla obszaru, na którym znajduje się ten budynek. Dokładnie 1 element FinancialAnalysisBuildingSolarPotential powinien mieć ustawioną wartość defaultBill.

averageKwhPerMonth

number

Ile energii elektrycznej zużywa dom w przeciętnym miesiącu na podstawie wysokości rachunku i lokalnych stawek za energię elektryczną.

financialDetails

object (FinancialDetails)

Informacje finansowe, które mają zastosowanie niezależnie od użytej metody finansowania.

leasingSavings

object (LeasingSavings)

Koszt i korzyści z dzierżawy paneli słonecznych.

cashPurchaseSavings

object (CashPurchaseSavings)

Koszt i korzyści związane z zakupem paneli słonecznych za gotówkę.

financedPurchaseSavings

object (FinancedPurchaseSavings)

Koszt i korzyści związane z zakupem paneli słonecznych w ramach finansowania.

panelConfigIndex

integer

Indeks w solarPanelConfigs optymalnego układu instalacji fotowoltaicznej dla tego rozmiaru rachunku. Może to być wartość -1, co oznacza, że nie ma układu. W takim przypadku pozostałe podkomunikaty zostaną pominięte.

Pieniądze

Reprezentuje kwotę pieniędzy z określeniem typu waluty.

Zapis JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Pola
currencyCode

string

Trzyliterowy kod waluty zdefiniowany w normie ISO 4217.

units

string (int64 format)

Całe jednostki kwoty. Jeśli na przykład currencyCode to "USD", to 1 jednostka to 1 PLN.

nanos

integer

Liczba jednostek nano (10^-9) kwoty. Wartość musi mieścić się w przedziale od -999 999 999 do +999 999 999 (włącznie). Jeśli wartość units jest dodatnia, wartość nanos musi być dodatnia lub wynosić zero. Jeśli units wynosi zero, nanos może być dodatnia, ujemna lub równa zero. Jeśli wartość units jest ujemna, wartość nanos musi być ujemna lub równa zero. Na przykład wartość $-1,75 jest przedstawiana jako units=-1 i nanos=-750 000 000.

FinancialDetails

szczegóły analizy finansowej; Niektóre z tych szczegółów są już przechowywane na wyższych poziomach (np. koszt z własnej kieszeni). Łączne kwoty pieniędzy dotyczą okresu zdefiniowanego przez pole panelLifetimeYearsSolarPotential. Uwaga: koszt zakupu paneli jest podany w polu outOfPocketCostCashPurchaseSavings.

Zapis 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
}
Pola
initialAcKwhPerYear

number

Szacowana ilość kWh prądu przemiennego, jaką panele słoneczne wygenerują w pierwszym roku.

remainingLifetimeUtilityBill

object (Money)

Rachunek za energię elektryczną, która nie została wyprodukowana przez panele słoneczne, za cały okres ich eksploatacji.

federalIncentive

object (Money)

Kwota dostępna w ramach zachęt federalnych. Dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez).

stateIncentive

object (Money)

Kwota dostępna w ramach zachęt państwowych. Dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez).

utilityIncentive

object (Money)

Kwota dostępna w ramach zachęt od dostawców energii; dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez niego).

lifetimeSrecTotal

object (Money)

Kwota pieniędzy, jaką użytkownik otrzyma z tytułu certyfikatów energii odnawialnej z instalacji fotowoltaicznej w okresie jej eksploatacji. Dotyczy to sytuacji, gdy użytkownik kupuje panele (z kredytem lub bez).

costOfElectricityWithoutSolar

object (Money)

Całkowity koszt energii elektrycznej, jaki użytkownik zapłaciłby w okresie eksploatacji, gdyby nie zainstalował paneli słonecznych.

netMeteringAllowed

boolean

Czy opomiarowanie netto jest dozwolone.

solarPercentage

number

Procent (0–100) energii użytkownika pochodzącej z energii słonecznej. Obowiązuje w pierwszym roku, ale jest w przybliżeniu prawidłowa w kolejnych latach.

percentageExportedToGrid

number

Procent (0–100) produkcji energii elektrycznej z fotowoltaiki, który według naszych założeń został wyeksportowany do sieci na podstawie pierwszego kwartału produkcji. Wpływa to na obliczenia, jeśli rozliczenie net-metering nie jest dozwolone.

LeasingSavings

Koszt i korzyści z dzierżawy paneli słonecznych w określonej konfiguracji przy określonym zużyciu energii elektrycznej.

Zapis JSON
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
Pola
leasesAllowed

boolean

Czy w danym regionie dopuszczalne są umowy leasingu (w niektórych stanach są one niedozwolone). Jeśli to pole ma wartość „false”, wartości w tym komunikacie należy prawdopodobnie zignorować.

leasesSupported

boolean

Określa, czy silnik obliczeń finansowych obsługuje leasing w danym regionie. Jeśli to pole ma wartość „false”, wartości w tym komunikacie należy prawdopodobnie zignorować. Jest to niezależne od leasesAllowed: w niektórych regionach leasing jest dozwolony, ale pod warunkami, które nie są obsługiwane przez modele finansowe.

annualLeasingCost

object (Money)

Szacowany roczny koszt leasingu.

savings

object (SavingsOverTime)

Ile zostało zaoszczędzone (lub nie) w całym okresie.

SavingsOverTime

informacje finansowe, które są udostępniane między różnymi metodami finansowania;

Zapis JSON
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
Pola
savingsYear1

object (Money)

Oszczędności w pierwszym roku po instalacji paneli.

savingsYear20

object (Money)

Oszczędności w pierwszych 20 latach po zainstalowaniu paneli.

presentValueOfSavingsYear20

object (Money)

Jaka jest obecna wartość skumulowanych oszczędności w ciągu 20 lat przy założonej stopie dyskontowej?

savingsLifetime

object (Money)

Oszczędności w całym okresie użytkowania panelu.

presentValueOfSavingsLifetime

object (Money)

Jaka jest obecna wartość skumulowanych oszczędności w ciągu całego okresu eksploatacji przy założonej stopie dyskontowej?

financiallyViable

boolean

Wskazuje, czy ten scenariusz jest opłacalny. W przypadku scenariuszy o niskiej rentowności (np. przynoszących straty) wartość będzie fałszywa.

CashPurchaseSavings

Koszt i korzyści związane z zakupem konkretnej konfiguracji paneli słonecznych przy określonym zużyciu energii elektrycznej.

Zapis JSON
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
Pola
outOfPocketCost

object (Money)

Koszt początkowy przed uwzględnieniem ulg podatkowych: kwota, którą należy zapłacić z własnej kieszeni. W przeciwieństwie do upfrontCost, która uwzględnia ulgi podatkowe.

upfrontCost

object (Money)

Koszt początkowy po uwzględnieniu ulg podatkowych: jest to kwota, którą należy zapłacić w pierwszym roku. W przeciwieństwie do outOfPocketCost, która jest wartością przed uwzględnieniem zachęt podatkowych.

rebateValue

object (Money)

Wartość wszystkich zwrotów podatku.

savings

object (SavingsOverTime)

Ile zostało zaoszczędzone (lub nie) w okresie obowiązywania ochrony.

paybackYears

number

Liczba lat do zwrotu z inwestycji. Wartość ujemna oznacza, że zwrot nigdy nie nastąpi w okresie życia produktu.

FinancedPurchaseSavings

Koszt i korzyści związane z zaciągnięciem pożyczki na zakup określonej konfiguracji paneli słonecznych przy określonym zużyciu energii elektrycznej.

Zapis JSON
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
Pola
annualLoanPayment

object (Money)

roczne spłaty kredytu,

rebateValue

object (Money)

Wartość wszystkich zwrotów podatku (w tym federalnego podatku inwestycyjnego).

loanInterestRate

number

Stopa oprocentowania kredytów przyjęta w tym zestawie obliczeń.

savings

object (SavingsOverTime)

Ile zostało zaoszczędzone (lub nie) w całym okresie.

DetectedArrays

Informacje o panelach słonecznych wykrytych na budynku.

Zapis JSON
{
  "detectionStatus": enum (DetectionStatus),
  "latestCaptureDate": {
    object (Date)
  }
}
Pola
detectionStatus

enum (DetectionStatus)

Wskazuje stan wykrycia paneli słonecznych na tym budynku.

latestCaptureDate

object (Date)

Data wskazująca, kiedy zostały zebrane najnowsze dane dotyczące paneli fotowoltaicznych.

DetectionStatus

Wskazuje stan wykrycia paneli słonecznych na tym budynku.

Wartości w polu enum
DETECTION_STATUS_UNSPECIFIED Stan nieokreślony.
DETECTION_STATUS_DATA_UNAVAILABLE Dane wykrytej instalacji solarnej są niedostępne w przypadku tego budynku.
DETECTION_STATUS_ARRAYS_DETECTED W tym budynku wykryto co najmniej 1 panel słoneczny.
DETECTION_STATUS_NO_ARRAYS_DETECTED Nie wykryto paneli słonecznych na tym budynku.