Method: buildingInsights.findClosest

Sucht das Gebäude, dessen Schwerpunkt dem Abfragepunkt am nächsten ist. Gibt einen Fehler mit dem Code NOT_FOUND zurück, wenn sich innerhalb von etwa 50 Metern vom Anfragepunkt keine Gebäude befinden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
location

object (LatLng)

Erforderlich. Der Längen- und Breitengrad, von dem aus die API nach dem nächstgelegenen bekannten Gebäude sucht.

requiredQuality

enum (ImageryQuality)

Optional. Die niedrigste zulässige Qualitätsstufe in den Ergebnissen. Es werden keine Ergebnisse mit geringerer Qualität als dieser zurückgegeben. Wenn Sie dies nicht angeben, wird die Suche auf die Qualität „HOCH“ beschränkt.

exactQualityRequired

boolean

Optional. Gibt an, ob eine genaue Qualität der Bilder erforderlich ist. Wenn der Wert auf „false“ gesetzt ist, wird das Feld requiredQuality als die mindestens erforderliche Qualität interpretiert. Das bedeutet, dass Bilder in HOCHer Qualität zurückgegeben werden können, wenn requiredQuality auf „MEDIUM“ gesetzt ist. Wenn „true“ festgelegt ist, wird requiredQuality als die exakt erforderliche Qualität interpretiert und es werden nur Bilder mit der Qualität MEDIUM zurückgegeben, wenn requiredQuality auf MEDIUM festgelegt ist.

experiments[]

enum (Experiment)

Optional. Gibt die pre-GA-Tests an, die aktiviert werden sollen. Anfragen, die dieses Feld verwenden, werden gemäß den dienstspezifischen Nutzungsbedingungen für die Google Maps Platform als Pre-GA-Angebot klassifiziert. Weitere Informationen finden Sie unter Beschreibungen der Startphase.

additionalInsights[]

enum (AdditionalInsights)

Optional. Eine Liste der additionalInsights, die in die Antwort aufgenommen werden sollen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für Solar.FindClosestBuildingInsights. Informationen zu Standort, Abmessungen und Solarpotenzial eines Gebäudes.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "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)
  }
}
Felder
name

string

Der Ressourcenname für das Gebäude im Format buildings/{place_id}.

center

object (LatLng)

Ein Punkt in der Nähe der Mitte des Gebäudes.

boundingBox

object (LatLngBox)

Der Begrenzungsrahmen des Gebäudes.

imageryDate

object (Date)

Datum, an dem die zugrunde liegenden Bilder aufgenommen wurden. Dies ist ein Näherungswert.

imageryProcessedDate

object (Date)

Wann die Verarbeitung dieser Bilder abgeschlossen wurde.

postalCode

string

Postleitzahl (z.B. US-Postleitzahl), in der sich das Gebäude befindet.

administrativeArea

string

Die Verwaltungseinheit 1 (z.B. in den USA der Bundesstaat), in der sich dieses Gebäude befindet. In den USA kann die Abkürzung beispielsweise „MA“ oder „CA“ lauten.

statisticalArea

string

Statistisches Gebiet (z.B. US-Zählbezirk), in dem sich dieses Gebäude befindet.

regionCode

string

Regionscode für das Land (oder die Region), in dem sich dieses Gebäude befindet.

solarPotential

object (SolarPotential)

Solarpotenzial des Gebäudes.

imageryQuality

enum (ImageryQuality)

Die Qualität der Bilder, die zum Berechnen der Daten für dieses Gebäude verwendet wurden.

detectedArrays

object (DetectedArrays)

Auf dem Gebäude erkannte Solaranlagen. Dieses Feld wird nur ausgefüllt, wenn DETECTED_ARRAYS in der FindClosestBuildingInsightsRequest.additional_insights der Anfrage enthalten ist.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

AdditionalInsights

Zusätzliche Gebäudeinformationen wie Dachgeometrie und Solarmodulfelder, die in BuildingInsights zurückgegeben werden können.

Enums
ADDITIONAL_INSIGHTS_UNSPECIFIED Der Standardwert. Die Standard-BuildingInsights werden zurückgegeben.
DETECTED_ARRAYS

