Method: buildingInsights.findClosest

Sucht das Gebäude, dessen Schwerpunkt einem Abfragepunkt am nächsten liegt. Gibt einen Fehler mit dem Code NOT_FOUND zurück, wenn sich im Umkreis von etwa 50 m um den Abfragepunkt 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 zulässige Mindestqualitätsstufe in den Ergebnissen. Es werden keine Ergebnisse mit einer geringeren Qualität zurückgegeben. Wenn Sie dies nicht angeben, wird die Qualität auf „HOCH“ beschränkt.
exactQualityRequired

boolean

Optional. Gibt an, ob die genaue Qualität der Bilder erforderlich ist. Wenn „false“ festgelegt ist, wird das Feld requiredQuality als die mindestens erforderliche Qualität interpretiert. Wenn requiredQuality auf MEDIUM festgelegt ist, können also Bilder mit hoher Qualität zurückgegeben werden. Wenn „true“ festgelegt ist, wird requiredQuality als die genaue 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 von 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 ungefährer Wert.
imageryProcessedDate

object (Date)

Wann die Verarbeitung dieser Bilder abgeschlossen wurde.
postalCode

string

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

string

Verwaltungsgebiet 1 (z.B. in den USA der Bundesstaat), in dem sich dieses Gebäude befindet. In den USA könnte 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

Ländercode 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 zur Berechnung 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 im 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 Solarmodul-Arrays, die in BuildingInsights zurückgegeben werden können.

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

Bestimmt, ob die Antwort die erkannten Arrays enthält.

Falls 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 Felds.
ne

object (LatLng)

Die nordöstliche Ecke des Felds.

SolarPotential

Informationen zum Solarpotenzial eines Gebäudes. Eine Reihe von Feldern in diesem Bereich wird in Form von „Bereichen“ definiert. In den Feldern panelCapacityWatts, panelHeightMeters und panelWidthMeters werden die Parameter des Solarmodulmodells beschrieben, 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 der maximalen Anlage, d. h. die maximale Anzahl von Solarmodulen, die auf das Dach passen.
panelCapacityWatts

number

Kapazität des Solarmoduls in Watt, die in den Berechnungen verwendet wird.
panelHeightMeters

number

Höhe des Solarmoduls in Metern im Hochformat, die in den Berechnungen verwendet wird.
panelWidthMeters

number

Breite des Moduls in Metern im Hochformat, die für die Berechnungen verwendet wird.
panelLifetimeYears

integer

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

number

Größe des maximalen Arrays in Quadratmetern.
maxSunshineHoursPerYear

number

Maximale Anzahl der Sonnenstunden pro Jahr, die ein beliebiger Punkt auf dem Dach erhält. Die Sonnenstunden sind ein Maß für die Gesamtmenge der Sonneneinstrahlung (Energie) pro Jahr. 1 Sonnenstunde = 1 kWh pro kW (wobei sich kW auf die Kapazität in kW unter Standardtestbedingungen bezieht).
carbonOffsetFactorKgPerMwh

number

Äquivalente Menge an CO₂ pro MWh Netzstrom. 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 Dachs, 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 Teile des Dachs, die keinem Dachsegment zugewiesen wurden. Da die Ausrichtung dieser Teile nicht genau bestimmt werden kann, ist die Schätzung der Dachfläche unzuverlässig, die Schätzung der Bodenflä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 Sonneneinstrahlungsquantile 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 Layout des Bereichs platziert wurden. Dies geschieht in der Regel, wenn auch nicht immer, in absteigender Reihenfolge der jährlichen Energieerzeugung.
solarPanelConfigs[]

object (SolarPanelConfig)

Jedes SolarPanelConfig beschreibt eine andere Anordnung von Solarmodulen auf dem Dach. Sie sind nach der Anzahl der Module sortiert. Der SolarPanelConfig mit panelsCount=N basiert auf den ersten N Panels in der Liste solarPanels. Dieses Feld wird nur ausgefüllt, wenn mindestens 4 Solarmodule auf ein Dach passen.
financialAnalyses[]

object (FinancialAnalysis)

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

SizeAndSunshineStats

Quantile für Größe und Sonneneinstrahlung eines Dachs oder eines Teils eines Dachs.

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

number

Die Fläche des Dachs oder Dachsegments in m². Dies ist die Dachfläche (unter Berücksichtigung der Neigung), nicht die Grundfläche.
sunshineQuantiles[]

number

