Package google.maps.solar.v1

Index

• Solar (Benutzeroberfläche)
• BuildingInsights (Meldung)
• CashPurchaseSavings (Meldung)
• DataLayerView (Aufzählung)
• DataLayers (Meldung)
• FinancedPurchaseSavings (Meldung)
• FinancialAnalysis (Meldung)
• FinancialDetails (Meldung)
• FindClosestBuildingInsightsRequest (Meldung)
• GetDataLayersRequest (Meldung)
• GetGeoTiffRequest (Meldung)
• ImageryQuality (Aufzählung)
• LatLngBox (Meldung)
• LeasingSavings (Meldung)
• RoofSegmentSizeAndSunshineStats (Meldung)
• RoofSegmentSummary (Meldung)
• SavingsOverTime (Meldung)
• SizeAndSunshineStats (Meldung)
• SolarPanel (Meldung)
• SolarPanelConfig (Meldung)
• SolarPanelOrientation (Aufzählung)
• SolarPotential (Meldung)

Solar

Dienstdefinition für die Solar API.

FindClosestBuildingInsights

rpc FindClosestBuildingInsights(FindClosestBuildingInsightsRequest) returns (BuildingInsights) Das Gebäude wird ermittelt, dessen Schwerpunkt 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. Autorisierungsbereiche Erfordert den folgenden OAuth-Bereich: https://www.googleapis.com/auth/cloud-platform

GetDataLayers
rpc GetDataLayers(GetDataLayersRequest) returns (DataLayers) Ruft Solarinformationen für eine Region um einen Standort ab. Gibt einen Fehler mit dem Code NOT_FOUND zurück, wenn sich der Standort außerhalb des Versorgungsgebiets befindet. Autorisierungsbereiche Erfordert den folgenden OAuth-Bereich: https://www.googleapis.com/auth/cloud-platform

GetGeoTiff
rpc GetGeoTiff(GetGeoTiffRequest) returns (HttpBody) Gibt ein Bild anhand seiner ID zurück. Autorisierungsbereiche Erfordert den folgenden OAuth-Bereich: https://www.googleapis.com/auth/cloud-platform

BuildingInsights

Antwortnachricht für Solar.FindClosestBuildingInsights. Informationen zum Standort, zu den Abmessungen und zum Solarpotenzial eines Gebäudes.

