Ressource: DataLayers
Informationen über das Solarpotenzial einer Region. Die tatsächlichen Daten sind in mehreren GeoTIFF-Dateien für die angeforderte Region enthalten, für die diese Nachricht URLs enthält: Jeder String in der DataLayers
-Nachricht enthält eine URL, von der das entsprechende GeoTIFF abgerufen werden kann. Diese URLs sind nach ihrer Generierung einige Stunden lang gültig. Die meisten GeoTIFF-Dateien haben eine Auflösung von 0,1 m/Pixel, aber die monatliche Flussdatei liegt bei 0,5 m/Pixel und die stündlichen Schattierungsdateien bei 1 m/Pixel. Wenn in GetDataLayersRequest
ein pixelSizeMeters
-Wert angegeben wurde, entspricht die minimale Auflösung in den GeoTIFF-Dateien diesem Wert.
JSON-Darstellung |
---|
{ "imageryDate": { object ( |
Felder | |
---|---|
imageryDate |
Wann die Quellbilder (aus denen alle anderen Daten stammen) in dieser Region aufgenommen wurden. Es handelt sich zwangsläufig um einen ungefähren Wert, da die Bilder möglicherweise mehr als einen Tag lang aufgenommen wurden. |
imageryProcessedDate |
Wann die Verarbeitung dieser Bilder abgeschlossen wurde. |
dsmUrl |
Die URL für ein Bild des DSM (Digital Surface Model) der Region. Die Werte werden in Metern über dem EGM96-Geoid (d.h. dem Meeresspiegel) angegeben. Ungültige Standorte (für die uns keine Daten vorliegen) werden als -9999 gespeichert. |
rgbUrl |
Die URL für eine RGB-Daten-Luftaufnahme der Region. |
maskUrl |
Die URL für das Bild der Gebäudemaske: ein Bit pro Pixel, das angibt, ob das Pixel als Teil einer Dächer angesehen wird oder nicht. |
annualFluxUrl |
Die URL für die jährliche Flusskarte (jährliche Sonneneinstrahlung auf Dächern) der Region. Die Werte sind in kWh/kW/Jahr. Dies ist der nicht maskierte 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 und einige Standorte innerhalb des Abdeckungsbereichs, für die wir den Fluss nicht berechnen konnten, sind ebenfalls ungültig. |
monthlyFluxUrl |
Die URL für die monatliche Flusskarte (Sonnenlicht auf Dächern, aufgeschlüsselt nach Monat) der Region. Die Werte sind in kWh/kW/Jahr. Das GeoTIFF, auf das durch diese URL verwiesen wird, enthält in dieser Reihenfolge zwölf Bereiche, die der Reihenfolge Januar...Dezember entsprechen. |
hourlyShadeUrls[] |
Zwölf URLs für den stündlichen Farbton, entsprechend der Reihenfolge Januar...Dezember. Jedes GeoTIFF enthält 24 Bereiche, die den 24 Stunden des Tages entsprechen. Jedes Pixel ist eine 32-Bit-Ganzzahl, die den (bis zu) 31 Tagen des Monats entspricht. Ein 1 Bit bedeutet, dass der entsprechende Ort die Sonne an diesem Tag, in dieser Stunde und in diesem Monat sehen kann. Ungültige Standorte werden als -9999 gespeichert (da dies negativ ist, ist Bit 31 eingestellt und für keinen gültigen Wert kann Bit 31 festgelegt werden, der dem 32. Tag des Monats entsprechen würde). Ein Beispiel könnte hilfreich sein. Wenn Sie wissen möchten, ob ein Punkt (an Pixelposition (x, y)) am 22. Juni um 16:00 Uhr die Sonne gesehen hat, gehen Sie so vor:
Genauer gesagt: Bei
Dabei steht |
imageryQuality |
Die Bildqualität des Ergebnisses. |
Datum
Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Tageszeit und Zeitzone werden entweder an anderer Stelle angegeben oder sind unbedeutend. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes bedeuten:
- Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
- Monat und Tag mit einem Jahr 0 (z. B. ein Jahrestag)
- Ein Jahr für sich allein, mit einem Monat 0 und einem Tag 0.
- Ein Jahr und ein Monat mit einem Tag null (z. B. das Ablaufdatum einer Kreditkarte).
Ähnliche Typen:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON-Darstellung |
---|
{ "year": integer, "month": integer, "day": integer } |
Felder | |
---|---|
year |
Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen, oder 0, um ein Datum ohne Jahr anzugeben. |
month |
Monat eines Jahres. Muss zwischen 1 und 12 liegen, oder 0, um ein Jahr ohne Monat und Tag anzugeben. |
day |
Tag eines Monats Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Mit 0 können Sie ein Jahr allein oder ein Jahr und einen Monat angeben, bei dem der Tag nicht von Bedeutung ist. |
ImageryQuality
Die Qualität der Bilder, die zur Berechnung eines API-Ergebnisses verwendet werden.
Hinweis: Unabhängig von der Bildqualität haben die DSM-Ausgaben immer eine Auflösung von 0, 1 m/Pixel, die monatlichen Flussausgaben haben immer eine Auflösung von 0, 5 m/Pixel und die stündliche Farbtöne immer eine Auflösung von 1 m/Pixel.
Enums | |
---|---|
IMAGERY_QUALITY_UNSPECIFIED |
Die Qualität ist nicht bekannt. |
HIGH |
Die zugrunde liegenden Bild- und DSM-Daten wurden mit 0,1 m/Pixel verarbeitet. |
MEDIUM |
Die zugrunde liegenden Bild- und DSM-Daten wurden mit 0,25 m/Pixel verarbeitet. |
LOW |
Die zugrunde liegenden Bild- und DSM-Daten wurden mit 0,5 m/Pixel verarbeitet. |
Methoden |
|
---|---|
|
Ruft Solarinformationen für eine Region rund um einen Standort ab. |