- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Geld
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Testen!
Sucht das Gebäude, dessen Schwerpunkt dem Abfragepunkt am nächsten ist. Gibt einen Fehler mit dem Code NOT_FOUND zurück, wenn sich im Umkreis von etwa 50 Metern 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 |
Erforderlich. Der Längen- und Breitengrad, von dem aus die API nach dem nächstgelegenen bekannten Gebäude sucht. |
requiredQuality |
Optional. Die zulässige Mindestqualitä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 |
Optional. Gibt an, ob eine genaue Qualität der Bilder erforderlich ist. Wenn der Wert auf „false“ gesetzt ist, wird das Feld |
experiments[] |
Optional. Gibt die Pre‑GA-Funktionen an, die aktiviert 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 ( |
| Felder | |
|---|---|
name |
Der Ressourcenname für das Gebäude im Format |
center |
Ein Punkt in der Nähe der Mitte des Gebäudes. |
boundingBox |
Der Begrenzungsrahmen des Gebäudes. |
imageryDate |
Datum, an dem die zugrunde liegenden Bilder aufgenommen wurden. Das ist eine Schätzung. |
imageryProcessedDate |
Wann die Verarbeitung dieser Bilder abgeschlossen wurde. |
postalCode |
Postleitzahl (z.B. US-Postleitzahl, in der sich das Gebäude befindet. |
administrativeArea |
Die Verwaltungseinheit der Ebene 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 |
Statistischer Bereich (z.B. US-Zensus-Erhebungsgebiet, in dem sich das Gebäude befindet. |
regionCode |
Der Regionscode für das Land (oder die Region), in dem sich das Gebäude befindet. |
solarPotential |
Solarpotenzial des Gebäudes. |
imageryQuality |
Die Qualität der Bilder, die zum Berechnen der Daten für dieses Gebäude verwendet wurden. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
Ein Begrenzungsrahmen in Breiten-/Längengradkoordinaten.
| JSON-Darstellung |
|---|
{ "sw": { object ( |
| Felder | |
|---|---|
sw |
Die südwestliche Ecke des Rechtecks. |
ne |
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 ( |
| Felder | |
|---|---|
maxArrayPanelsCount |
Größe des maximalen Arrays, d. h. die maximale Anzahl von Modulen, die auf dem Dach Platz finden. |
panelCapacityWatts |
Kapazität des in den Berechnungen verwendeten Panels in Watt. |
panelHeightMeters |
Höhe des für die Berechnungen verwendeten Panels in Metern im Hochformat. |
panelWidthMeters |
Breite des für die Berechnungen verwendeten Panels im Hochformat in Metern. |
panelLifetimeYears |
Die voraussichtliche Lebensdauer der Solarmodule in Jahren. Dieser Wert wird in den Finanzberechnungen verwendet. |
maxArrayAreaMeters2 |
Größe des maximalen Arrays in Quadratmetern. |
maxSunshineHoursPerYear |
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 |
Entsprechende Menge an CO2, die pro MWh Netzstrom produziert wird. Dies ist ein Maß für die Kohlenstoffintensität des Netzstroms, der durch Solarstrom ersetzt wird. |
wholeRoofStats |
Gesamtgröße und Sonnenlicht-Quantile für den Teil des Daches, der einem Dachsegment zugewiesen wurde. Trotz des Namens muss das nicht das gesamte Gebäude umfassen. |
buildingStats |
Größen- und Sonneneinstrahlungsquantilen für das gesamte Gebäude, einschließlich der Teile des Daches, 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 |
roofSegmentStats[] |
Größen- und Sonneneinstrahlungsquantilen für jedes Dachsegment. |
solarPanels[] |
Jedes |
solarPanelConfigs[] |
Jede |
financialAnalyses[] |
Ein |
SizeAndSunshineStats
Größen- und Sonnenscheinquantilen eines Daches oder eines Teils eines Daches.
| JSON-Darstellung |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| Felder | |
|---|---|
areaMeters2 |
Die Fläche des Daches oder Dachsegments in Quadratmetern. Das ist die Dachfläche (unter Berücksichtigung der Neigung), nicht die Grundfläche. |
sunshineQuantiles[] |
Quantile der punktweisen Sonnenscheindauer im gesamten Gebiet. Wenn hier N Werte vorhanden sind, werden die (N-1)-Ilen 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 |
groundAreaMeters2 |
Die vom Dach oder Dachsegment abgedeckte Grundfläche in Quadratmetern. |
RoofSegmentSizeAndSunshineStats
Informationen zu den Größen- und Sonnenscheinquantilen eines Dachsegments.
| JSON-Darstellung |
|---|
{ "stats": { object ( |
| Felder | |
|---|---|
stats |
Gesamtgröße und Sonnenlicht-Quantile für das Dachsegment. |
center |
Ein Punkt in der Nähe der Mitte des Dachsegments. |
boundingBox |
Der Begrenzungsrahmen des Dachsegments. |
pitchDegrees |
Winkel des Dachsegments relativ zur theoretischen Grundebene. 0 = parallel zum Boden, 90 = senkrecht zum Boden. |
azimuthDegrees |
Kompassrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Bei einem „flachen“ Dachsegment ( |
planeHeightAtCenterMeters |
Die Höhe der Dachebene in Metern über dem Meeresspiegel am Punkt |
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 ( |
| Felder | |
|---|---|
center |
Die Mitte des Panels. |
orientation |
Die Ausrichtung des Panels. |
yearlyEnergyDcKwh |
Wie viel Sonnenenergie mit diesem Layout im Laufe eines Jahres in Gleichstrom-kWh erfasst wird. |
segmentIndex |
Index in |
SolarPanelOrientation
Die Ausrichtung eines Solarmoduls. Dieser Wert muss relativ zum Azimut des Dachsegments interpretiert werden, auf dem das Modul angebracht 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 ( |
| Felder | |
|---|---|
panelsCount |
Gesamtzahl der Panels. Hinweis: Dies ist redundant zu (der Summe der) entsprechenden Feldern in |
yearlyEnergyDcKwh |
Wie viel Sonnenenergie in diesem Layout im Laufe eines Jahres in DC-kWh erfasst wird, unter der Annahme der oben beschriebenen Module. |
roofSegmentSummaries[] |
Informationen zur Produktion jedes Dachsegments, auf dem in diesem Layout mindestens ein Modul angebracht ist. |
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 |
Die Gesamtzahl der Panels in diesem Segment. |
yearlyEnergyDcKwh |
Wie viel Sonnenenergie dieser Teil des Layouts im Laufe eines Jahres in DC-kWh aufnimmt, unter Berücksichtigung der oben beschriebenen Module. |
pitchDegrees |
Winkel des Dachsegments relativ zur theoretischen Grundebene. 0 = parallel zum Boden, 90 = senkrecht zum Boden. |
azimuthDegrees |
Kompassrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Bei einem „flachen“ Dachsegment ( |
segmentIndex |
Index in |
FinancialAnalysis
Analyse der Kosten und Vorteile des optimalen Solarlayouts für eine bestimmte Stromrechnungsgröße.
| JSON-Darstellung |
|---|
{ "monthlyBill": { object ( |
| Felder | |
|---|---|
monthlyBill |
Die monatliche Stromrechnung, die dieser Analyse zugrunde liegt. |
defaultBill |
Gibt an, ob die ausgewählte Rechnung die Standardrechnung für das Gebiet ist, in dem sich das Gebäude befindet. Genau ein |
averageKwhPerMonth |
Wie viel Strom das Haus in einem durchschnittlichen Monat verbraucht, basierend auf der Höhe der Rechnung und den lokalen Strompreisen. |
financialDetails |
Finanzinformationen, die unabhängig von der verwendeten Finanzierungsmethode gelten. |
leasingSavings |
Kosten und Vorteile des Leasings der Solarmodule. |
cashPurchaseSavings |
Kosten und Nutzen beim Kauf der Solarmodule mit Bargeld. |
financedPurchaseSavings |
Kosten und Vorteile des Kaufs der Solarmodule durch Finanzierung des Kaufs. |
panelConfigIndex |
Index in |
Geld
Stellt einen Geldbetrag mit Währungstyp dar.
| JSON-Darstellung |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| Felder | |
|---|---|
currencyCode |
Der aus drei Buchstaben bestehende Währungscode gemäß ISO 4217 |
units |
Die ganzen Einheiten des Betrags. Beispiel: Wenn |
nanos |
Anzahl der Nanoeinheiten (10^-9) des Betrags. Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen. Wenn |
FinancialDetails
Details einer Finanzanalyse. Einige dieser Details sind bereits auf höheren Ebenen gespeichert, z.B. die Kosten, die Sie selbst tragen müssen. 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 ( |
| Felder | |
|---|---|
initialAcKwhPerYear |
Wie viele AC-kWh die Solarmodule im ersten Jahr voraussichtlich erzeugen werden. |
remainingLifetimeUtilityBill |
Stromrechnung für Strom, der nicht durch Solarenergie erzeugt wurde, für die Lebensdauer der Module. |
federalIncentive |
Der Betrag, der durch staatliche Anreize verfügbar ist. Dies gilt, wenn der Nutzer die Solarmodule kauft (mit oder ohne Darlehen). |
stateIncentive |
Betrag, der durch staatliche Anreize verfügbar ist. Dies gilt, wenn der Nutzer die Solarmodule kauft (mit oder ohne Darlehen). |
utilityIncentive |
Geldbetrag, der durch Anreize von Versorgungsunternehmen verfügbar ist. Dies gilt, wenn der Nutzer die Solarmodule kauft (mit oder ohne Darlehen). |
lifetimeSrecTotal |
Der Geldbetrag, den der Nutzer über die Lebensdauer der Solaranlage durch Solar Renewable Energy Credits erhält. Dies gilt, wenn der Nutzer die Solaranlage kauft (mit oder ohne Kredit). |
costOfElectricityWithoutSolar |
Die Gesamtkosten für Strom, die der Nutzer über den gesamten Zeitraum gezahlt hätte, wenn er keine Solaranlage installiert hätte. |
netMeteringAllowed |
Gibt an, ob Net-Metering zulässig ist. |
solarPercentage |
Prozentsatz (0–100) des Stroms des Nutzers, der durch Solarenergie bereitgestellt wird. Gültig für das erste Jahr, aber für die Folgejahre nur ungefähr zutreffend. |
percentageExportedToGrid |
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 ( |
| Felder | |
|---|---|
leasesAllowed |
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 |
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. Das ist unabhängig von |
annualLeasingCost |
Geschätzte jährliche Leasingkosten. |
savings |
Wie viel über den gesamten Zeitraum hinweg eingespart wurde (oder nicht). |
SavingsOverTime
Finanzinformationen, die zwischen verschiedenen Finanzierungsmethoden geteilt werden.
| JSON-Darstellung |
|---|
{ "savingsYear1": { object ( |
| Felder | |
|---|---|
savingsYear1 |
Einsparungen im ersten Jahr nach der Installation der Solaranlage. |
savingsYear20 |
Einsparungen in den ersten 20 Jahren nach der Installation der Solaranlage. |
presentValueOfSavingsYear20 |
Wie hoch ist der Barwert der kumulativen Einsparungen über 20 Jahre bei dem angenommenen Abzinsungssatz? |
savingsLifetime |
Einsparungen über die gesamte Lebensdauer des Panels. |
presentValueOfSavingsLifetime |
Wie hoch ist der Barwert der kumulativen Einsparungen über die gesamte Lebensdauer unter Verwendung des angenommenen Abzinsungssatzes? |
financiallyViable |
Gibt an, ob dieses Szenario finanziell tragfähig ist. Ist falsch bei Szenarien mit geringer finanzieller Leistungsfähigkeit (z.B. Verlustgeschäft). |
CashPurchaseSavings
Kosten und Nutzen eines direkten Kaufs einer bestimmten Konfiguration von Solarmodulen bei einem bestimmten Stromverbrauch.
| JSON-Darstellung |
|---|
{ "outOfPocketCost": { object ( |
| Felder | |
|---|---|
outOfPocketCost |
Anschaffungskosten vor Steueranreizen: der Betrag, der aus eigener Tasche bezahlt werden muss. Im Gegensatz dazu wird |
upfrontCost |
Anfangskosten nach Steuervorteilen: Das ist der Betrag, der im ersten Jahr bezahlt werden muss. Im Gegensatz dazu steht |
rebateValue |
Der Wert aller Steuerrabatte. |
savings |
Wie viel über den gesamten Zeitraum hinweg eingespart wurde (oder nicht). |
paybackYears |
Anzahl der Jahre bis zur Amortisierung. Ein negativer Wert bedeutet, dass sich die Investition innerhalb des Lebenszyklus nicht amortisiert. |
FinancedPurchaseSavings
Kosten und Nutzen der Aufnahme eines Darlehens für den Kauf einer bestimmten Konfiguration von Solarmodulen bei einem bestimmten Stromverbrauch.
| JSON-Darstellung |
|---|
{ "annualLoanPayment": { object ( |
| Felder | |
|---|---|
annualLoanPayment |
Jährliche Kredit-/Darlehenszahlungen. |
rebateValue |
Der Wert aller Steuererleichterungen (einschließlich Federal Investment Tax Credit, ITC). |
loanInterestRate |
Der Zinssatz für Darlehen, der in dieser Berechnung zugrunde gelegt wird. |
savings |
Wie viel über den gesamten Zeitraum hinweg eingespart wurde (oder nicht). |