Legt fest, ob die Antwort die erkannten Arrays enthält.

Wenn angegeben, wird das Feld detectedArrays in der Antwort ausgefüllt.

LatLngBox

Ein Begrenzungsrahmen in Breiten-/Längengradkoordinaten.

JSON-Darstellung
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
Felder
sw

object (LatLng)

Die südwestliche Ecke des Rechtecks.

ne

object (LatLng)

Die Nordostecke des Rechtecks.

SolarPotential

Informationen zum Solarpotenzial eines Gebäudes. Eine Reihe von Feldern in diesem Bereich wird in Bezug auf „Bereiche“ definiert. Die Felder panelCapacityWatts, panelHeightMeters und panelWidthMeters beschreiben die Parameter des Modells des Panels, das für diese Berechnungen verwendet wird.

JSON-Darstellung
{
  "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)
    }
  ]
}
Felder
maxArrayPanelsCount

integer

Größe des maximalen Arrays, d. h. die maximale Anzahl von Modulen, die auf dem Dach Platz finden.

panelCapacityWatts

number

Kapazität des in den Berechnungen verwendeten Panels in Watt.

panelHeightMeters

number

Höhe des für die Berechnungen verwendeten Panels in Metern im Hochformat.

panelWidthMeters

number

Breite des für die Berechnungen verwendeten Panels im Hochformat in Metern.

panelLifetimeYears

integer

Die voraussichtliche Lebensdauer der Solarmodule in Jahren. Dieser Wert wird in den Finanzberechnungen verwendet.

maxArrayAreaMeters2

number

Größe des maximalen Arrays in Quadratmetern.

maxSunshineHoursPerYear

number

Die maximale Anzahl an Sonnenstunden pro Jahr, die an einem beliebigen Punkt auf dem Dach erreicht werden. Die Sonnenscheindauer ist ein Maß für die Gesamtmenge an Sonneneinstrahlung (Energie), die pro Jahr empfangen wird. 1 Sonnenstunde = 1 kWh pro kW (wobei sich kW auf die Kapazität unter Standardtestbedingungen bezieht).

carbonOffsetFactorKgPerMwh

number

Entsprechende Menge an CO2, die pro MWh Netzstrom produziert wird. Dies ist ein Maß für die CO₂-Intensität des Netzstroms, der durch Solarstrom ersetzt wird.

wholeRoofStats

object (SizeAndSunshineStats)

Gesamtgröße und Sonnenlichtquantilen für den Teil des Daches, der einem Dachsegment zugewiesen wurde. Trotz des Namens ist damit möglicherweise nicht das gesamte Gebäude gemeint. buildingStats ansehen.

buildingStats

object (SizeAndSunshineStats)

Größen- und Sonneneinstrahlungsquantilen für das gesamte Gebäude, einschließlich der Dachteile, die keinem Dachsegment zugewiesen wurden. Da die Ausrichtungen dieser Teile nicht gut charakterisiert sind, ist die Schätzung der Dachfläche unzuverlässig, die Schätzung der Grundfläche jedoch zuverlässig. Möglicherweise lässt sich eine zuverlässigere Dachfläche für das gesamte Gebäude ermitteln, indem die Dachfläche von wholeRoofStats mit dem Verhältnis der Grundflächen von buildingStats und wholeRoofStats skaliert wird.

roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

Größen- und Sonneneinstrahlungsquantilen für jedes Dachsegment.

solarPanels[]

object (SolarPanel)

Jedes SolarPanel beschreibt ein einzelnes Solarmodul. Sie werden in der Reihenfolge aufgeführt, in der sie vom Algorithmus für das Bereichslayout platziert wurden. Dies erfolgt in der Regel, aber nicht immer, in absteigender Reihenfolge der jährlichen Energieerzeugung.

solarPanelConfigs[]

object (SolarPanelConfig)

