REST Resource: dataLayers

Ressource: 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 pixelSizeMeters-Wert angegeben wurde, ist dies die Mindestauflösung in den GeoTIFF-Dateien.

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)

Das Datum, an dem die Quellbilder (aus denen alle anderen Daten abgeleitet werden) in dieser Region aufgenommen wurden. Dieser Wert ist 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 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.
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 gibt an, ob dieses Pixel als Teil eines Daches betrachtet wird oder nicht.
annualFluxUrl

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.
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 angegeben. Das GeoTIFF, auf das diese URL verweist, enthält zwölf Bänder, die den Monaten Januar bis Dezember entsprechen.
hourlyShadeUrls[]

string

Zwölf URLs für stündliche Schatten, entsprechend 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, 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:

  1. die sechste URL in dieser Liste abrufen (entspricht dem Juni).
  2. Suchen Sie den 17. Kanal (entspricht 16:00 Uhr).
  3. den 32‑Bit-Wert an (x, y) lesen.
  4. Bit 21 des Werts lesen (entspricht dem 22. des Monats).
  5. Wenn dieses Bit eine 1 ist, wurde der Ort am 22. Juni um 16:00 Uhr von der Sonne beschienen.

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 „Mittag“ (Standardzeit).
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 bedeuten:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind.
  • Einen Monat und Tag mit dem Wert „0“ für das Jahr (z. B. ein Jahrestag).
  • Ein Jahr für sich, mit dem Wert „0“ für Monat und Tag.
  • Ein Jahr und ein Monat mit dem Wert „0“ für den Tag (z. B. das Ablaufdatum einer Kreditkarte).

Ähnliche Typen:

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

integer

Das Jahr des Datums. Es 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 zum Berechnen 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 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 Solardaten 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.

Methoden

get

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