Quantile der punktuellen Sonnigkeit im Gebiet. Wenn hier N Werte vorhanden sind, entspricht dies den (N-1)-ilen. Wenn es beispielsweise 5 Werte gibt, sind dies die Quartile (Min, 25 %, 50 %, 75 %, Max). Die Werte werden in kWh/kW pro Jahr angegeben, z. B. maxSunshineHoursPerYear.
groundAreaMeters2

number

Die Grundfläche, die vom Dach oder Dachsegment bedeckt wird, in m².

RoofSegmentSizeAndSunshineStats

Informationen zur Größe und zu den Sonneneinstrahlungsquantilen 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 Sonneneinstrahlungsquantile 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 Bodenebene. 0 = parallel zum Boden, 90 = senkrecht zum Boden.
azimuthDegrees

number

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

number

Die Höhe der Dachsegmentebene in Metern über dem Meeresspiegel an dem durch center angegebenen Punkt. Zusammen mit der Neigung, dem Azimut und der Mittelpunktposition wird so 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 Panels.
orientation

enum (SolarPanelOrientation)

Die Ausrichtung des Bereichs.
yearlyEnergyDcKwh

number

Wie viel Sonnenenergie dieses Layout im Laufe eines Jahres in DC-kWh erfasst.
segmentIndex

integer

Index in roofSegmentStats des RoofSegmentSizeAndSunshineStats, das dem Dachsegment entspricht, auf dem dieses Solarmodul platziert ist.

SolarPanelOrientation

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

Enums
SOLAR_PANEL_ORIENTATION_UNSPECIFIED Die Ausrichtung des Solarmoduls ist nicht bekannt.
LANDSCAPE Die lange Kante eines LANDSCAPE-Moduls verläuft 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 ist.

SolarPanelConfig

„SolarPanelConfig“ beschreibt eine bestimmte Platzierung von Solarmodulen auf dem Dach.

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

integer

Gesamtzahl der Module. Beachten Sie, dass dies redundant zu (der Summe der) entsprechenden Felder in roofSegmentSummaries ist.
yearlyEnergyDcKwh

number

Wie viel Sonnenenergie dieses Layout im Laufe eines Jahres in kWh (Gleichstrom) erfasst, wenn die oben beschriebenen Module verwendet werden.
roofSegmentSummaries[]

object (RoofSegmentSummary)

Informationen zur Produktion der einzelnen Dachsegmente, die in diesem Layout mindestens ein Solarmodul tragen. 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 Solarmodulen platziert 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 kWh (Gleichstrom) einfängt, wenn die oben beschriebenen Module verwendet werden.
pitchDegrees

number

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

number

Himmelsrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Bei einem „flachen“ Dachsegment (pitchDegrees sehr nahe bei 0) ist der Azimut nicht genau definiert. Aus Gründen der Konsistenz definieren wir ihn 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 Stromrechnungshöhe.

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 Rechnungsgröße als Standardrechnung für das Gebiet ausgewählt wurde, in dem sich dieses Gebäude befindet. In BuildingSolarPotential sollte genau ein FinancialAnalysis-Element mit defaultBill festgelegt 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)

Finanzielle Informationen, die unabhängig von der verwendeten Finanzierungsmethode gelten.
leasingSavings

object (LeasingSavings)

Kosten und Nutzen des Leasings der Solarmodule.
cashPurchaseSavings

object (CashPurchaseSavings)

Kosten und Nutzen des Kaufs von Solarmodulen mit Bargeld.
financedPurchaseSavings

object (FinancedPurchaseSavings)

Kosten und Nutzen des Kaufs von Solarmodulen durch Finanzierung.
panelConfigIndex

integer

Index in solarPanelConfigs des optimalen Solarlayouts für diese Rechnungsgröße. Dieser Wert kann -1 sein, was bedeutet, dass kein Layout vorhanden ist. In diesem Fall werden die verbleibenden Unternachrichten weggelassen.

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. Wenn currencyCode beispielsweise "USD" ist, entspricht 1 Einheit einem 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. Beispiel: -1,75 $ wird 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. Selbstbeteiligung). Die Gesamtgeldbeträge beziehen sich auf einen Zeitraum, der durch das Feld panelLifetimeYears in SolarPotential definiert wird. Hinweis: Die Anschaffungskosten für die Solarmodule werden 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 kWh AC 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)

Betrag, der durch staatliche Förderungen verfügbar ist. Dies gilt, wenn der Nutzer die Solarmodule kauft (mit oder ohne Kredit).
stateIncentive

object (Money)