Jede SolarPanelConfig beschreibt eine andere Anordnung von Sonnenkollektoren auf dem Dach. Sie sind nach aufsteigender Anzahl von Feldern sortiert. Die SolarPanelConfig mit panelsCount=N basiert auf den ersten N Panels in der Liste solarPanels. Dieses Feld wird nur ausgefüllt, wenn mindestens vier Module auf ein Dach passen.

financialAnalyses[]

object (FinancialAnalysis)

Ein FinancialAnalysis gibt die Einsparungen durch Solarenergie an, basierend auf einer bestimmten monatlichen Rechnung und einem bestimmten Stromanbieter. Sie sind nach dem monatlichen Rechnungsbetrag in aufsteigender Reihenfolge sortiert. Dieses Feld ist für Gebäude in Gebieten leer, für die die Solar API nicht genügend Informationen für finanzielle Berechnungen hat.

SizeAndSunshineStats

Größen- und Sonnenscheinquantilen eines Daches oder eines Teils eines Daches.

JSON-Darstellung
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
Felder
areaMeters2

number

Die Fläche des Daches oder Dachsegments in Quadratmetern. Das ist die Dachfläche (unter Berücksichtigung der Neigung), nicht die Grundfläche.

sunshineQuantiles[]

number

Quantile der punktweisen Sonnenscheindauer im gesamten Gebiet. Wenn hier N Werte vorhanden sind, werden die (N-1)-ile dargestellt. Wenn es beispielsweise fünf Werte gibt, sind das die Quartile (Min., 25%, 50%, 75%, Max.). Die Werte werden in jährlichen kWh/kW wie maxSunshineHoursPerYear angegeben.

groundAreaMeters2

number

Die vom Dach oder Dachsegment abgedeckte Grundfläche in Quadratmetern.

RoofSegmentSizeAndSunshineStats

Informationen zu den Größen- und Sonnenscheinquantilen eines Dachsegments.

JSON-Darstellung
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
Felder
stats

object (SizeAndSunshineStats)

Gesamtgröße und Sonnenlicht-Quantile für das Dachsegment.

center

object (LatLng)

Ein Punkt in der Nähe der Mitte des Dachsegments.

boundingBox

object (LatLngBox)

Der Begrenzungsrahmen des Dachsegments.

pitchDegrees

number

Winkel des Dachsegments relativ zur theoretischen Grundebene. 0 = parallel zum Boden, 90 = senkrecht zum Boden.

azimuthDegrees

number

Kompassrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Bei einem „flachen“ Dachsegment (pitchDegrees sehr nahe 0) ist der Azimut nicht genau definiert. Aus Konsistenzgründen definieren wir ihn daher willkürlich als 0 (Norden).

planeHeightAtCenterMeters

number

Die Höhe der Dachebene in Metern über dem Meeresspiegel am Punkt center. Zusammen mit dem Neigungswinkel, dem Azimut und der Mittelpunktposition wird damit die Ebene des Dachsegments vollständig definiert.

SolarPanel

SolarPanel beschreibt die Position, Ausrichtung und Produktion eines einzelnen Solarmoduls. Informationen zu den Parametern des Bereichs finden Sie in den Feldern panelHeightMeters, panelWidthMeters und panelCapacityWatts in SolarPotential.

JSON-Darstellung
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
Felder
center

object (LatLng)

Die Mitte des Bereichs.

orientation

enum (SolarPanelOrientation)

Die Ausrichtung des Panels.

yearlyEnergyDcKwh

number

Wie viel Sonnenenergie mit diesem Layout im Laufe eines Jahres in DC-kWh erfasst wird.

segmentIndex

integer

Index in roofSegmentStats des RoofSegmentSizeAndSunshineStats, der dem Dachsegment entspricht, auf dem dieses Modul platziert ist.

SolarPanelOrientation

Die Ausrichtung eines Solarmoduls. Dies muss relativ zum Azimut des Dachsegments interpretiert werden, auf dem das Modul platziert ist.

Enums
SOLAR_PANEL_ORIENTATION_UNSPECIFIED Es ist keine Ausrichtung des Panels bekannt.
LANDSCAPE Bei einem LANDSCAPE-Modul verläuft die lange Kante senkrecht zur Azimutrichtung des Dachsegments, auf dem es platziert ist.
PORTRAIT Bei einem PORTRAIT-Modul verläuft die lange Kante parallel zur Azimutrichtung des Dachsegments, auf dem es platziert wird.

