Punkt końcowy dataLayers zwraca dane zakodowane jako pliki GeoTIFF, które można wykorzystać w dowolnym systemie informacji geograficznej (GIS) do projektowania systemów słonecznych.
Każdy ciąg znaków w odpowiedzi dataLayers zawiera adres URL, którego możesz użyć do pobrania odpowiedniego pliku GeoTIFF. Adresy URL są ważne przez maksymalnie godzinę od momentu ich wygenerowania na podstawie żądania oryginalnych warstw danych. Pliki GeoTIFF mogą być przechowywane przez maksymalnie 30 dni.
Z wyjątkiem warstwy RGB pliki GeoTIFF nie wyświetlają się prawidłowo w przeglądarce obrazów, ponieważ ich zawartość to zakodowane dane, a nie obrazy RGB. Plików GeoTIFF nie można też używać bezpośrednio jako obrazu nakładki w interfejsie Maps JavaScript API.
W tabeli poniżej znajdziesz szczegółowy opis poszczególnych warstw.
| Warstwa | Głębia pikseli | Rozdzielczość | Opis |
|---|---|---|---|
| Cyfrowy model powierzchni (DSM) | liczba zmiennoprzecinkowa 32-bitowa, | 0,1 m/piksel | dane wysokościowe przedstawiające topografię powierzchni Ziemi, w tym elementy naturalne i sztuczne; Wartości są podawane w metrach nad poziomem morza. Nieprawidłowe lokalizacje lub obszary, w których nie mamy danych, są przechowywane jako -9999. |
| RGB | 8-bitowa | 0,1 m/piksel 0,25 m/piksel 0,5 m/piksel 1 m/piksel |
Zdjęcie lotnicze regionu. Plik obrazu GeoTIFF zawiera 3 pasma odpowiadające wartościom czerwonego, zielonego i niebieskiego, aby utworzyć 24-bitową wartość RGB dla każdego piksela. Domyślnie rozdzielczość piksela wynosi 0,1 m/piksel. |
| Tworzenie maski | 1-bitowy | 0,1 m/piksel | Jeden bit na piksel wskazujący, czy dany piksel jest uważany za część dachu. |
| Roczny strumień | liczba zmiennoprzecinkowa 32-bitowa, | 0,1 m/piksel | Roczna mapa natężenia promieniowania lub roczna mapa nasłonecznienia dachów w regionie.
Wartości są podawane w kWh/kW/rok. Przepływ jest obliczany dla każdej lokalizacji, a nie tylko dla dachów budynków. Nieprawidłowe lokalizacje lub obszary, w których nie udało się obliczyć wartości flux, są przechowywane jako -9999. Lokalizacje poza naszymobszarem są nieprawidłowe. Uwaga: jest to niespowodowany strumień. |
| Miesięczny strumień | liczba zmiennoprzecinkowa 32-bitowa, | 0,5 m/piksel | Miesięczna mapa natężenia (oświetlenia dachów przez słońce, z podziałem na miesiące) w danym regionie. Wartości są podawane w kWh/kW/rok. Plik z obrazami GeoTIFF zawiera 12 pasm odpowiadających kolejno styczniowi– grudniowi. |
| Cień godzinowy | Liczba całkowita 32-bitowa | 1 m/piksel | 12 adresów URL map cieniowania godzinowego odpowiadających styczniowi– grudniowi w kolejności. Każdy plik GeoTIFF zawiera 24 pasma odpowiadające 24 godzinom w ciągu dnia. Każdy piksel to 32-bitowa liczba całkowita odpowiadająca maksymalnie 31 dniom w danym miesiącu. Bit 1 oznacza, że w danym dniu i o danej godzinie w danym miesiącu w odpowiadającej lokalizacji jest widoczne słońce. Nieprawidłowe lokalizacje są przechowywane jako -9999 i mają ustawiony bit 31, ponieważ odpowiada to 32 dniowi miesiąca, a zatem jest nieprawidłowe. |
Dekodowanie rasterów cieniowania godzinowego
Dane o zacienienia na godzinę są kodowane w wielkopasmowych rastrowych plikach danych. Więcej informacji o podstawach rastrów znajdziesz w artykule Koncepcje dotyczące interfejsu Solar API.
Gdy prześlesz żądanie dotyczące danych o cieniowaniu godzinowym, możesz otrzymać maksymalnie 12 rasterów, po jednym dla każdego miesiąca roku kalendarzowego (od stycznia do grudnia). Każdy rastrowy obraz składa się z 24 warstw, czyli pasm, które odpowiadają 24 godzinom dnia.
Każdy pas jest reprezentowany przez macierz komórek, czyli piksele. Każdy piksel ma głębię 32-bitową, co odpowiada (maksymalnie) 31 dniom w miesiącu. Dekodowanie danych o cieni na podstawie dnia, godziny i miesiąca wymaga zrozumienia bitów, pasma i rastera, które analizujesz.
Aby na przykład sprawdzić, czy dana lokalizacja o współrzędnych (x, y) widziała słońce 22 czerwca o godzinie 16:00, wykonaj te czynności:
- Prześlij żądanie warstw danych dla wszystkich warstw w przypadku lokalizacji (x, y).
- Czerwiec to szósty miesiąc w roku, więc pobierz 6 adres URL z listy
hourlyShadeUrls. - Pasma godzinowe są podawane w systemie 24-godzinnym. Aby uzyskać dane z godziny 16:00, odszukaj 17 kanał.
- Indeks bitów (dni) od 0. Aby uzyskać dane z 22 czerwca, odczytaj bit 21.
- Bity zawierają dane binarne wskazujące, czy w danej lokalizacji w określonym dniu i o określonej porze było słońce. Jeśli bit ma wartość 1, lokalizacja zarejestrowała słońce. Jeśli bit ma wartość 0, oznacza to, że w danej lokalizacji było zacienienie.
Powyższe czynności można wykonać za pomocą tego kodu:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))