dataLayers-Endpunkt gibt Daten zurück, die als GeoTIFF-Dateien codiert sind. Diese können in beliebigen geografischen GIS-Anwendung zur Entwicklung von Solarsystemen.
Jeder String in der „dataLayers“-Antwort enthält eine URL, die Sie verwenden, um das entsprechende GeoTIFF abzurufen. URLs sind bis zu einer Stunde nach dem werden sie aus der ursprünglichen Datenschichtanfrage generiert. GeoTIFF-Dateien können bis zu 30 Tage lang gespeichert.
Mit Ausnahme der RGB-Ebene werden GeoTIFF-Dateien mit in einem Bildanzeigeprogramm, da es sich beim 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 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 gebauter Funktionen. Die Werte werden in Metern über dem Meeresspiegel angegeben. Ungültige Standorte oder Gebiete, für die uns keine Daten vorliegen, werden -9999. |
| 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 entsprechen, die den Werten Rot, Grün und Blau entsprechen,
24-Bit-RGB-Wert für jedes Pixel. Standardmäßig ist die Pixelauflösung 0,1 m/Pixel. |
| Gebäudemaske | 1 Bit | 0,1 m/Pixel | Ein Bit pro Pixel, das angibt, ob dieses Pixel Teil eines Dachs. |
| Jährlicher Fluss | 32-Bit-Gleitkommazahl | 0,1 m/Pixel | Die Karte mit dem jährlichen Fluss oder der jährlichen Sonneneinstrahlung auf Dächern der Region.
Die Werte sind kWh/kW/Jahr. Der Fluss wird für jeden Standort berechnet, nicht nur Dächer gebaut werden. Ungültige Standorte bzw. Regionen, in denen dies nicht möglich war den Fluss berechnet, als -9999 gespeichert. Standorte außerhalb unserer Abdeckung sind ungültig. Hinweis: Dies ist der ungemaskierte 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 12 Bänder für Januar bis Dezember. |
| Stündlicher Farbton | 32-Bit-Ganzzahl | 1 m/Pixel | 12 URLs für stündliche Schattierungskarten für Januar bis Dezember in
Reihenfolge. Jede GeoTIFF-Datei enthält 24 Bänder, die dem rund um die Uhr. Jedes Pixel ist eine 32-Bit-Ganzzahl, die dem (bis zu) 31 Tage des Monats. Ein 1-Bit bedeutet, dass das 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, der 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 Rastern Informationen zu den Grundlagen finden Sie unter Solar API-Konzepte.
Wenn Sie stündliche Schattierungsdaten anfordern, können Sie bis zu 12 Raster, eine für jeden Monat des Kalenderjahres (Januar bis Dezember). Jedes Raster aus 24 Schichten oder Bändern besteht, die den 24 Stunden des Tag.
Jeder Bereich wird durch eine Matrix von Zellen oder Pixeln dargestellt. Jedes Pixel hat eine Tiefe von 32 Bit, was den (maximal) 31 Tagen im Monat entspricht. Die Decodierung von Tag, Uhrzeit und Monat der Shading-Daten erfordert daher das Bit, den Bereich und das Raster zu verstehen, die Sie analysieren.
Um beispielsweise zu ermitteln, ob ein bestimmter Standort an den Koordinaten (x, y) das Ereignis So am 22. Juni um 16:00 Uhr:
- 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 den sechsten Monat ab
URL in der
hourlyShadeUrls-Liste. - Stündliche Bänder werden im 24-Stunden-Format angegeben. Wenn Sie Daten für 16:00 Uhr benötigen, sehen Sie im 17. Kanal nach.
- 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 die Sonne am Datum und Uhrzeit angegeben. Wenn der Bit-Wert 1 ist, wurde am Standort die Sonne erkannt. Wenn das Bit 0 ist, sah der Ort im Schatten.
Der folgende Code fasst die obigen Schritte zusammen:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))