REST Resource: dataLayers

Ressource: DataLayers

Informationen zum Solarpotenzial einer Region. Die eigentlichen Daten sind in verschiedenen GeoTIFF-Dateien enthalten, die die angeforderte Region abdecken und für die diese Nachricht URLs enthält: Jede Zeichenfolge in der DataLayers-Nachricht enthält eine URL, von der das entsprechende GeoTIFF 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 monatliche Flux-Datei liegt jedoch bei 0,5 m/Pixel und die stündlichen Schattierungsdateien liegen bei 1 m/Pixel. Wenn in GetDataLayersRequest ein pixelSizeMeters-Wert angegeben wurde, entspricht die Mindestauflö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)

Zeitpunkt, an dem das Quellbild in dieser Region erstellt wurde, von dem alle anderen Daten abgeleitet wurden Dabei handelt es sich nicht unbedingt um eine ungefähre Angabe, da die Bilder möglicherweise mehr als einen Tag lang aufgenommen wurden.
imageryProcessedDate

object (Date)

Zeitpunkt, zu dem die Verarbeitung dieses Bildes abgeschlossen wurde.
dsmUrl

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 uns keine Daten vorliegen) werden als -9999 gespeichert.
rgbUrl

string

Die URL für ein Bild der 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 eines Dachs 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 kWh/kW/Jahr. Dies ist der unmaskierte 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 Flux nicht berechnen konnten, sind ebenfalls ungültig.
monthlyFluxUrl

string

Die URL für die monatliche Flusskarte (Sonnenlicht auf Dächern, nach Monat aufgeschlüsselt) für die Region. Die Werte sind kWh/kW/Jahr. Das GeoTIFF, auf das diese URL verweist, enthält zwölf Bänder, wobei die Werte der Reihenfolge Januar bis Dezember entsprechen.
hourlyShadeUrls[]

string

Zwölf URLs für die stündliche Farbschattierung, entsprechend der Reihenfolge Januar bis Dezember. Jedes GeoTIFF 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 1-Bit bedeutet, dass der entsprechende Standort die Sonne an diesem Tag zu dieser Stunde des Monats sehen kann. Ungültige Standorte werden als -9999 gespeichert (da dies negativ ist, Bit 31 festgelegt ist und kein gültiger Wert Bit 31 festgelegt haben könnte, da dieser dem 32. Tag des Monats entsprechen würde).

Ein Beispiel könnte hilfreich sein. Wenn Sie wissen möchten, ob ein Punkt (an der Pixelposition (x, y)) am 22. Juni um 16 Uhr die Sonne gesehen hat, gehen Sie so vor:

  1. die sechste URL in dieser Liste (die entspricht Juni) abrufen.
  2. nach dem 17. Kanal suchen (entspricht 16 Uhr).
  3. den 32-Bit-Wert bei (x, y) lesen.
  4. Bit 21 des Werts lesen (entsprechend dem 22. des Monats).
  5. Wenn dieser Teil eine 1 ist, dann hat dieser Ort am 22. Juni um 16:00 Uhr die Sonne gesehen.

Formeller: Bei month (1–12), day (max. 1 Monat; Februar hat 28 Tage) und hour (0–23) ist die Schatten/Sonne für diesen Monat/Tag/diese Stunde an der 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 von null), [hour] indexiert für die Kanäle und ein endgültiges Ergebnis ungleich null bedeutet „sonnig“. Es gibt keine Schalttage und die Sommerzeit gibt es nicht. Alle Tage umfassen 24 Stunden und Mittag ist immer „Normalzeit“.
imageryQuality

enum (ImageryQuality)

Die Qualität der Bilder 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 darstellen:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
  • Ein Monat und ein Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
  • Ein Jahr für sich alleine, mit einem Monat und einem Tag von null.
  • Ein Jahr und ein Monat mit 0 Tag (z. B. dem Ablaufdatum einer Kreditkarte).

Ähnliche Typen:

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

integer

Jahr des Datums. 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 im Monat. Muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein, oder 0, um ein Jahr allein oder ein Jahr und Monat anzugeben, wenn 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 DSM-Ausgaben immer eine Auflösung von 0, 1 m/Pixel, monatliche Flux-Ausgaben haben immer eine Auflösung von 0, 5 m/Pixel und stündliche Schattierungen haben immer eine Auflösung von 1 m/Pixel.

Enums
IMAGERY_QUALITY_UNSPECIFIED Keine Qualität bekannt.
HIGH Das zugrunde liegende Bild und die DSM-Daten wurden mit 0,1 m/Pixel verarbeitet.
MEDIUM Das zugrunde liegende Bild und die DSM-Daten wurden mit 0,25 m/Pixel verarbeitet.
LOW Das zugrunde liegende Bild und die DSM-Daten wurden mit 0,5 m/Pixel verarbeitet.

Methoden

get

 Ruft Solardaten für eine Region in der Umgebung eines Standorts ab.