- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- LatLngBox
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SolarPotential
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SizeAndSunshineStats
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- RoofSegmentSizeAndSunshineStats
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SolarPanel
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SolarPanelOrientation
- SolarPanelConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- RoofSegmentSummary
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FinancialAnalysis
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Geld
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FinancialDetails
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- LeasingSavings
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- SavingsOverTime
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- CashPurchaseSavings
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- FinancedPurchaseSavings
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Testen!
Findet das Gebäude, 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 minimale Qualitätsstufe, die in den Ergebnissen zulässig ist. Es wird kein Ergebnis mit niedrigerer Qualität zurückgegeben. Wenn Sie dies nicht angeben, entspricht dies einer Beschränkung auf die ausschließliche Qualität von HOCH. |
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 die Verarbeitung dieses Bildes abgeschlossen wurde. |
postalCode |
Postleitzahl (z.B. US-Postleitzahl), in dem sich dieses Gebäude befindet. |
administrativeArea |
Verwaltungsgebiet 1 (z.B. Deutschland oder Bundesstaat), in dem sich dieses Gebäude befindet. In den USA könnte die Abkürzung beispielsweise „MA“ lauten oder "CA". |
statisticalArea |
Statistischer Bereich (z.B. US-Volkszählungsgebiet), in dem sich das Gebäude befindet. |
regionCode |
Regionscode für das Land (oder die Region), in dem sich das Gebäude befindet. |
solarPotential |
Solarpotenzial des Gebäudes. |
imageryQuality |
Die Qualität des Bildmaterials, das zur Berechnung der Daten für dieses Gebäude verwendet wird. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/cloud-platform
LatLngBox
Ein Begrenzungsrahmen in Breiten-/Längenkoordinaten.
JSON-Darstellung |
---|
{ "sw": { object ( |
Felder | |
---|---|
sw |
Die südwestliche Ecke des Feldes. |
ne |
Die nordöstliche Ecke des Feldes. |
SolarPotential
Informationen zum Solarpotenzial eines Gebäudes. Einige Felder werden dabei in Form von Feldern definiert. In den Feldern panelCapacityWatts
, panelHeightMeters
und panelWidthMeters
werden die Parameter des in diesen Berechnungen verwendeten Bereichsmodells beschrieben.
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 Anordnung, d. h. die maximale Anzahl von Modulen, die auf das Dach passen. |
panelCapacityWatts |
Die Kapazität des für die Berechnungen verwendeten Panels in Watt. |
panelHeightMeters |
Höhe des in den Berechnungen verwendeten Felds in Metern im Hochformat. |
panelWidthMeters |
Breite des in den Berechnungen verwendeten Felds in Metern im Hochformat. |
panelLifetimeYears |
Die erwartete Lebensdauer der Solarmodule in Jahren. Er wird in den Finanzberechnungen verwendet. |
maxArrayAreaMeters2 |
Größe des maximalen Arrays in Quadratmetern. |
maxSunshineHoursPerYear |
Maximale Anzahl der Sonnenstunden pro Jahr an jedem Punkt auf dem Dach. Die Sonnenstunden geben die Gesamtmenge der Sonneneinstrahlung (Energie) pro Jahr an. 1 Sonnenstunde = 1 kWh pro kW (wobei kW sich auf die Kapazität unter Standardtestbedingungen bezieht). |
carbonOffsetFactorKgPerMwh |
Entspricht der erzeugten CO2-Menge pro MWh Netzstrom. Dies ist ein Maß für die CO2-Intensität des durch Solarstrom erzeugten Netzstroms. |
wholeRoofStats |
Gesamtgröße und Sonnenlichtquantile für den Teil des Dachs, der einem bestimmten Dachsegment zugewiesen war. Trotz des Namens umfasst dieser möglicherweise nicht das gesamte Gebäude. |
buildingStats |
Größe und Sonnenlichtquantile für das gesamte Gebäude, einschließlich Teile des Dachs, die keinem Dachsegment zugeordnet waren. 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. Eine zuverlässigere Gesamtdachfläche des Gebäudes lässt sich möglicherweise erzielen, wenn die Dachfläche von |
roofSegmentStats[] |
Quantile für Größe und Sonnenlicht für jedes Dachsegment. |
solarPanels[] |
Jede |
solarPanelConfigs[] |
Jede |
financialAnalyses[] |
|
SizeAndSunshineStats
Quantile von Größe und Sonneneinstrahlung eines Dachs oder eines Teils eines Dachs.
JSON-Darstellung |
---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
Felder | |
---|---|
areaMeters2 |
Fläche des Dachs oder Dachsegments in m^2. Dies ist die Dachfläche (unter Berücksichtigung der Neigung), nicht die Grundfläche. |
sunshineQuantiles[] |
Quantile der punktweisen Sonne im gesamten Gebiet. Wenn hier N-Werte vorhanden sind, stellt dies die (N-1)-Ile dar. Wenn es beispielsweise 5 Werte gibt, sind das die Quartile (Min., 25%, 50%, 75%, Max). Die Werte sind in kWh/kW pro Jahr angegeben, zum Beispiel |
groundAreaMeters2 |
Die Grundfläche des Dachs oder Dachsegments in m^2. |
RoofSegmentSizeAndSunshineStats
Informationen zu Größe und Sunnity-Quantilen 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 relativ zur theoretischen Grundebene. 0 = parallel zum Boden, 90 = senkrecht zum Boden. |
azimuthDegrees |
Kompassrichtung, in die das Dachsegment zeigt 0 = Norden, 90 = Ost, 180 = Süd. Für eine "flache" Dachsegment ( |
planeHeightAtCenterMeters |
Die Höhe der Dachsegmentebene in Metern über dem Meeresspiegel an dem durch |
SolarPanel
SolarPanel beschreibt die Position, Ausrichtung und Herstellung 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 Steuerfelds |
orientation |
Die Ausrichtung des Steuerfelds. |
yearlyEnergyDcKwh |
Wie viel Sonnenlichtenergie dieses Layout im Laufe eines Jahres erfasst, in kWh Gleichstrom. |
segmentIndex |
Index in |
SolarPanelOrientation
Die Ausrichtung eines Solarmoduls. Dies muss relativ zum Azimut des Dachsegments interpretiert werden, auf dem sich das Steuerfeld befindet.
Enums | |
---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
Die Bereichsausrichtung ist nicht bekannt. |
LANDSCAPE |
Die lange Kante eines LANDSCAPE -Steuerfelds ist senkrecht zur Azimutrichtung des Dachsegments, auf dem es platziert ist. |
PORTRAIT |
Die lange Kante eines PORTRAIT -Steuerelements verläuft 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 | |
---|---|
panelsCount |
Gesamtzahl der Bereiche. Beachten Sie, dass dies zu den entsprechenden Feldern in |
yearlyEnergyDcKwh |
Wie viel Sonnenlichtenergie dieses Layout im Laufe eines Jahres erfasst, in kWh Gleichstrom bei der Annahme der oben beschriebenen Module. |
roofSegmentSummaries[] |
Informationen zur Herstellung jedes Dachsegments, das mindestens ein Steuerfeld in dieser Anordnung trägt. |
RoofSegmentSummary
Informationen zu einem Dachsegment des Gebäudes mit einer Reihe von Steuerfeldern.
JSON-Darstellung |
---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
Felder | |
---|---|
panelsCount |
Die Gesamtzahl der Felder in diesem Segment. |
yearlyEnergyDcKwh |
Wie viel Sonnenlicht Energie in diesem Teil des Layouts im Laufe eines Jahres erfasst, in Gleichstrom kWh bei den oben beschriebenen Modulen. |
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 = Ost, 180 = Süd. Für eine "flache" Dachsegment ( |
segmentIndex |
Index in |
FinancialAnalysis
Analyse der Kosten und Vorteile einer optimalen Solaranlage für eine bestimmte Stromrechnung.
JSON-Darstellung |
---|
{ "monthlyBill": { object ( |
Felder | |
---|---|
monthlyBill |
Die monatliche Stromrechnung, von der diese Analyse ausgeht. |
defaultBill |
Gibt an, ob dieser Rechnungsbetrag als Standardrechnung für den Bereich ausgewählt wurde, in dem sich dieses Gebäude befindet. Für genau ein |
averageKwhPerMonth |
Wie viel Strom das Haus in einem durchschnittlichen Monat verbraucht, basierend auf der Rechnungsgröße und den lokalen Stromtarifen. |
financialDetails |
Finanzinformationen, die unabhängig von der verwendeten Finanzierungsmethode gelten. |
leasingSavings |
Kosten und Nutzen des Leasings von Solarmodulen |
cashPurchaseSavings |
Kosten und Nutzen beim Kauf von Solarmodulen mit Bargeld |
financedPurchaseSavings |
Kosten und Nutzen beim 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 dreistellige 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 zu einer Finanzanalyse. Einige dieser Details sind bereits auf höheren Ebenen gespeichert, z.B. externe Kosten. Die Gesamtgeldbeträge gelten für einen gesamten Zeitraum, der im Feld panelLifetimeYears
in SolarPotential
definiert ist. Hinweis: Die Kosten für den Kauf der Bereiche werden im Feld outOfPocketCost
in CashPurchaseSavings
angegeben.
JSON-Darstellung |
---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
Felder | |
---|---|
initialAcKwhPerYear |
Wie viel AC-kWh die Solarmodule voraussichtlich im ersten Jahr erzeugen werden |
remainingLifetimeUtilityBill |
Rechnung eines Versorgungsunternehmens für nicht durch Solarenergie erzeugte Strom für die Lebensdauer der Module. |
federalIncentive |
Verfügbares Geld aus bundesstaatlichen Incentives Dies gilt, wenn die Nutzenden die Bereiche kaufen (mit oder ohne Kredit). |
stateIncentive |
Verfügbares Geld aus staatlichen Incentives Dies gilt, wenn die Nutzenden die Bereiche kaufen (mit oder ohne Kredit). |
utilityIncentive |
Verfügbares Geld aus Anreizen für Versorgungsunternehmen Dies gilt, wenn die Nutzenden die Bereiche kaufen (mit oder ohne Kredit). |
lifetimeSrecTotal |
Geldbetrag, den der Nutzer während der gesamten Lebensdauer des Moduls aus Gutschriften für erneuerbare Energien erhält Dies gilt, wenn die Nutzenden die Bereiche kaufen (mit oder ohne Kredit). |
costOfElectricityWithoutSolar |
Gesamtkosten für den Strom, die der Nutzer im Laufe der Lebensdauer bezahlt hätte, wenn er keine Solaranlagen installiert hätte. |
netMeteringAllowed |
Gibt an, ob Net Metering zulässig ist. |
solarPercentage |
Prozentsatz (0–100) der vom Nutzer durch Solarenergie gewonnenen Energie. Gültig für das erste Jahr, aber ungefähr richtig für zukünftige Jahre. |
percentageExportedToGrid |
Der prozentuale Anteil (0–100) der von uns angenommenen Solarenergieerzeugung wurde in das Netz exportiert, basierend auf dem ersten Quartal der Produktion. Dies wirkt sich auf die Berechnungen aus, wenn Netto-Metering nicht zulässig ist. |
LeasingSavings
Kosten und Nutzen der Vermietung einer bestimmten Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch.
JSON-Darstellung |
---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
Felder | |
---|---|
leasesAllowed |
Gibt an, ob Leases in dieser Gerichtsbarkeit zulässig sind (Leases sind in einigen Bundesstaaten nicht zulässig). Wenn dieses Feld den Wert „false“ hat, sollten die Werte in dieser Nachricht wahrscheinlich ignoriert werden. |
leasesSupported |
Gibt an, ob Leasing in dieser Gerichtsbarkeit von der Finanzberechnungs-Engine unterstützt werden. Wenn dieses Feld den Wert „false“ hat, sollten die Werte in dieser Nachricht wahrscheinlich ignoriert werden. Dies ist unabhängig von |
annualLeasingCost |
Geschätzte jährliche Leasingkosten |
savings |
Wie viel eingespart wird (oder nicht), wie viel während der Lebensdauer eingespart wird. |
SavingsOverTime
Finanzdaten, die zwischen verschiedenen Finanzierungsmethoden ausgetauscht werden
JSON-Darstellung |
---|
{ "savingsYear1": { object ( |
Felder | |
---|---|
savingsYear1 |
Einsparungen im ersten Jahr nach dem Einbau von Modulen. |
savingsYear20 |
Einsparungen in den ersten 20 Jahren nach dem Einbau von Modulen. |
presentValueOfSavingsYear20 |
Wie hoch ist beim angenommenen Abzinsungssatz der Barwert der kumulativen 20-jährigen Einsparungen? |
savingsLifetime |
Einsparungen während der gesamten Lebensdauer |
presentValueOfSavingsLifetime |
Wie hoch ist bei Verwendung des angenommenen Rabatts der Barwert der kumulativen Lifetime-Einsparungen? |
financiallyViable |
Gibt an, ob dieses Szenario finanziell tragbar ist. Ist falsch für Szenarien mit schlechter finanzieller Tragfähigkeit (z.B. Geldverlust). |
CashPurchaseSavings
Kosten und Nutzen eines vollständigen Kaufs einer bestimmten Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch.
JSON-Darstellung |
---|
{ "outOfPocketCost": { object ( |
Felder | |
---|---|
outOfPocketCost |
Anfängliche Kosten vor Steueranreizen: der Betrag, der ohne Bezahlung bezahlt werden muss. Im Gegensatz zu „ |
upfrontCost |
Anfängliche Kosten nach Abzug von Steueranreizen: der Betrag, der im ersten Jahr gezahlt werden muss. Im Gegensatz zu |
rebateValue |
Der Wert aller Steuerrabatte. |
savings |
Wie viel eingespart wird (oder nicht), wie viel während der Lebensdauer eingespart wird. |
paybackYears |
Anzahl der Jahre bis zur Auszahlung. Ein negativer Wert bedeutet, dass es innerhalb der Lebensdauer nie zu einer Amortisation kommt. |
FinancedPurchaseSavings
Kosten und Nutzen eines Kredits für den Kauf einer bestimmten Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch.
JSON-Darstellung |
---|
{ "annualLoanPayment": { object ( |
Felder | |
---|---|
annualLoanPayment |
Jährliche Darlehenszahlungen. |
rebateValue |
Der Wert aller Steuerermäßigungen (einschließlich der Federal Investment Tax Credit (ITC)). |
loanInterestRate |
Der Zinssatz für Darlehen, der bei dieser Berechnungsmethode angenommen wird. |
savings |
Wie viel eingespart wird (oder nicht), wie viel während der Lebensdauer eingespart wird. |