REST Resource: dataLayers

Ressource: DataLayers

Informationen zum Solarpotenzial einer Region. Die tatsächlichen Daten sind in einer Reihe von GeoTIFF-Dateien enthalten, 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 das entsprechende GeoTIFF abgerufen werden kann. Diese URLs sind einige Stunden nach der Generierung gültig. Die meisten GeoTIFF-Dateien haben eine Auflösung von 0,1 m/Pixel, die monatliche Flussdatei jedoch 0,5 m/Pixel und die stündlichen Schatten-Dateien 1 m/Pixel. Wenn in der 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)

Wann die Quellbilder (aus denen alle anderen Daten abgeleitet werden) in dieser Region aufgenommen wurden. Die Angaben sind notwendigerweise etwas ungenau, da die Bilder möglicherweise an mehreren Tagen aufgenommen wurden.
imageryProcessedDate

object (Date)

Wann die Verarbeitung dieser Bilder abgeschlossen wurde.
dsmUrl

string

Die URL für ein Bild des digitalen Oberflächenmodells (Digital Surface Model, DSM) der Region. Die Werte werden in Metern über dem EGM96-Geoid (d.h. über dem Meeresspiegel) angegeben. Ungültige Standorte (für die keine Daten vorhanden sind) werden als „-9999“ gespeichert.
rgbUrl

string

Die URL für ein Bild mit RGB-Daten (Luftbild) 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 Daches betrachtet wird oder nicht.
annualFluxUrl

string

Die URL für die Karte mit dem jährlichen Fluss (jährliches Sonnenlicht auf Dächern) der Region. Die Werte werden in kWh/kW/Jahr angegeben. Das 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. Das gilt auch für einige Standorte innerhalb des Abdeckungsbereichs, für die wir keinen Fluss berechnen konnten.
monthlyFluxUrl

string

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

string

Zwölf URLs für stündliche Schatten, entsprechend Januar bis Dezember in der richtigen Reihenfolge. Jedes GeoTIFF enthält 24 Bänder, die den 24 Stunden des Tages entsprechen. Jeder Pixel ist eine 32-Bit-Ganzzahl, die den (bis zu) 31 Tagen des jeweiligen Monats entspricht. Ein Bit mit dem Wert 1 bedeutet, dass der entsprechende Ort an diesem Tag, zu dieser Stunde und in diesem Monat der Sonne ausgesetzt ist. Ungültige Orte werden als -9999 gespeichert. Da dieser Wert negativ ist, ist Bit 31 gesetzt. Kein gültiger Wert kann Bit 31 gesetzt haben, da dies dem 32. Tag des Monats entsprechen würde.

Ein Beispiel kann hilfreich sein. Wenn Sie wissen möchten, ob ein Punkt (an der Pixelposition (x, y)) am 22. Juni um 16:00 Uhr von der Sonne beschienen wurde, gehen Sie so vor:

  1. die sechste URL in dieser Liste abrufen (entspricht Juni).
  2. Suchen Sie nach dem 17. Kanal (entsprechend 16:00 Uhr).
  3. Liest den 32‑Bit-Wert an der Position (x, y).
  4. Liest Bit 21 des Werts (entspricht dem 22. des Monats).
  5. Wenn das Bit eine 1 ist, hat die Sonne diesen Ort am 22. Juni um 16:00 Uhr erreicht.

Formaler: Bei month (1–12), day (1...Monatsmaximum; der Februar hat 28 Tage) und hour (0–23) ist der Schatten/die Sonne für diesen Monat/Tag/diese 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] für das Abrufen der month - 1. URL (Indexierung ab null), [hour] für die Indexierung in die Channels und ein endgültiges Ergebnis ungleich null für „sonnig“. Es gibt keine Schalttage und keine Sommerzeit (alle Tage sind 24 Stunden lang; Mittag ist immer „Normalzeit“-Mittag).
imageryQuality

enum (ImageryQuality)

Die Qualität der Bilder im Ergebnis.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum wird relativ zum gregorianischen Kalender angegeben. Das kann Folgendes darstellen:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind.
  • Einen Monat und einen Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
  • Ein Jahr für sich, mit einem Monat und einem Tag von 0.
  • Ein Jahr und ein Monat mit einem Tag von 0, z. B. ein Ablaufdatum der Kreditkarte.

Ähnliche Typen:

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

integer

Jahr des Datums. Muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahresangabe angegeben wird.
month

integer

Monat eines Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.
day

integer

Tag des Monats. Die Angabe muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht von Belang ist.

ImageryQuality

Die Qualität der Bilder, die zur Berechnung einiger API-Ergebnisse verwendet werden.

Hinweis: Unabhängig von der Bildqualität 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 Es ist keine Qualität bekannt.
HIGH Solardaten werden aus Luftbildern abgeleitet, die in geringer Höhe aufgenommen und mit einer Auflösung von 0,1 m/Pixel verarbeitet werden.
MEDIUM Solardaten werden aus verbesserten Luftbildern abgeleitet, die in großer Höhe aufgenommen und mit einer Auflösung von 0,25 m/Pixel verarbeitet werden.
BASE Solardaten werden aus optimierten Satellitenbildern mit einer Auflösung von 0,25 m/Pixel abgeleitet.

Methoden

get

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