SolarPanelConfig

SolarPanelConfig beschreibt eine bestimmte Anordnung von Solarmodulen auf dem Dach.

JSON-Darstellung
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
Felder
panelsCount

integer

Gesamtzahl der Panels. Hinweis: Dies ist redundant zu (der Summe der) entsprechenden Feldern in roofSegmentSummaries.

yearlyEnergyDcKwh

number

Wie viel Sonnenenergie in diesem Layout im Laufe eines Jahres in DC-kWh erfasst wird, unter der Annahme der oben beschriebenen Module.

roofSegmentSummaries[]

object (RoofSegmentSummary)

Informationen zur Produktion der einzelnen Dachsegmente, auf denen in diesem Layout mindestens ein Modul angebracht ist. roofSegmentSummaries[i] beschreibt das i-te Dachsegment, einschließlich seiner Größe, der erwarteten Produktion und der Ausrichtung.

RoofSegmentSummary

Informationen zu einem Dachsegment des Gebäudes, auf dem eine bestimmte Anzahl von Modulen angebracht ist.

JSON-Darstellung
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
Felder
panelsCount

integer

Die Gesamtzahl der Bereiche in diesem Segment.

yearlyEnergyDcKwh

number

Wie viel Sonnenenergie dieser Teil des Layouts im Laufe eines Jahres in Gleichstrom-kWh aufnimmt, unter der Annahme der oben beschriebenen Module.

pitchDegrees

number

Winkel des Dachsegments relativ zur theoretischen Grundebene. 0 = parallel zum Boden, 90 = senkrecht zum Boden.

azimuthDegrees

number

Kompassrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Bei einem „flachen“ Dachsegment (pitchDegrees sehr nahe 0) ist der Azimut nicht genau definiert. Aus Konsistenzgründen definieren wir ihn daher willkürlich als 0 (Norden).

segmentIndex

integer

Index in roofSegmentStats des entsprechenden RoofSegmentSizeAndSunshineStats.

FinancialAnalysis

Analyse der Kosten und Vorteile des optimalen Solarlayouts für eine bestimmte Stromrechnungsgröße.

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

object (Money)

Die monatliche Stromrechnung, die dieser Analyse zugrunde liegt.

defaultBill

boolean

Gibt an, ob diese Rechnung die Standardrechnung für das Gebiet ist, in dem sich das Gebäude befindet. Genau ein FinancialAnalysis in BuildingSolarPotential sollte auf defaultBill gesetzt sein.

averageKwhPerMonth

number

Wie viel Strom das Haus in einem durchschnittlichen Monat verbraucht, basierend auf der Höhe der Rechnung und den lokalen Strompreisen.

financialDetails

object (FinancialDetails)

Finanzinformationen, die unabhängig von der verwendeten Finanzierungsmethode gelten.

leasingSavings

object (LeasingSavings)

Kosten und Vorteile des Leasings der Solarmodule.

cashPurchaseSavings

object (CashPurchaseSavings)

Kosten und Nutzen des Kaufs der Solarmodule mit Bargeld.

financedPurchaseSavings

object (FinancedPurchaseSavings)

Kosten und Vorteile des Kaufs der Solarmodule durch Finanzierung des Kaufs.

panelConfigIndex

integer

Index in solarPanelConfigs des optimalen Solarlayouts für diese Rechnungssumme. Das kann -1 sein, was darauf hinweist, dass kein Layout vorhanden ist. In diesem Fall werden die verbleibenden untergeordneten Nachrichten ausgelassen.

Geld

Stellt einen Geldbetrag mit Währungstyp dar.

JSON-Darstellung
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Felder
currencyCode

string

Der aus drei Buchstaben bestehende Währungscode gemäß ISO 4217

units

string (int64 format)

Die ganzen Einheiten des Betrags. Beispiel: Wenn currencyCode "USD" ist, dann entspricht eine Einheit 1 US-Dollar.