Betrag, der durch staatliche Förderungen verfügbar ist. Dies gilt, wenn der Nutzer die Solarmodule kauft (mit oder ohne Kredit).
utilityIncentive

object (Money)

Betrag, der durch Förderprogramme des Energieversorgers verfügbar ist. Dies gilt, wenn der Nutzer die Solarmodule kauft (mit oder ohne Kredit).
lifetimeSrecTotal

object (Money)

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

object (Money)

Gesamtkosten für Strom, die der Nutzer während der Laufzeit bezahlt 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 des Nutzers, der durch Solarenergie bereitgestellt wird. Gültig für das erste Jahr, aber ungefähr korrekt für zukünftige Jahre.
percentageExportedToGrid

number

Der Prozentsatz (0–100) der Solarstromerzeugung, der im ersten Quartal der Produktion in das Netz eingespeist wurde. Dies wirkt sich auf die Berechnungen aus, wenn Net-Metering nicht zulässig ist.

LeasingSavings

Kosten und Nutzen 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

Gibt an, ob Leasing in diesem Land zulässig ist (in einigen Bundesstaaten ist Leasing 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 Mietverträge zulässig, aber unter Bedingungen, die von den Finanzmodellen nicht berücksichtigt werden.
annualLeasingCost

object (Money)

Geschätzte jährliche Leasingkosten.
savings

object (SavingsOverTime)

Wie viel während der Laufzeit gespart wird (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 Solarmodule.
savingsYear20

object (Money)

Einsparungen in den ersten 20 Jahren nach der Installation der Solarmodule.
presentValueOfSavingsYear20

object (Money)

Wie hoch ist der Barwert der kumulierten Einsparungen über 20 Jahre, wenn der angenommene Abzinsungssatz verwendet wird?
savingsLifetime

object (Money)

Einsparungen während der gesamten Lebensdauer des Panels.
presentValueOfSavingsLifetime

object (Money)

Wie hoch ist der Barwert der kumulierten Einsparungen über die Lebensdauer, wenn der angenommene Abzinsungssatz verwendet wird?
financiallyViable

boolean

Gibt an, ob dieses Szenario finanziell tragfähig ist. Ist „false“ für Szenarien mit schlechter finanzieller Leistungsfähigkeit (z.B. Verlustgeschäfte).

CashPurchaseSavings

Kosten und Nutzen des 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)

Anfangskosten vor Steuervergünstigungen: der Betrag, der aus eigener Tasche bezahlt werden muss. Im Gegensatz zu upfrontCost, bei dem Steuervergünstigungen berücksichtigt werden.
upfrontCost

object (Money)

Anfangskosten nach Steuervergünstigungen: Dies ist der Betrag, der im ersten Jahr gezahlt werden muss. Im Gegensatz zu outOfPocketCost, das vor Steuern liegt.
rebateValue

object (Money)

Der Wert aller Steuererstattungen.
savings

object (SavingsOverTime)

Wie viel während der Laufzeit gespart wird (oder nicht).
paybackYears

number

Anzahl der Jahre bis zur Amortisierung. Ein negativer Wert bedeutet, dass die Amortisation innerhalb der Laufzeit nie erreicht wird.

FinancedPurchaseSavings

Kosten und Nutzen eines Kredits 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 Kreditzahlungen.
rebateValue

object (Money)

Der Wert aller Steuergutschriften (einschließlich der Federal Investment Tax Credit (ITC)).
loanInterestRate

number

Der Zinssatz für Darlehen, der in diesen Berechnungen angenommen wird.
savings

object (SavingsOverTime)

Wie viel während der Laufzeit gespart wird (oder nicht).

DetectedArrays

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

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

enum (DetectionStatus)

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

object (SolarArray)

Eine Liste der auf dem Gebäude erkannten Solaranlagen.
latestCaptureDate

object (Date)

Das Datum, an dem die neuesten Solaranlagendaten 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.

SolarArray

Details zu einer einzelnen erkannten Solaranlage.

JSON-Darstellung 
{
  "polygonGeojson": {
    object
  }
}
Felder
polygonGeojson

object (Struct format)

Eine GeoJSON-Darstellung des Gebäudebereichs, in dem Solarmodule erkannt wurden.

Die GeoJSON-Daten müssen im RFC 7946-Format vorliegen und ein Polygon für einen einzelnen zusammenhängenden Bereich darstellen.

Das Polygon wird durch mehrere Schleifen dargestellt, wenn es Löcher enthält.

Beispiel:

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