Der Endpunkt dataLayers gibt als GeoTIFF-Dateien codierte Daten zurück, die in jeder Anwendung für geografische Informationssysteme (GIS) zum Entwurf 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 Datenschichtanfrage generiert wurden. GeoTIFF-Dateien können bis zu 30 Tage gespeichert werden.
Mit Ausnahme der RGB-Ebene werden GeoTIFF-Dateien in einem Bildanzeigenprogramm nicht korrekt angezeigt, da es sich bei dem Inhalt um codierte Daten und nicht um RGB-Bilder handelt. GeoTIFF-Dateien können mit der Maps JavaScript API auch nicht direkt als Overlay-Bild verwendet werden.
In der folgenden Tabelle werden die einzelnen Ebenen im Detail beschrieben.
| Layer | Pixeltiefe | Auflösung | Beschreibung |
|---|---|---|---|
| Digital Surface Model (DSM) | 32-Bit-Gleitkommazahl | 0,1 m/Pixel | Höhendaten für die Topografie der Erdoberfläche, einschließlich natürlicher und bebauter Elemente. Die Werte werden in Metern über dem Meeresspiegel angegeben. Ungültige Standorte oder Gebiete, 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 |
Eine Luftaufnahme der Region Die GeoTIFF-Bilddatei enthält drei Bereiche, 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 gibt an, ob dieses Pixel als Teil einer Dächer angesehen wird. |
| Jährlicher Fluss | 32-Bit-Gleitkommazahl | 0,1 m/Pixel | Die jährliche Flusskarte oder die jährliche Sonneneinstrahlung auf Dächern der Region.
Die Werte sind kWh/kW/Jahr. Der Fluss wird für jeden Standort berechnet, nicht nur für Gebäude Dächer. Ungültige Standorte oder Gebiete, für die der Fluss nicht berechnet werden konnte, werden als -9999 gespeichert. Standorte außerhalb unseres Abdeckungsbereichs sind ungültig. Hinweis:Dies ist ein nicht maskierter Fluss. |
| Monatlicher Fluss | 32-Bit-Gleitkommazahl | 0,5 m/Pixel | Die monatliche Flusskarte der Region (Sonnenlicht auf Dächern, aufgeschlüsselt nach Monat). Die Werte sind kWh/kW/Jahr. Die GeoTIFF-Bilddatei enthält zwölf Farbbereiche, die der Reihenfolge Januar bis Dezember entsprechen. |
| Farbton pro Stunde | 32-Bit-Ganzzahl | 1 m/Pixel | 12 URLs für stündliche Farbtonkarten, entsprechend der Reihenfolge Januar bis Dezember. Jede GeoTIFF-Datei enthält 24 Bänder, entsprechend den 24 Stunden eines Tages. Jedes Pixel ist eine 32-Bit-Ganzzahl, die den (bis zu) 31 Tagen des Monats entspricht. Ein 1 Bit bedeutet, dass der entsprechende Ort die Sonne an diesem Tag, zu dieser Stunde und in diesem Monat, sehen kann. Ungültige Standorte werden als -9999 gespeichert und Bit 31 ist festgelegt, da dies dem 32. Tag des Monats entspricht und daher ungültig ist. |
Stündliche Farbraster-Raster decodieren
Stündliche Farbtöne werden in Multiband-Rastern codiert. Weitere Informationen zu den Grundlagen von Rastern finden Sie unter Konzepte der Solar API.
Wenn Sie stündliche Farbtondaten anfordern, können Sie bis zu zwölf Raster erhalten, eines für jeden Monat des Kalenderjahres (Januar bis Dezember). Jedes Raster besteht aus 24 Ebenen oder Bändern, die den 24 Stunden eines 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. Daher müssen Sie das Bit, Band und Raster verstehen, das Sie analysieren.
So können Sie beispielsweise ermitteln, ob für einen bestimmten Ort an den Koordinaten (x, y) am 22. Juni um 16:00 Uhr die Sonne erkannt wurde:
- Fragen Sie alle Ebenen für den Standort (x, y) an.
- Da der Monat Juni der sechste Monat des Jahres ist, rufen Sie die sechste URL in der
hourlyShadeUrls-Liste ab. - Stündliche Frequenzbänder werden im 24-Stunden-Format angegeben. Wenn Sie Daten für 16:00 Uhr (16:00 Uhr) abrufen möchten, suchen Sie den 17. Kanal.
- Bit-Index (Tage) von 0. Lesen Sie Bit 21, um die Daten für den 22. Juni abzurufen.
- Bits liefern Binärdaten, die angeben, ob an diesem Ort zum gegebenen Datum und zur entsprechenden Uhrzeit die Sonne gesehen wurde. Wenn das Bit 1 ist, hat der Ort die Sonne gesehen. Ist das Bit 0, wurde die Schattierung für den Standort angezeigt.
Im folgenden Code werden die oben genannten Schritte zusammengefasst:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))