REST Resource: dataLayers

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 (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
Felder
imageryDate

object (Date)

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

object (Date)

Wann die Verarbeitung dieser Bilder abgeschlossen wurde.
dsmUrl

string

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

string

Die URL für eine RGB-Daten-Luftaufnahme der Region.
maskUrl

string

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

string

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

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. Das GeoTIFF, auf das durch diese URL verwiesen wird, enthält in dieser Reihenfolge zwölf Bereiche, die der Reihenfolge Januar...Dezember entsprechen.
hourlyShadeUrls[]

string

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:

  1. die sechste URL in dieser Liste (für Juni) abrufen.
  2. den 17. Channel suchen (entspricht 16 Uhr).
  3. den 32-Bit-Wert bei (x, y) lesen.
  4. Lese-Bit 21 des Werts (entspricht dem 22. des Monats).
  5. Wenn dieses Bit eine 1 ist, hat dieser Fleck am 22. Juni um 16:00 Uhr die Sonne gesehen.

Genauer gesagt: Bei month (1–12), day (max. 1 Monat; Februar hat 28 Tage) und hour (0–23) ist der Schatten/Sonne für diesen Monat/Tag/die Stunde an einer Position (x, y) der Bit

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

Dabei steht (x, y) für die räumliche Indexierung, [month - 1] auf das Abrufen der month - 1. URL (Indexierung von null), [hour] die Indexierung in den Kanälen und ein endgültiges Ergebnis ungleich null bedeutet „sonnig“. Es gibt keine Schalttage und die Sommerzeit gibt es auch nicht. Alle Tage sind 24 Stunden lang; Mittag ist immer mittags zur Standardzeit.
imageryQuality

enum (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:

JSON-Darstellung 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen, oder 0, um ein Datum ohne Jahr anzugeben.
month

integer

Monat eines Jahres. Muss zwischen 1 und 12 liegen, oder 0, um ein Jahr ohne Monat und Tag anzugeben.
day

integer

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

get

 Ruft Solarinformationen für eine Region rund um einen Standort ab.