nanos

integer

Anzahl der Nanoeinheiten (10^-9) des Betrags. Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen. Wenn units positiv ist, muss nanos positiv oder null sein. Wenn units null ist, kann nanos positiv, null oder negativ sein. Wenn units negativ ist, muss nanos negativ oder null sein. -1,75 $ wird z. B. als units = −1 und nanos = −750.000.000 dargestellt.

FinancialDetails

Details einer Finanzanalyse. Einige dieser Details sind bereits auf höheren Ebenen gespeichert, z.B. die Selbstbeteiligung. Die Gesamtbeträge beziehen sich auf einen Zeitraum, der durch das Feld panelLifetimeYears in SolarPotential definiert wird. Hinweis: Die Kosten für den Kauf der Panels sind im Feld outOfPocketCost in CashPurchaseSavings angegeben.

JSON-Darstellung
{
  "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
}
Felder
initialAcKwhPerYear

number

Wie viele AC-kWh die Solarmodule im ersten Jahr voraussichtlich erzeugen werden.

remainingLifetimeUtilityBill

object (Money)

Stromrechnung für Strom, der nicht durch Solarenergie erzeugt wurde, für die Lebensdauer der Module.

federalIncentive

object (Money)

Der Betrag, der durch staatliche Anreize verfügbar ist. Dies gilt, wenn der Nutzer die Solarmodule kauft (mit oder ohne Darlehen).

stateIncentive

object (Money)

Betrag der staatlichen Anreize; dies gilt, wenn der Nutzer die Solarmodule kauft (mit oder ohne Darlehen).

utilityIncentive

object (Money)

Geldbetrag, der durch Anreize von Versorgungsunternehmen verfügbar ist. Dies gilt, wenn der Nutzer die Solarmodule kauft (mit oder ohne Darlehen).

lifetimeSrecTotal

object (Money)

Der Geldbetrag, den der Nutzer über die Lebensdauer der Solaranlage durch Zertifikate für erneuerbare Energie erhält. Dies gilt, wenn der Nutzer die Solaranlage kauft (mit oder ohne Kredit).

costOfElectricityWithoutSolar

object (Money)

Die Gesamtkosten für Strom, die der Nutzer über den gesamten Zeitraum gezahlt hätte, wenn er keine Solaranlage installiert hätte.

netMeteringAllowed

boolean

Gibt an, ob Net-Metering zulässig ist.

solarPercentage

number

Prozentsatz (0–100) des Stroms, der vom Nutzer durch Solarenergie erzeugt wird. Gültig für das erste Jahr, aber ungefähr richtig für die Folgejahre.

percentageExportedToGrid

number

Der Prozentsatz (0–100) der Solarstromerzeugung, der unserer Annahme nach in das Netz eingespeist wurde, basierend auf dem ersten Produktionsquartal. Das wirkt sich auf die Berechnungen aus, wenn Net-Metering nicht zulässig ist.

LeasingSavings

Kosten und Vorteile des Leasings einer bestimmten Konfiguration von Solarmodulen bei einem bestimmten Stromverbrauch.

JSON-Darstellung
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
Felder
leasesAllowed

boolean

Ob Leasing in dieser Gerichtsbarkeit zulässig ist (Leasing ist in einigen Bundesstaaten nicht zulässig). Wenn dieses Feld „false“ ist, sollten die Werte in dieser Nachricht wahrscheinlich ignoriert werden.

leasesSupported

boolean

Gibt an, ob Leasing in dieser Gerichtsbarkeit von der Finanzberechnungs-Engine unterstützt wird. Wenn dieses Feld „false“ ist, sollten die Werte in dieser Nachricht wahrscheinlich ignoriert werden. Dies ist unabhängig von leasesAllowed: In einigen Gebieten sind Leasingverträge zulässig, jedoch unter Bedingungen, die nicht von den Finanzmodellen abgedeckt werden.

annualLeasingCost

object (Money)

Geschätzte jährliche Leasingkosten.

savings

object (SavingsOverTime)

Wie viel über den gesamten Zeitraum hinweg eingespart wurde (oder nicht).

