- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Geldbetrag
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Testen!
Gibt das Gebäude zurück, das einem 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, von dem aus die API nach dem nächstgelegenen bekannten Gebäude sucht. |
requiredQuality |
Optional. Die Mindestqualitätsstufe, die in den Ergebnissen zulässig ist. Es wird kein Ergebnis mit niedrigerer Qualität zurückgegeben. Wenn Sie diese Option nicht angeben, wird nur die Qualität eingeschränkt. |
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 Gebäudemitte. |
boundingBox |
Der Begrenzungsrahmen des Gebäudes. |
imageryDate |
Datum, an dem das zugrunde liegende Bild erworben wurde. Dies ist eine ungefähre Angabe. |
imageryProcessedDate |
Zeitpunkt, zu dem diese Bilder verarbeitet wurden. |
postalCode |
Postleitzahl (z.B. US-Postleitzahl) dieses Gebäudes. |
administrativeArea |
Verwaltungsgebiet 1 (z.B. der US-Bundesstaat), in dem sich dieses Gebäude befindet. In den USA könnte die Abkürzung zum Beispiel „MA“ oder „CA“ lauten. |
statisticalArea |
Statistischer Bereich (z.B. Zensusgebiet (US-Volkszählungsgebiet) ist, in dem sich dieses Gebäude befindet. |
regionCode |
Regionscode für das Land (oder die Region), in dem sich dieses Gebäude befindet. |
solarPotential |
Solarpotenzial des Gebäudes. |
imageryQuality |
Die Qualität der Bilder, die zur Berechnung der Daten für dieses Gebäude verwendet werden. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
Ein Begrenzungsrahmen in Breiten- und Längenkoordinaten.
JSON-Darstellung |
---|
{ "sw": { object ( |
Felder | |
---|---|
sw |
Die südwestliche Ecke des Felds. |
ne |
Die nordöstliche Ecke des Felds. |
SolarPotential
Informationen zum Solarpotenzial eines Gebäudes. Einige Felder sind in Form von Bereichen definiert. Die Felder panelCapacityWatts
, panelHeightMeters
und panelWidthMeters
beschreiben die Parameter des Panelmodells, 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 | |
---|---|
maxArrayPanelsCount |
Größe der maximalen Matrix, d. h. der maximalen Anzahl von Scheiben, die auf das Dach passen. |
panelCapacityWatts |
Kapazität des für die Berechnungen verwendeten Panels in Watt. |
panelHeightMeters |
Höhe des für die Berechnungen verwendeten Felds in Metern im Hochformat. |
panelWidthMeters |
Breite des für die Berechnungen verwendeten Felds in Metern im Hochformat. |
panelLifetimeYears |
Die erwartete Lebensdauer von Solarmodulen in Jahren. Dieser wird für die Finanzberechnungen verwendet. |
maxArrayAreaMeters2 |
Größe des maximalen Arrays in Quadratmetern. |
maxSunshineHoursPerYear |
Maximale Anzahl von Sonnenstunden pro Jahr an jedem beliebigen Punkt auf dem Dach. 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 |
Äquivalente CO2-Menge pro MWh Strom im Netz. Dieser Wert gibt die CO2-Intensität des Netzstroms an, der durch Solarenergie verdrängt wird. |
wholeRoofStats |
Gesamtgröße und Sonnenlichtquantile für den Teil des Dachs, der einem Dachsegment zugewiesen wurde. Trotz des Namens umfasst dies möglicherweise nicht das gesamte Gebäude. |
buildingStats |
Größe und Sonnenlichtquantile des gesamten Gebäudes, einschließlich Teile des Dachs, die keinem Dachsegment zugewiesen wurden. Da die Ausrichtungen dieser Teile nicht gut beschrieben sind, ist die Schätzung der Dachfläche unzuverlässig, aber die Schätzung der Grundfläche ist zuverlässig. Unter Umständen lässt sich eine zuverlässigere Dachfläche des gesamten Gebäudes ermitteln, indem Sie die Dachfläche von |
roofSegmentStats[] |
Größe und Sonnenlichtquantile für jedes Dachsegment |
solarPanels[] |
Jede |
solarPanelConfigs[] |
Jedes |
financialAnalyses[] |
Ein |
SizeAndSunshineStats
Quantil der Größe und Sonneneinstrahlung eines Dachs oder eines Teils eines Dachs.
JSON-Darstellung |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Felder | |
---|---|
areaMeters2 |
Die Fläche des Dachs oder Dachsegments in m^2. Dies ist die Dachfläche (unter Berücksichtigung der Neigung), nicht der Grundriss auf dem Boden. |
sunshineQuantiles[] |
Quantile der punktweisen Sonneneinstrahlung im gesamten Gebiet. Wenn es hier N-Werte gibt, stellt dies die (N-1)-Ilen dar. Wenn beispielsweise fünf Werte vorhanden sind, wären es die Quartile (Min., 25%, 50%, 75%, Max). Die Werte sind in jährlichen kWh/kW angegeben (z. B. |
groundAreaMeters2 |
Die Bodenfläche, die vom Dach oder Dachsegment abgedeckt wird, in m^2. |
RoofSegmentSizeAndSunshineStats
Informationen zu den Quantilen für die Größe und die Sonneneinstrahlung eines Dachsegments.
JSON-Darstellung |
---|
{ "stats": { object ( |
Felder | |
---|---|
stats |
Gesamtgröße und Sonnenlichtquantile für das Dachsegment |
center |
Ein Punkt in der Nähe der Mitte des Dachsegments |
boundingBox |
Der Begrenzungsrahmen des Dachsegments. |
pitchDegrees |
Winkel des Dachsegments im Verhältnis zur theoretischen Bodenebene 0 = parallel zum Boden, 90 = senkrecht zum Boden. |
azimuthDegrees |
Kompassrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Für ein „Flach“-Segment ( |
planeHeightAtCenterMeters |
Die Höhe der Dachsegmentebene in Metern über dem Meeresspiegel, an dem durch |
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 |
In der Mitte des Panels |
orientation |
Die Ausrichtung des Bereichs. |
yearlyEnergyDcKwh |
Wie viel Sonnenlichtenergie dieses Layout im Laufe eines Jahres erfasst, in Gleichstrom in kWh. |
segmentIndex |
Index in |
SolarPanelOrientation
Die Ausrichtung eines Solarmoduls. Dies muss relativ zum Azimut des Dachsegments interpretiert werden, auf dem die Platte platziert wird.
Enums | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Keine Bereichsausrichtung ist bekannt. |
LANDSCAPE |
Die lange Seite eines LANDSCAPE -Elements ist senkrecht zur Azimut-Richtung des Dachsegments, auf dem es platziert wird. |
PORTRAIT |
Die lange Seite eines PORTRAIT -Elements verläuft parallel zur Azimutrichtung des Dachsegments, auf dem es platziert wird. |
SolarPanelConfig
SolarPanelConfig beschreibt eine bestimmte Platzierung von Solarmodulen auf dem Dach.
JSON-Darstellung |
---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
Felder | |
---|---|
panelsCount |
Gesamtzahl der Bereiche. Dies ist redundant zu den entsprechenden Feldern in |
yearlyEnergyDcKwh |
Wie viel Sonnenlichtenergie dieses Layout im Laufe eines Jahres in Gleichstrom in kWh erfasst, unter Annahme der oben beschriebenen Module. |
roofSegmentSummaries[] |
Informationen zur Produktion jedes Dachsegments, das mindestens ein Paneel in diesem Layout enthält. |
RoofSegmentSummary
Informationen zu einem Dachsegment des Gebäudes mit einer Reihe von Feldern.
JSON-Darstellung |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
Felder | |
---|---|
panelsCount |
Die Gesamtzahl der Steuerfelder in diesem Segment. |
yearlyEnergyDcKwh |
Wie viel Sonnenlichtenergie in diesem Teil des Layouts im Laufe eines Jahres in Gleichstrom in kWh erfasst wird, unter Annahme der oben beschriebenen Module. |
pitchDegrees |
Winkel des Dachsegments im Verhältnis zur theoretischen Bodenebene 0 = parallel zum Boden, 90 = senkrecht zum Boden. |
azimuthDegrees |
Kompassrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Für ein „Flach“-Segment ( |
segmentIndex |
Index in |
FinancialAnalysis
Analyse der Kosten und Vorteile der optimalen Solaranlage für eine bestimmte Stromrechnungsgröße.
JSON-Darstellung |
---|
{ "monthlyBill": { object ( |
Felder | |
---|---|
monthlyBill |
Die monatliche Stromrechnung, von der diese Analyse ausgegangen wird. |
defaultBill |
Gibt an, welche Schnabelgröße als Standardrechnung für das Gebiet ausgewählt ist, in dem sich dieses Gebäude befindet. Für genau eine |
averageKwhPerMonth |
Wie viel Strom das Haus in einem durchschnittlichen Monat verbraucht, basierend auf dem Rechnungsbetrag und den lokalen Stromtarifen. |
financialDetails |
Finanzdaten, die unabhängig von der verwendeten Finanzierungsmethode gelten. |
leasingSavings |
Kosten und Nutzen der Anmietung von Solarmodulen. |
cashPurchaseSavings |
Kosten und Nutzen beim Kauf von Solarmodulen gegen Bargeld |
financedPurchaseSavings |
Kosten und Nutzen für den Kauf von Solarmodulen durch Finanzierung |
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. kostenlose Kosten). Gesamtgeldbeträge beziehen sich auf einen Lifetime-Zeitraum, der durch das Feld „panelLifetimeYears
“ in SolarPotential
definiert ist. Hinweis: Die Kosten für den Kauf der Paneele können im Feld outOfPocketCost
in CashPurchaseSavings
angegeben werden.
JSON-Darstellung |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Felder | |
---|---|
initialAcKwhPerYear |
Wie viele AC-kWh werden voraussichtlich im ersten Jahr durch die Solarmodule erzeugt werden. |
remainingLifetimeUtilityBill |
Rechnung eines Versorgungsunternehmens für Strom, der nicht durch Solarenergie erzeugt wird, für die Lebensdauer der Module |
federalIncentive |
Geldbetrag, der durch staatliche Förderung zur Verfügung gestellt wird; dies gilt, wenn der Nutzer die Panels (mit oder ohne Kredit) erwirbt. |
stateIncentive |
Betrag, der durch staatliche Anreize zur Verfügung steht; gilt, wenn der Nutzer die Bereiche (mit oder ohne Kredit) erwirbt. |
utilityIncentive |
Betrag, der durch Versorgungsprämien zur Verfügung steht. Dies gilt, wenn der Nutzer die Bereiche mit oder ohne Kredit erwirbt. |
lifetimeSrecTotal |
Geldbetrag, den der Nutzer während der gesamten Lebensdauer des Moduls aus einer Gutschrift für Solarenergie erhält. Dies gilt, wenn der Nutzer die Module (mit oder ohne Kredit) erwirbt. |
costOfElectricityWithoutSolar |
Die Gesamtkosten für den Strom, den ein Nutzer über die gesamte Lebensdauer bezahlt hätte, wenn er keine Solaranlage installiert hätte. |
netMeteringAllowed |
Gibt an, ob Nettometering erlaubt ist. |
solarPercentage |
Prozentsatz (0–100) des durch Solarenergie gespeisten Stroms des Nutzers. Für das erste Jahr gültig, aber für zukünftige Jahre ungefähr korrekt. |
percentageExportedToGrid |
Der von uns angenommene Prozentsatz (0–100) der Solarstromproduktion, die ins Netz exportiert wurde, basierend auf dem ersten Viertel der Produktion. Dies wirkt sich auf die Berechnungen aus, wenn Netto-Metering nicht zulässig ist. |
LeasingSavings
Kosten und Nutzen der Anmietung von Solarmodulen mit einem bestimmten Stromverbrauch
JSON-Darstellung |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
Felder | |
---|---|
leasesAllowed |
Gibt an, ob Freigaben in dieser Gerichtsbarkeit zulässig sind (Leases sind in einigen Bundesstaaten nicht zulässig). Wenn dieses Feld auf „false“ gesetzt ist, sollten die Werte in dieser Meldung wahrscheinlich ignoriert werden. |
leasesSupported |
Gibt an, ob Leasing in dieser Rechtsprechung durch das Finanzberechnungsmodul unterstützt werden. Wenn dieses Feld auf „false“ gesetzt ist, sollten die Werte in dieser Meldung wahrscheinlich ignoriert werden. Dies ist unabhängig von |
annualLeasingCost |
Geschätzte jährliche Leasingkosten. |
savings |
Wie viel gespart wird (oder nicht) während der Lebensdauer. |
SavingsOverTime
Finanzdaten, die zwischen verschiedenen Finanzierungsmethoden ausgetauscht werden.
JSON-Darstellung |
---|
{ "savingsYear1": { object ( |
Felder | |
---|---|
savingsYear1 |
Einsparungen im ersten Jahr nach der Montage von Modulen. |
savingsYear20 |
Einsparungen in den ersten 20 Jahren nach der Installation von Modulen |
presentValueOfSavingsYear20 |
Wie hoch ist unter Verwendung des angenommenen Diskontsatzes der Barwert der kumulativen 20-Jahres-Einsparungen? |
savingsLifetime |
Einsparungen während der gesamten Lebensdauer des Moduls. |
presentValueOfSavingsLifetime |
Wie hoch ist unter Verwendung des angenommenen Diskontsatzes der Barwert der kumulativen Lifetime-Einsparungen? |
financiallyViable |
Gibt an, ob dieses Szenario finanziell rentabel ist. Ist bei Szenarien mit schlechter finanzieller Tragfähigkeit (z.B. finanzieller Verlust) falsch. |
CashPurchaseSavings
Kosten und Nutzen beim direkten Kauf einer bestimmten Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch.
JSON-Darstellung |
---|
{ "outOfPocketCost": { object ( |
Felder | |
---|---|
outOfPocketCost |
Anschaffungskosten vor Steueranreizen: der Betrag, der ausbezahlt werden muss. Im Gegensatz zu |
upfrontCost |
Anschaffungskosten nach Steueranreizen: Der Betrag, der im ersten Jahr gezahlt werden muss. Im Gegensatz zu |
rebateValue |
Der Wert aller Steuerermäßigungen. |
savings |
Wie viel gespart wird (oder nicht) während der Lebensdauer. |
paybackYears |
Anzahl der Jahre bis zur Amortisation. Ein negativer Wert bedeutet, dass es innerhalb des Lifetime-Zeitraums keine Amortisation dauert. |
FinancedPurchaseSavings
Kosten und Nutzen der Nutzung eines Kredits, um eine bestimmte Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch zu kaufen.
JSON-Darstellung |
---|
{ "annualLoanPayment": { object ( |
Felder | |
---|---|
annualLoanPayment |
Jährliche Kreditzahlungen. |
rebateValue |
Der Wert aller Steuerermäßigungen (einschließlich Federal Investment Tax Credit (ITC)). |
loanInterestRate |
Der bei dieser Berechnungsreihe angenommene Zinssatz für Darlehen. |
savings |
Wie viel gespart wird (oder nicht) während der Lebensdauer. |