Der Endpunkt dataLayers gibt als GeoTIFF-Dateien codierte Daten zurück, die in jeder beliebigen GIS-Anwendung (geografisches Informationssystem) zum Entwerfen von Solarsystemen verwendet werden können.
Jeder String in der „dataLayers“-Antwort enthält eine URL, mit der Sie das entsprechende GeoTIFF abrufen können. URLs sind bis zu einer Stunde gültig, nachdem sie aus der ursprünglichen Datenebenenanfrage generiert wurden. GeoTIFF-Dateien können bis zu 30 Tage lang gespeichert werden.
Mit Ausnahme der RGB-Ebene werden GeoTIFF-Dateien in einem Bildanzeigeprogramm nicht korrekt angezeigt, da es sich bei den Inhalten um codierte Daten und nicht um RGB-Bilder handelt. Außerdem können GeoTIFF-Dateien mit der Maps JavaScript API nicht direkt als Overlay-Bild verwendet werden.
In der folgenden Tabelle werden die einzelnen Ebenen ausführlich beschrieben.
| Layer | Pixeltiefe | Auflösung | Beschreibung |
|---|---|---|---|
| Digitales Oberflächenmodell (DSM) | 32-Bit-Gleitkommazahl | 0,1 m/Pixel | Höhendaten für die Topografie der Erdoberfläche, einschließlich natürlicher und gebauter Elemente. Die Werte werden in Metern über dem Meeresspiegel angegeben. Ungültige Standorte oder Regionen, für die uns keine Daten vorliegen, werden als -9999 gespeichert. |
| RGB | 8-Bit | 0,1 m/pixel 0,25 m/pixel 0,5 m/pixel 1 m/pixel |
Luftaufnahme der Region. Die GeoTIFF-Bilddatei enthält drei Bänder, die Rot-, Grün- und Blauwerten entsprechen, um einen 24-Bit-RGB-Wert für jedes Pixel zu bilden. Standardmäßig beträgt die Pixelauflösung 0,1 m/Pixel. |
| Gebäudemaske | 1 Bit | 0,1 m/Pixel | Ein Bit pro Pixel, das angibt, ob dieses Pixel als Teil eines Dachs angesehen wird. |
| Jährlicher Fluss | 32-Bit-Gleitkommazahl | 0,1 m/Pixel | Die jährliche Flusskarte oder die jährliche Sonneneinstrahlung auf den Dächern der Region.
Die Werte sind kWh/kW/Jahr. Der Flussfluss wird für jeden Standort berechnet, nicht nur für Dächer. Ungültige Standorte oder Gebiete, in denen der Flusswert nicht berechnet werden konnte, werden als -9999 gespeichert. Standorte außerhalb des Abdeckungsbereichs sind ungültig. Hinweis:Dies ist ein nicht maskierter Fluss. |
| Monatlicher Fluss | 32-Bit-Gleitkommazahl | 0,5 m/Pixel | Die monatliche Flusskarte (Sonnenlicht auf Dächern, nach Monat aufgeschlüsselt) der Region. Die Werte sind kWh/kW/Jahr. Die GeoTIFF-Bilddatei enthält zwölf Bänder, die der Reihenfolge Januar bis Dezember entsprechen. |
| Stündlicher Farbton | 32-Bit-Ganzzahl | 1 m/Pixel | 12 URLs für stündliche Shading Maps für Januar bis Dezember in der entsprechenden 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 bedeutet, dass der entsprechende Standort die Sonne an diesem Tag zu dieser Stunde in diesem Monat sehen kann. Ungültige Standorte werden als -9999 gespeichert und Bit 31 festgelegt, da dies dem 32. Tag des Monats entspricht und daher ungültig ist. |
Stündliche Schattierungsraster decodieren
Stündliche Schattierungsdaten werden in Multiband-Rastern codiert. Weitere Informationen zu den Rastergrundlagen finden Sie unter Konzepte der Solar API.
Wenn Sie stündliche Schattierungsdaten anfordern, können Sie bis zu 12 Raster erhalten, eines für jeden Monat des Kalenderjahres (Januar bis Dezember). Jedes Raster besteht aus 24 Schichten oder Bändern, die den 24 Stunden des Tages entsprechen.
Jeder Bereich wird durch eine Matrix von Zellen oder Pixeln dargestellt. Jedes Pixel hat eine Tiefe von 32 Bit, was den (maximal) 31 Tagen des Monats entspricht. Für die Decodierung von Tag, Uhrzeit und Monat müssen daher Bit, Band und Raster verstanden werden, die Sie analysieren.
Wenn Sie beispielsweise herausfinden möchten, ob an einem bestimmten Ort an den Koordinaten (x, y) am 22. Juni um 16:00 Uhr die Sonne gesonnen war, gehen Sie so vor:
- Stellen Sie eine Datenschichtanfrage für alle Ebenen für den Standort (x, y).
- Da der Monat Juni der sechste Monat des Jahres ist, rufen Sie die sechste URL in der Liste
hourlyShadeUrlsab. - Stündliche Bänder werden im 24-Stunden-Format angegeben. Um die Daten für 16:00 Uhr (16:00 Uhr) zu erhalten, suchen Sie nach dem 17. Kanal.
- Bits-Index (Tage) ab 0. Um Daten für den 22. Juni zu erhalten, lesen Sie Bit 21.
- Bits liefern binäre Daten, die angeben, ob an diesem Ort zum gegebenen Datum und zur angegebenen Uhrzeit die Sonne gesehen wurde. Wenn der Bit-Wert 1 ist, wurde am Standort die Sonne erkannt. Ist das Bit 0, wurde der Standort farbig hervorgehoben.
Der folgende Code fasst die obigen Schritte zusammen:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))