Felder
name	string Der Ressourcenname des Gebäudes im Format buildings/{place_id}.
center	LatLng Ein Punkt in der Nähe der Mitte des Gebäudes.
bounding_box	LatLngBox Der Begrenzungsrahmen des Gebäudes.
imagery_date	Date Datum, an dem die zugrunde liegenden Bilder aufgenommen wurden. Dies ist eine Schätzung.
imagery_processed_date	Date Wann die Verarbeitung dieser Bilder abgeschlossen wurde.
postal_code	string Postleitzahl (z.B. (US-Postleitzahl) des Gebiets, in dem sich das Gebäude befindet.
administrative_area	string 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_area	string Statistischer Bereich (z.B. (US-Zensus-Erhebungsgebiet), in dem sich das Gebäude befindet.
region_code	string Regionscode für das Land (oder die Region), in dem sich das Gebäude befindet.
solar_potential	SolarPotential Solarpotenzial des Gebäudes.
imagery_quality	ImageryQuality Die Qualität der Bilder, die zur Berechnung der Daten für dieses Gebäude verwendet wurden.

CashPurchaseSavings

Kosten und Nutzen des direkten Kaufs einer bestimmten Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch.

Felder
out_of_pocket_cost	Money Erstkosten vor Steuervorteilen: Der Betrag, der aus eigener Tasche bezahlt werden muss. Im Gegensatz zu upfront_cost, das nach Steueranreizen berechnet wird.
upfront_cost	Money Erstkosten nach Steueranreizen: Dies ist der Betrag, der im ersten Jahr bezahlt werden muss. Im Vergleich dazu liegt der Wert vor Steuererleichterungen bei out_of_pocket_cost.
rebate_value	Money Der Wert aller Steuervergünstigungen.
savings	SavingsOverTime Wie viel wird über den gesamten Zeitraum gespart (oder nicht)?
payback_years	float Anzahl der Jahre bis zur Amortisierung. Ein negativer Wert bedeutet, dass die Amortisierung innerhalb der Lebensdauer nie erfolgt.

DataLayerView

Welche Teilmenge der Sonneninformationen zurückgegeben werden soll.

Enums
DATA_LAYER_VIEW_UNSPECIFIED	Entspricht „FULL“.
DSM_LAYER	Nur DSM herunterladen
IMAGERY_LAYERS	DSM, RGB und Maske abrufen
IMAGERY_AND_ANNUAL_FLUX_LAYERS	DSM, RGB, Maske und Jahresdurchfluss abrufen
IMAGERY_AND_ALL_FLUX_LAYERS	DSM, RGB, Maske, Jahres- und Monatsstrom
FULL_LAYERS	Alle Daten abrufen

DataLayers

Informationen zum Solarpotenzial einer Region. Die tatsächlichen Daten befinden sich in einer Reihe von GeoTIFF-Dateien, die die angeforderte Region abdecken. Diese Nachricht enthält URLs für diese Dateien: Jeder String in der DataLayers-Nachricht enthält eine URL, über die die entsprechende GeoTIFF-Datei abgerufen werden kann. Diese URLs sind nach der Generierung einige Stunden lang gültig. Die meisten GeoTIFF-Dateien haben eine Auflösung von 0, 1 m/Pixel. Die monatlichen Flux-Dateien haben eine Auflösung von 0, 5 m/Pixel und die stündlichen Schattendateien eine Auflösung von 1 m/Pixel. Wenn in der GetDataLayersRequest ein pixel_size_meters-Wert angegeben wurde, ist dies die Mindestauflösung in den GeoTIFF-Dateien.

Felder
imagery_date	Date Das Datum, an dem die Quellbilder (aus denen alle anderen Daten abgeleitet werden) in dieser Region aufgenommen wurden. Dieser Wert ist zwangsläufig etwas ungenau, da die Bilder möglicherweise an mehreren Tagen aufgenommen wurden.
imagery_processed_date	Date Wann die Verarbeitung dieser Bilder abgeschlossen wurde.
dsm_url	string Die URL für ein Bild des DSM (Digital Surface Model) der Region. Die Werte sind in Metern über dem EGM96-Geoid (d.h. dem Meeresspiegel) angegeben. Ungültige Standorte (für die wir keine Daten haben) werden als -9999 gespeichert.
rgb_url	string Die URL für ein Bild mit RGB-Daten (Luftbild) der Region.
mask_url	string Die URL für das Bild der Gebäudemaske: Ein Bit pro Pixel gibt an, ob dieses Pixel als Teil eines Daches betrachtet wird oder nicht.
annual_flux_url	string Die URL für die Karte des jährlichen Zuflusses (jährliche Sonneneinstrahlung auf Dächern) der Region. Die Werte sind in kWh/kW/Jahr angegeben. Dies ist der ungefilterte Fluss: Der Fluss wird für jeden Standort berechnet, nicht nur für Gebäudedächer. Ungültige Standorte werden als -9999 gespeichert: Standorte außerhalb unseres Abdeckungsbereichs sind ungültig. Auch einige Standorte innerhalb des Abdeckungsbereichs, für die wir den Fluss nicht berechnen konnten, sind ungültig.
monthly_flux_url	string Die URL für die monatliche Flusskarte (Sonnenlicht auf Dächern, aufgeschlüsselt nach Monat) der Region. Die Werte sind in kWh/kW/Jahr angegeben. Das GeoTIFF, auf das diese URL verweist, enthält zwölf Bänder, die den Monaten Januar bis Dezember entsprechen.
hourly_shade_urls[]	string Zwölf URLs für stündliche Schatten, entsprechend den Monaten Januar bis Dezember, in der richtigen Reihenfolge. Jede GeoTIFF-Datei enthält 24 Bänder, die den 24 Stunden des Tages entsprechen. Jedes Pixel ist eine 32-Bit-Ganzzahl, die den (bis zu) 31 Tagen dieses Monats entspricht. Ein Bit 1 bedeutet, dass der entsprechende Ort an diesem Tag, zu dieser Stunde und in diesem Monat die Sonne sehen kann. Ungültige Standorte werden als -9999 gespeichert. Da diese Zahl negativ ist, ist Bit 31 gesetzt. Bei keinem gültigen Wert ist Bit 31 gesetzt, da dies dem 32. Tag des Monats entsprechen würde. Ein Beispiel kann hilfreich sein. Wenn Sie wissen möchten, ob an einem Punkt (am Pixelstandort (x, y)) am 22. Juni um 16:00 Uhr die Sonne schien, gehen Sie so vor: die sechste URL in dieser Liste abrufen (entspricht dem Juni). Suchen Sie den 17. Kanal (entspricht 16:00 Uhr). den 32‑Bit-Wert an (x, y) lesen. Bit 21 des Werts lesen (entspricht dem 22. des Monats). Wenn dieses Bit eine 1 ist, wurde an diesem Ort am 22. Juni um 16:00 Uhr die Sonne gesehen. Formeller: Bei month (1–12), day (1…Monat max.; Februar hat 28 Tage) und hour (0–23) ist der Schatten/Sonne für diesen Monat/Tag/Stunde an einer Position (x, y) das Bit (hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1)) Dabei steht (x, y) für die räumliche Indexierung, [month - 1] bezieht sich auf das Abrufen der month - 1. URL (Indexierung ab Null), [hour] ist die Indexierung in den Channels und ein endgültiges Ergebnis ungleich Null bedeutet „sonnig“. Es gibt keine Schalttage und keine Sommerzeit. Alle Tage haben 24 Stunden und Mittag ist immer 12 Uhr „Standardzeit“.
imagery_quality	ImageryQuality Die Qualität der Bilder im Ergebnis.

FinancedPurchaseSavings

Kosten und Nutzen eines Kredits für den Kauf einer bestimmten Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch.

Felder
annual_loan_payment	Money Jährliche Kreditzahlungen.
rebate_value	Money Der Wert aller Steuervergünstigungen (einschließlich des Bundesinvestitionssteuerguthabens).
loan_interest_rate	float Der in diesen Berechnungen angenommene Zinssatz für Kredite.
savings	SavingsOverTime Wie viel wird über den gesamten Zeitraum gespart (oder nicht)?

FinancialAnalysis

Analyse der Kosten und Vorteile der optimalen Solaranlage für eine bestimmte Stromrechnung.

Felder
monthly_bill	Money Die monatliche Stromrechnung, die für diese Analyse angenommen wird.
default_bill	bool 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 FinancialAnalysis in BuildingSolarPotential sollte default_bill festgelegt sein.
average_kwh_per_month	float Der Stromverbrauch des Hauses in einem durchschnittlichen Monat, basierend auf der Höhe der Rechnung und den lokalen Strompreisen.
financial_details	FinancialDetails Finanzinformationen, die unabhängig von der verwendeten Finanzierungsmethode gelten.
leasing_savings	LeasingSavings Kosten und Nutzen des Leasings der Solarmodule.
cash_purchase_savings	CashPurchaseSavings Kosten und Nutzen des Kaufs der Solarmodule in bar.
financed_purchase_savings	FinancedPurchaseSavings Kosten und Nutzen des Kaufs der Solarmodule durch Finanzierung des Kaufs.
panel_config_index	int32 Index in solar_panel_configs des optimalen Solarlayouts für diese Rechnungsgröße. Dies kann „-1“ sein, was bedeutet, dass kein Layout vorhanden ist. In diesem Fall werden die verbleibenden Unternachrichten weggelassen.

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 panel_lifetime_years in SolarPotential definiert ist. Hinweis: Die Selbstkosten für den Kauf der Panels sind im Feld out_of_pocket_cost in CashPurchaseSavings angegeben.

Felder
initial_ac_kwh_per_year	float Die geschätzte Menge an Wechselstrom-kWh, die die Solarmodule im ersten Jahr erzeugen werden.
remaining_lifetime_utility_bill	Money Stromrechnung für Strom, der nicht durch Solarenergie erzeugt wird, während der Lebensdauer der Module.
federal_incentive	Money Verfügbarer Geldbetrag aus Bundessubventionen. Dies gilt, wenn der Nutzer die Module (mit oder ohne Kredit) kauft.
state_incentive	Money Verfügbarer Geldbetrag aus staatlichen Zuschüssen. Dies gilt, wenn der Nutzer die Module (mit oder ohne Kredit) kauft.
utility_incentive	Money Geldbetrag, der über die Zuschüsse des Energieversorgers verfügbar ist. Dies gilt, wenn der Nutzer die Module (mit oder ohne Kredit) kauft.
lifetime_srec_total	Money 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_of_electricity_without_solar	Money Die Gesamtkosten für Strom, die der Nutzer während der Lebensdauer gezahlt hätte, wenn er keine Solaranlage installiert hätte.
net_metering_allowed	bool Gibt an, ob Net-Metering zulässig ist.
solar_percentage	float 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_exported_to_grid	float Der Prozentsatz (0–100) der Solarstromerzeugung, der laut unseren Annahmen im ersten Produktionsquartal in das Netz exportiert wurde. Das hat Auswirkungen auf die Berechnungen, wenn Net-Metering nicht zulässig ist.

FindClosestBuildingInsightsRequest

Anfragenachricht für Solar.FindClosestBuildingInsights.

Felder
location	LatLng Erforderlich. Der Längen- und Breitengrad, an dem die API nach dem nächstgelegenen bekannten Gebäude sucht.
required_quality	ImageryQuality 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.

GetDataLayersRequest

Anfragenachricht für Solar.GetDataLayers.

Felder
location	LatLng Erforderlich. Längen- und Breitengrad für den Mittelpunkt der Region, für die Daten abgerufen werden sollen.
radius_meters	float Erforderlich. Der Radius in Metern, der den Bereich um den Mittelpunkt herum definiert, für den Daten zurückgegeben werden sollen. Für diesen Wert gelten folgende Einschränkungen: Es kann immer ein Wert bis zu 100 m angegeben werden. Werte über 100 m sind zulässig, solange radius_meters <= pixel_size_meters * 1000. Bei Werten über 175 m darf DataLayerView in der Anfrage jedoch keinen monatlichen Fluss oder stündlichen Schatten enthalten.
view	DataLayerView Optional. Die gewünschte Teilmenge der Daten, die zurückgegeben werden sollen.
required_quality	ImageryQuality 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.
pixel_size_meters	float Optional. Die minimale Skalierung der zurückzugebenden Daten in Metern pro Pixel. Es werden die Werte 0,1 (Standardwert, wenn dieses Feld nicht explizit festgelegt ist), 0,25, 0,5 und 1,0 unterstützt. Bildkomponenten, deren normale Auflösung unter pixel_size_meters liegt, werden mit der von pixel_size_meters angegebenen Auflösung zurückgegeben. Bildkomponenten, deren normale Auflösung pixel_size_meters entspricht oder übersteigt, werden mit dieser normalen Auflösung zurückgegeben.
exact_quality_required	bool Optional. Ob eine genaue Qualität der Bilder erforderlich ist. Wenn „false“ festgelegt ist, wird das Feld „required_quality“ als Mindestqualität interpretiert. Wenn „required_quality“ auf „MEDIUM“ festgelegt ist, können Bilder in hoher Qualität zurückgegeben werden. Wenn „true“ festgelegt ist, wird required_quality als genau die erforderliche Qualität interpretiert. Wenn required_quality auf MEDIUM festgelegt ist, werden nur Bilder mit der Qualität MEDIUM zurückgegeben.

GetGeoTiffRequest

Anfragenachricht für Solar.GetGeoTiff.

Felder
id	string Erforderlich. Die ID des angeforderten Assets.

ImageryQuality

Die Qualität der Bilder, die zum Berechnen eines API-Ergebnisses verwendet werden.

Hinweis: Unabhängig von der Qualität der Bilder haben DSM-Ausgaben immer eine Auflösung von 0, 1 m/Pixel, monatliche Flussausgaben immer eine Auflösung von 0, 5 m/Pixel und stündliche Schattenausgaben immer eine Auflösung von 1 m/Pixel.

Enums
IMAGERY_QUALITY_UNSPECIFIED	Die Qualität ist nicht bekannt.
HIGH	Die Sonnendaten stammen aus Luftbildern, die in niedriger Höhe aufgenommen und mit einer Auflösung von 0,1 m/Pixel verarbeitet wurden.
MEDIUM	Die Solardaten werden aus verbesserten Luftbildern abgeleitet, die in großer Höhe aufgenommen und mit einer Auflösung von 0,25 m/Pixel verarbeitet wurden.
LOW	Die Solardaten stammen aus optimierten Satellitenbildern, die mit einer Auflösung von 0,25 m/Pixel verarbeitet wurden.
BASE	Die Solardaten stammen aus optimierten Satellitenbildern, die mit einer Auflösung von 0,25 m/Pixel verarbeitet wurden.

LatLngBox

Ein Begrenzungsrahmen in Breiten-/Längengradkoordinaten.

Felder
sw	LatLng Die Südwestecke des Felds.
ne	LatLng Die nordöstliche Ecke des Felds.

LeasingSavings

Kosten und Nutzen des Leasings einer bestimmten Konfiguration von Solarmodulen mit einem bestimmten Stromverbrauch.

Felder
leases_allowed	bool 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_supported	bool 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 leases_allowed: In einigen Regionen sind Leasingverträge zulässig, aber unter Bedingungen, die von den Finanzmodellen nicht berücksichtigt werden.
annual_leasing_cost	Money Geschätzte jährliche Leasingkosten.
savings	SavingsOverTime Wie viel wird über den gesamten Zeitraum gespart (oder nicht)?

RoofSegmentSizeAndSunshineStats

Informationen zur Größe und Sonneneinstrahlung eines Dachsegments.

Felder
stats	SizeAndSunshineStats Gesamtgröße und Sonneneinstrahlungsquantile für das Dachsegment.
center	LatLng Ein Punkt in der Nähe der Mitte des Dachsegments.
bounding_box	LatLngBox Der Begrenzungsrahmen des Dachsegments.
pitch_degrees	float Winkel des Dachsegments relativ zur theoretischen Bodenebene. 0 = parallel zum Boden, 90 = senkrecht zum Boden.
azimuth_degrees	float Kompassrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Bei einem „flachen“ Dachsegment (pitch_degrees sehr nahe bei 0) ist der Azimut nicht klar definiert. Aus Gründen der Einheitlichkeit wird er daher willkürlich auf 0 (Norden) festgelegt.
plane_height_at_center_meters	float Die Höhe der Dachsegmentebene in Metern über dem Meeresspiegel am Punkt center. Zusammen mit Neigung, Azimut und Mittelpunkt wird damit die Ebene des Dachsegments vollständig definiert.

RoofSegmentSummary

Informationen zu einem Dachsegment des Gebäudes mit einer bestimmten Anzahl von Paneelen.

Felder
panels_count	int32 Die Gesamtzahl der Panels in diesem Segment.
yearly_energy_dc_kwh	float Die Menge der Sonnenenergie, die dieser Teil des Layouts im Laufe eines Jahres in Gleichstrom-kWh unter der Annahme der oben beschriebenen Module einfängt.
pitch_degrees	float Winkel des Dachsegments relativ zur theoretischen Bodenebene. 0 = parallel zum Boden, 90 = senkrecht zum Boden.
azimuth_degrees	float Kompassrichtung, in die das Dachsegment zeigt. 0 = Norden, 90 = Osten, 180 = Süden. Bei einem „flachen“ Dachsegment (pitch_degrees sehr nahe bei 0) ist der Azimut nicht klar definiert. Aus Gründen der Einheitlichkeit wird er daher willkürlich auf 0 (Norden) festgelegt.
segment_index	int32 Index in roof_segment_stats der entsprechenden RoofSegmentSizeAndSunshineStats.

SavingsOverTime

Finanzielle Informationen, die für verschiedene Finanzierungsmethoden freigegeben werden.

Felder
savings_year1	Money Einsparungen im ersten Jahr nach der Installation der Solarmodule.
savings_year20	Money Einsparungen in den ersten 20 Jahren nach der Installation der Module.
present_value_of_savings_year20	Money Wie hoch ist der Barwert der kumulativen Einsparungen über 20 Jahre unter Berücksichtigung des angenommenen Abzinsungssatzes?
savings_lifetime	Money Einsparungen über die gesamte Lebensdauer des Panels.
present_value_of_savings_lifetime	Money Wie hoch ist der Barwert der kumulativen Einsparungen während der gesamten Lebensdauer unter Berücksichtigung des angenommenen Diskontsatzes?
financially_viable	bool Gibt an, ob dieses Szenario finanziell tragfähig ist. Für Szenarien mit schlechter finanzieller Leistungsfähigkeit (z.B. Verluste) ist der Wert „false“.

SizeAndSunshineStats

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

Felder
area_meters2	float Die Fläche des Dachs oder Dachsegments in m². Dies ist die Dachfläche (mit Neigung), nicht die Grundfläche.
sunshine_quantiles[]	float 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. max_sunshine_hours_per_year.
ground_area_meters2	float Die vom Dach oder Dachsegment bedeckte Grundfläche in m².

SolarPanel

„SolarPanel“ beschreibt die Position, Ausrichtung und Produktion eines einzelnen Solarpanels. Informationen zu den Parametern des Steuerfelds finden Sie in den Feldern panel_height_meters, panel_width_meters und panel_capacity_watts in SolarPotential.

Felder
center	LatLng In der Mitte des Steuerfelds.
orientation	SolarPanelOrientation Die Ausrichtung des Steuerfelds.
yearly_energy_dc_kwh	float Die Sonnenenergie, die dieses Layout im Laufe eines Jahres in Gleichstrom-kWh einfängt.
segment_index	int32 Index in roof_segment_stats des RoofSegmentSizeAndSunshineStats, der dem Dachsegment entspricht, auf dem sich dieses Modul befindet.

SolarPanelConfig

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

Felder
panels_count	int32 Gesamtzahl der Panels. Hinweis: Dies ist redundant zu (der Summe der) entsprechenden Felder in roof_segment_summaries.
yearly_energy_dc_kwh	float Die Menge der Sonnenenergie, die dieses Layout im Laufe eines Jahres in DC-kWh erfasst, unter der Annahme der oben beschriebenen Module.
roof_segment_summaries[]	RoofSegmentSummary Informationen zur Produktion jedes Dachsegments, das in diesem Layout mindestens ein Modul enthält. roof_segment_summaries[i] beschreibt das i-te Dachsegment, einschließlich seiner Größe, der erwarteten Produktion und der Ausrichtung.

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.

SolarPotential

Informationen zum Solarpotenzial eines Gebäudes. Einige Felder darin sind in Bezug auf „Bereiche“ definiert. Die Felder panel_capacity_watts, panel_height_meters und panel_width_meters beschreiben die Parameter des in diesen Berechnungen verwendeten Modulmodells.

Felder
max_array_panels_count	int32 Größe des maximalen Arrays, d. h. die maximale Anzahl von Modulen, die auf das Dach passen.
panel_capacity_watts	float Die Kapazität des Panels in Watt, die bei den Berechnungen verwendet wurde.
panel_height_meters	float Höhe des Panels in Metern im Hochformat, die in den Berechnungen verwendet wird.
panel_width_meters	float Breite des Panels in Metern im Hochformat, die bei den Berechnungen verwendet wird.
panel_lifetime_years	int32 Die erwartete Lebensdauer der Solarmodule in Jahren. Dieser Wert wird in den Finanzberechnungen verwendet.
max_array_area_meters2	float Größe des maximalen Arrays in Quadratmetern.
max_sunshine_hours_per_year	float 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_offset_factor_kg_per_mwh	float 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_roof_stats	SizeAndSunshineStats 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_stats ansehen.
building_stats	SizeAndSunshineStats Größe und Sonneneinstrahlungsquantile für das gesamte Gebäude, einschließlich der Teile des Dachs, 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 whole_roof_stats mit dem Verhältnis der Grundflächen von building_stats und whole_roof_stats skaliert wird.
roof_segment_stats[]	RoofSegmentSizeAndSunshineStats Größe und Sonneneinstrahlungsquantile für jedes Dachsegment.
solar_panels[]	SolarPanel Jedes SolarPanel beschreibt ein einzelnes Solarmodul. Sie werden in der Reihenfolge aufgelistet, in der sie vom Algorithmus für das Bereichslayout platziert wurden. Dies erfolgt in der Regel, aber nicht immer, in absteigender Reihenfolge der jährlichen Energieerzeugung.
solar_panel_configs[]	SolarPanelConfig Jede SolarPanelConfig beschreibt eine andere Anordnung der Sonnenkollektoren auf dem Dach. Sie sind in aufsteigender Reihenfolge der Anzahl der Module angeordnet. Die SolarPanelConfig mit panels_count=N basiert auf den ersten N Panels in der Liste solar_panels. Dieses Feld wird nur ausgefüllt, wenn auf ein Dach mindestens vier Module passen.
financial_analyses[]	FinancialAnalysis Ein FinancialAnalysis gibt die Einsparungen durch die Umstellung auf Solarenergie unter der Annahme einer bestimmten monatlichen Rechnung und eines bestimmten Stromanbieters an. Sie sind in aufsteigender Reihenfolge des monatlichen Rechnungsbetrags aufgeführt. Dieses Feld ist für Gebäude in Gebieten leer, für die die Solar API nicht genügend Informationen für finanzielle Berechnungen hat.