- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Geld
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Testen!
Das Gebäude, das dem Abfragepunkt am nächsten ist. Gibt einen Fehler mit dem Code NOT_FOUND
zurück, wenn sich in einem 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 |
Erforderlich. Der Längen- und Breitengrad, an dem die API nach dem nächstgelegenen bekannten Gebäude sucht. |
required |
Optional. Die Mindestqualität der Ergebnisse. Es werden keine Ergebnisse mit einer niedrigeren Qualität zurückgegeben. Wenn Sie dies nicht angeben, wird die Suche auf Videos mit der höchsten Qualität beschränkt. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht für Solar.FindClosestBuildingInsights
. Informationen zum Standort, zu den Abmessungen und zum 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 des Gebäudes im Format |
center |
Ein Punkt in der Nähe der Mitte des Gebäudes. |
bounding |
Der Begrenzungsrahmen des Gebäudes. |
imagery |
Datum, an dem die zugrunde liegenden Bilder aufgenommen wurden. Dies ist eine Schätzung. |
imagery |
Wann die Verarbeitung dieser Bilder abgeschlossen wurde. |
postal |
Postleitzahl (z.B. (US-Postleitzahl) des Gebiets, in dem sich das Gebäude befindet. |
administrative |
Verwaltungsgebiet 1 (z.B. in den USA der Bundesstaat), in dem sich dieses Gebäude befindet. In den USA kann die Abkürzung beispielsweise „MA“ oder „CA“ sein. |
statistical |
Statistischer Bereich (z.B. (US-Zensusbezirk), in dem sich das Gebäude befindet. |
region |
Regionscode für das Land (oder die Region), in dem sich das Gebäude befindet. |
solar |
Solarpotenzial des Gebäudes. |
imagery |
Die Qualität der Bilder, die zur Berechnung 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üdwestecke des Felds. |
ne |
Die nordöstliche Ecke des Felds. |
SolarPotential
Informationen zum Solarpotenzial eines Gebäudes. Einige Felder darin sind in Bezug auf „Bereiche“ definiert. Die Felder panelCapacityWatts
, panelHeightMeters
und panelWidthMeters
beschreiben die Parameter des Modulmodells, das bei diesen Berechnungen verwendet wird.
JSON-Darstellung |
---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
Felder | |
---|---|
max |
Größe des maximalen Arrays, d. h. die maximale Anzahl von Modulen, die auf das Dach passen. |
panel |
Die Kapazität des Panels in Watt, die bei den Berechnungen verwendet wurde. |
panel |
Höhe des Panels in Metern im Hochformat, die in den Berechnungen verwendet wird. |
panel |
Breite des Panels in Metern im Hochformat, die bei den Berechnungen verwendet wird. |
panel |
Die erwartete Lebensdauer der Solarmodule in Jahren. Dieser Wert wird in den Finanzberechnungen verwendet. |
max |
Größe des maximalen Arrays in Quadratmetern. |
max |
Die maximale Anzahl von Sonnenstunden pro Jahr an einem beliebigen Punkt auf dem Dach. Sonnenstunden sind ein Maß für die Gesamteinstrahlung (Energie), die pro Jahr aufgenommen wird. 1 Sonnenstunde = 1 kWh pro kW (wobei kW auf die Kapazität unter Standardtestbedingungen bezieht). |
carbon |
Die Menge an CO2, die pro MWh Netzstrom erzeugt wird. Dies ist ein Maß für die Kohlenstoffintensität des Stroms aus dem Netz, der durch Solarstrom ersetzt wird. |
whole |
Gesamtgröße und Sonneneinstrahlungsquantile für den Teil des Dachs, der einem Dachsegment zugewiesen wurde. Trotz des Namens ist das möglicherweise nicht das gesamte Gebäude. |
building |
Größe und Sonneneinstrahlungsquantile für das gesamte Gebäude, einschließlich der Teile des Daches, die keinem Dachsegment zugewiesen wurden. Da die Ausrichtung dieser Teile nicht gut charakterisiert ist, ist die Schätzung der Dachfläche nicht zuverlässig. Die Schätzung der Grundfläche ist jedoch zuverlässig. Möglicherweise lässt sich eine zuverlässigere Dachfläche für das gesamte Gebäude erhalten, indem die Dachfläche von |
roof |
Größe und Sonneneinstrahlungsquantile für jedes Dachsegment. |
solar |
Jedes |
solar |
Jede |
financial |
Ein |
SizeAndSunshineStats
Quantile für Größe und Sonneneinstrahlung eines Daches oder eines Teils eines Daches.
JSON-Darstellung |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Felder | |
---|---|
area |
Die Fläche des Dachs oder Dachsegments in m². Dies ist die Dachfläche (mit Neigung), nicht die Grundfläche. |
sunshine |
Quantile der punktuellen Sonnenscheindauer im gesamten Gebiet. Wenn hier N Werte vorhanden sind, entsprechen sie den (N-1)-Ilen. Bei fünf Werten sind das die Quartile (Min., 25%, 50%, 75%, Max.). Die Werte werden in kWh/kW pro Jahr angegeben, z. B. |
ground |
Die vom Dach oder Dachsegment bedeckte Grundfläche in m². |
RoofSegmentSizeAndSunshineStats
Informationen zur Größe und Sonneneinstrahlung eines Dachsegments.
JSON-Darstellung |
---|
{ "stats": { object ( |
Felder | |
---|---|
stats |
Gesamtgröße und Sonneneinstrahlungsquantile für das Dachsegment. |
center |
Ein Punkt in der Nähe der Mitte des Dachsegments. |
bounding |
Der Begrenzungsrahmen des Dachsegments. |
pitch |
Winkel des Dachsegments relativ zur theoretischen Bodenebene. 0 = parallel zum Boden, 90 = senkrecht zum Boden. |
azimuth |
Kompassrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Bei einem „flachen“ Dachsegment ( |
plane |
Die Höhe der Dachsegmentebene in Metern über dem Meeresspiegel am Punkt |
SolarPanel
„SolarPanel“ beschreibt die Position, Ausrichtung und Produktion eines einzelnen Solarpanels. Informationen zu den Parametern des Steuerfelds finden Sie in den Feldern panelHeightMeters
, panelWidthMeters
und panelCapacityWatts
in SolarPotential
.
JSON-Darstellung |
---|
{ "center": { object ( |
Felder | |
---|---|
center |
In der Mitte des Steuerfelds. |
orientation |
Die Ausrichtung des Steuerfelds. |
yearly |
Die Menge der Sonnenenergie, die dieses Layout im Laufe eines Jahres in Gleichstrom-kWh einfängt. |
segment |
Index in |
SolarPanelOrientation
Die Ausrichtung eines Solarmoduls. Dieser Wert muss bezogen auf den Azimut des Dachsegments interpretiert werden, auf dem sich das Modul befindet.
Enums | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Die Ausrichtung des Steuerfelds ist nicht bekannt. |
LANDSCAPE |
Bei einem LANDSCAPE -Modul ist die lange Seite senkrecht zur Azimutrichtung des Dachsegments, auf dem es platziert ist. |
PORTRAIT |
Bei einem PORTRAIT -Modul ist die lange Seite 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 ( |
Felder | |
---|---|
panels |
Gesamtzahl der Panels. Hinweis: Dies ist redundant zu (der Summe der) entsprechenden Felder in |
yearly |
Die Menge der Sonnenenergie, die dieses Layout im Laufe eines Jahres in DC-kWh einfängt, unter der Annahme der oben beschriebenen Module. |
roof |
Informationen zur Produktion jedes Dachsegments, das in diesem Layout mindestens ein Modul enthält. |
RoofSegmentSummary
Informationen zu einem Dachsegment des Gebäudes mit einer bestimmten Anzahl von Paneelen.
JSON-Darstellung |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
Felder | |
---|---|
panels |
Die Gesamtzahl der Panels in diesem Segment. |
yearly |
Die Menge der Sonnenenergie, die dieser Teil des Layouts im Laufe eines Jahres in DC-kWh aufnimmt, unter der Annahme der oben beschriebenen Module. |
pitch |
Winkel des Dachsegments relativ zur theoretischen Bodenebene. 0 = parallel zum Boden, 90 = senkrecht zum Boden. |
azimuth |
Kompassrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Bei einem „flachen“ Dachsegment ( |
segment |
Index in |
FinancialAnalysis
Analyse der Kosten und Vorteile der optimalen Solaranlage für eine bestimmte Stromrechnung.
JSON-Darstellung |
---|
{ "monthlyBill": { object ( |
Felder | |
---|---|
monthly |
Die monatliche Stromrechnung, die für diese Analyse angenommen wird. |
default |
Gibt an, ob dies die Rechnungsgröße ist, die als Standardrechnung für die Region ausgewählt wurde, in der sich das Gebäude befindet. Für genau eine |
average |
Der Stromverbrauch des Hauses in einem durchschnittlichen Monat, basierend auf der Höhe der Rechnung und den lokalen Strompreisen. |
financial |
Finanzinformationen, die unabhängig von der verwendeten Finanzierungsmethode gelten. |
leasing |
Kosten und Nutzen des Leasings der Solarmodule. |
cash |
Kosten und Nutzen des Kaufs der Solarmodule in bar. |
financed |
Kosten und Nutzen des Kaufs der Solarmodule durch Finanzierung des Kaufs. |
panel |
Index in |
Geld
Stellt einen Geldbetrag mit Währungstyp dar.
JSON-Darstellung |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Felder | |
---|---|
currency |
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. Selbstkosten). Die Geldbeträge beziehen sich auf einen Zeitraum, der durch das Feld panelLifetimeYears
in SolarPotential
definiert ist. Hinweis: Die Selbstkosten für den Kauf der Panels sind im Feld outOfPocketCost
in CashPurchaseSavings
angegeben.
JSON-Darstellung |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Felder | |
---|---|
initial |
Die geschätzte Menge an Wechselstrom-kWh, die die Solarmodule im ersten Jahr erzeugen werden. |
remaining |
Stromrechnung für Strom, der nicht durch Solarenergie erzeugt wird, während der Lebensdauer der Module. |
federal |
Verfügbarer Betrag aus Bundessubventionen. Dies gilt, wenn der Nutzer die Module (mit oder ohne Kredit) kauft. |
state |
Verfügbarer Geldbetrag aus staatlichen Zuschüssen. Dies gilt, wenn der Nutzer die Module (mit oder ohne Kredit) kauft. |
utility |
Verfügbarer Geldbetrag aus den Zuschüssen des Energieversorgers. Dies gilt, wenn der Nutzer die Module (mit oder ohne Kredit) kauft. |
lifetime |
Der Betrag, den der Nutzer über die Lebensdauer der Module durch die Vergütung für erneuerbare Energien aus Solarenergie erhält. Dies gilt, wenn der Nutzer die Module (mit oder ohne Kredit) kauft. |
cost |
Die Gesamtkosten für Strom, die der Nutzer während der Lebensdauer gezahlt hätte, wenn er keine Solaranlage installiert hätte. |
net |
Gibt an, ob Net-Metering zulässig ist. |
solar |
Der Prozentsatz (0–100) des vom Nutzer verbrauchten Stroms, der aus Solarenergie stammt. Gültig für das erste Jahr, aber ungefähr richtig für die Folgejahre. |
percentage |
Der Prozentsatz (0–100) der Solarstromerzeugung, der laut unseren Annahmen in das Netz exportiert wurde, basierend auf dem ersten Produktionsquartal. Das hat Auswirkungen auf die Berechnungen, wenn Net-Metering nicht zulässig ist. |
LeasingSavings
Kosten und Nutzen des Leasings einer bestimmten Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch.
JSON-Darstellung |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
Felder | |
---|---|
leases |
Ob Leasing in dieser Gerichtsbarkeit zulässig ist (in einigen Bundesstaaten ist Leasing nicht zulässig). Wenn dieses Feld den Wert „false“ hat, sollten die Werte in dieser Nachricht ignoriert werden. |
leases |
Gibt an, ob Leasingverträge in dieser Gerichtsbarkeit von der Finanzrechenmaschine unterstützt werden. Wenn dieses Feld den Wert „false“ hat, sollten die Werte in dieser Nachricht ignoriert werden. Das ist unabhängig von |
annual |
Geschätzte jährliche Leasingkosten. |
savings |
Wie viel wird über den gesamten Zeitraum gespart (oder nicht)? |
SavingsOverTime
Finanzielle Informationen, die für verschiedene Finanzierungsmethoden freigegeben werden.
JSON-Darstellung |
---|
{ "savingsYear1": { object ( |
Felder | |
---|---|
savings |
Einsparungen im ersten Jahr nach der Installation der Solarmodule. |
savings |
Einsparungen in den ersten 20 Jahren nach der Installation der Module. |
present |
Wie hoch ist der Barwert der kumulativen Einsparungen über 20 Jahre unter Berücksichtigung des angenommenen Abzinsungssatzes? |
savings |
Einsparungen über die gesamte Lebensdauer des Panels. |
present |
Wie hoch ist der Barwert der kumulativen Einsparungen während der gesamten Lebensdauer unter Berücksichtigung des angenommenen Diskontsatzes? |
financially |
Gibt an, ob dieses Szenario finanziell tragfähig ist. Für Szenarien mit schlechter finanzieller Leistungsfähigkeit (z.B. Verluste) ist der Wert „false“. |
CashPurchaseSavings
Kosten und Nutzen des direkten Kaufs einer bestimmten Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch.
JSON-Darstellung |
---|
{ "outOfPocketCost": { object ( |
Felder | |
---|---|
out |
Erstkosten vor Steuervorteilen: Der Betrag, der aus eigener Tasche bezahlt werden muss. Im Gegensatz zu |
upfront |
Erstkosten nach Steueranreizen: Dies ist der Betrag, der im ersten Jahr bezahlt werden muss. Im Vergleich dazu liegt der Wert vor Steuererleichterungen bei |
rebate |
Der Wert aller Steuervergünstigungen. |
savings |
Wie viel wird über den gesamten Zeitraum gespart (oder nicht)? |
payback |
Anzahl der Jahre bis zur Amortisierung. Ein negativer Wert bedeutet, dass die Amortisierung innerhalb der Lebensdauer nie erfolgt. |
FinancedPurchaseSavings
Kosten und Nutzen eines Kredits für den Kauf einer bestimmten Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch.
JSON-Darstellung |
---|
{ "annualLoanPayment": { object ( |
Felder | |
---|---|
annual |
Jährliche Kreditzahlungen. |
rebate |
Der Wert aller Steuervergünstigungen (einschließlich des Bundesinvestitionssteuerguthabens). |
loan |
Der in diesen Berechnungen angenommene Zinssatz für Kredite. |
savings |
Wie viel wird über den gesamten Zeitraum gespart (oder nicht)? |