Der Endpunkt dataLayers gibt Daten zurück, die als GeoTIFF-Dateien codiert sind und in jeder GIS-Anwendung (Geographic Information System) zum Entwerfen von Solarsystemen verwendet werden können.
Jeder String in der Antwort „dataLayers“ enthält eine URL, über die Sie das entsprechende GeoTIFF abrufen können. URLs sind bis zu eine Stunde lang gültig, nachdem sie aus der ursprünglichen Anfrage für Datenebenen generiert wurden. GeoTIFF-Dateien können bis zu 30 Tage lang gespeichert werden.
Mit Ausnahme der RGB-Ebene werden GeoTIFF-Dateien in einem Bildbetrachter nicht korrekt angezeigt, da es sich bei den Inhalten um codierte Daten und nicht um RGB-Bilder handelt. GeoTIFF-Dateien können auch nicht direkt als Overlay-Bild mit der Maps JavaScript API verwendet werden.
In der folgenden Tabelle werden die einzelnen Ebenen ausführlich beschrieben.
| Ebene | Pixeltiefe | Auflösung | Beschreibung |
|---|---|---|---|
| Digitales Oberflächenmodell (DSM) | 32-Bit-Gleitkommazahl | 0,1 m/Pixel | Höhendaten, die die Topografie der Erdoberfläche darstellen, einschließlich natürlicher und künstlicher Elemente. Die Werte sind in Metern über dem Meeresspiegel angegeben. Ungültige Standorte oder Gebiete, für die wir keine Daten haben, werden als -9999 gespeichert. |
| RGB | 8-Bit | 0,1 m/Pixel 0,25 m/Pixel 0,5 m/Pixel 1 m/Pixel |
Eine Luftaufnahme der Region. Die GeoTIFF-Bilddatei enthält drei Bänder, die den Rot-, Grün- und Blauwerten entsprechen, um einen 24-Bit-RGB-Wert für jedes Pixel zu bilden. Die Standardpixelauflösung beträgt 0,1 m/Pixel. |
| Gebäudemaske | 1 Bit | 0,1 m/Pixel | Ein Bit pro Pixel, das angibt, ob dieses Pixel als Teil eines Daches betrachtet wird. |
| Jährlicher Fluss | 32-Bit-Gleitkommazahl | 0,1 m/Pixel | Die Karte mit dem jährlichen Fluss oder der jährlichen Sonneneinstrahlung auf den Dächern der Region.
Die Werte sind in kWh/kW/Jahr angegeben. Der Fluss wird für jeden Standort berechnet, nicht nur für Gebäudedächer. Ungültige Standorte oder Gebiete, in denen wir den Fluss nicht berechnen konnten, werden als -9999 gespeichert. Standorte außerhalb unseres Abdeckungsbereichs sind ungültig. Hinweis:Dies ist der ungemaskierte Fluss. |
| Monatlicher Fluss | 32-Bit-Gleitkommazahl | 0,5 m/Pixel | Die Karte mit dem monatlichen Fluss (Sonnenlicht auf Dächern, aufgeschlüsselt nach Monat) der Region. Die Werte sind in kWh/kW/Jahr angegeben. Die GeoTIFF-Bilddatei enthält 12 Bänder, die den Monaten Januar bis Dezember entsprechen. |
| Stündliche Beschattung | 32-Bit-Ganzzahl | 1 m/Pixel | 12 URLs für stündliche Schattenkarten für 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 und in diesem Monat die Sonne sehen kann. Ungültige Standorte werden als -9999 gespeichert und Bit 31 ist gesetzt, da dies dem 32. Tag des Monats entspricht und daher ungültig ist. |
Stundenraster für Schatten decodieren
Stündliche Schattendaten werden in Multiband-Rastern codiert. Weitere Informationen zu Rastergrundlagen finden Sie unter Solar API-Konzepte.
Wenn Sie stündliche Schattendaten anfordern, können Sie bis zu 12 Raster erhalten, jeweils eines für jeden Monat des Kalenderjahres (Januar bis Dezember). Jedes Raster besteht aus 24 Ebenen oder Bändern, die den 24 Stunden des Tages entsprechen.
Jeder Streifen 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. Um den Tag, die Uhrzeit und den Monat von Schattendaten zu decodieren, müssen Sie daher die Bit-, Band- und Rasterdaten kennen, die Sie analysieren.
So ermitteln Sie beispielsweise, ob die Sonne am 22. Juni um 16:00 Uhr an einem bestimmten Ort mit den Koordinaten (x, y) zu sehen war:
- Stellen Sie eine Anfrage für Datenebenen für alle Ebenen für den Standort (x, y).
- Da Juni der sechste Monat des Jahres ist, rufen Sie die sechste URL in der Liste
hourlyShadeUrlsab. - Die stündlichen Zeitspannen werden im 24-Stunden-Format angegeben. Wenn Sie Daten für 16:00 Uhr benötigen, sehen Sie im 17. Kanal nach.
- Bits (Tage) beginnen mit 0. Wenn Sie Daten für den 22. Juni abrufen möchten, lesen Sie Bit 21.
- Bits liefern Binärdaten, die angeben, ob an diesem Ort am angegebenen Datum und zur angegebenen Uhrzeit die Sonne schien. Wenn das Bit den Wert 1 hat, war die Sonne am Standort zu sehen. Wenn das Bit den Wert 0 hat, war der Standort im Schatten.
Im folgenden Code sind die oben genannten Schritte zusammengefasst:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))