SavingsOverTime

Finanzinformationen, die zwischen verschiedenen Finanzierungsmethoden geteilt werden.

JSON-Darstellung
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
Felder
savingsYear1

object (Money)

Einsparungen im ersten Jahr nach der Installation der Solaranlage.

savingsYear20

object (Money)

Einsparungen in den ersten 20 Jahren nach der Installation der Solaranlage.

presentValueOfSavingsYear20

object (Money)

Wie hoch ist der Barwert der kumulativen Einsparungen über 20 Jahre bei dem angenommenen Abzinsungssatz?

savingsLifetime

object (Money)

Einsparungen über die gesamte Lebensdauer des Panels.

presentValueOfSavingsLifetime

object (Money)

Wie hoch ist der Barwert der kumulativen Einsparungen über die gesamte Lebensdauer unter Verwendung des angenommenen Abzinsungssatzes?

financiallyViable

boolean

Gibt an, ob dieses Szenario finanziell tragfähig ist. Ist für Szenarien mit geringer finanzieller Leistungsfähigkeit (z.B. Verluste) falsch.

CashPurchaseSavings

Kosten und Nutzen eines direkten Kaufs einer bestimmten Konfiguration von Solarmodulen bei einem bestimmten Stromverbrauch.

JSON-Darstellung
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
Felder
outOfPocketCost

object (Money)

Anschaffungskosten vor Steueranreizen: der Betrag, der aus eigener Tasche bezahlt werden muss. Im Gegensatz dazu wird bei upfrontCost der Effekt von Steueranreizen berücksichtigt.

upfrontCost

object (Money)

Anfangskosten nach Steuervorteilen: Das ist der Betrag, der im ersten Jahr bezahlt werden muss. Im Gegensatz dazu steht outOfPocketCost, das vor Steueranreizen liegt.

rebateValue

object (Money)

Der Wert aller Steuerrabatte.

savings

object (SavingsOverTime)

Wie viel über den gesamten Zeitraum hinweg eingespart wurde (oder nicht).

paybackYears

number

Anzahl der Jahre bis zur Amortisierung. Ein negativer Wert bedeutet, dass sich die Investition innerhalb des Lebenszyklus nie amortisiert.

FinancedPurchaseSavings

Kosten und Vorteile der Aufnahme eines Darlehens für den Kauf einer bestimmten Konfiguration von Solarmodulen bei einem bestimmten Stromverbrauch.

JSON-Darstellung
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
Felder
annualLoanPayment

object (Money)

Jährliche Kredit-/Darlehenszahlungen.

rebateValue

object (Money)

Der Wert aller Steuererleichterungen, einschließlich des Federal Investment Tax Credit (ITC).

loanInterestRate

number

Der Zinssatz für Darlehen, der in dieser Berechnung zugrunde gelegt wird.

savings

object (SavingsOverTime)

Wie viel über den gesamten Zeitraum hinweg eingespart wurde (oder nicht).

DetectedArrays

Informationen zu Solaranlagen, die auf dem Gebäude erkannt wurden.

JSON-Darstellung
{
  "detectionStatus": enum (DetectionStatus),
  "latestCaptureDate": {
    object (Date)
  }
}
Felder
detectionStatus

enum (DetectionStatus)

Gibt den Erkennungsstatus von Solaranlagen für dieses Gebäude an.

latestCaptureDate

object (Date)

Das Datum, an dem die letzten Daten zum Solarmodul erfasst wurden.

DetectionStatus

Gibt den Erkennungsstatus von Solaranlagen für dieses Gebäude an.

Enums
DETECTION_STATUS_UNSPECIFIED Nicht angegebener Status
DETECTION_STATUS_DATA_UNAVAILABLE Für dieses Gebäude sind keine Daten zu erkannten Solaranlagen verfügbar.
DETECTION_STATUS_ARRAYS_DETECTED Für dieses Gebäude wurde mindestens eine Solaranlage erkannt.
DETECTION_STATUS_NO_ARRAYS_DETECTED Für dieses Gebäude wurden keine Solaranlagen erkannt.