Punkt końcowy dataLayers zwraca dane zakodowane jako pliki GeoTIFF, które mogą zostać użyte w dowolnej aplikacji systemu informacji geograficznej (GIS) do projektowania układów słonecznych.
Każdy ciąg w odpowiedzi obiektu dataLayer zawiera adres URL, którego możesz użyć do pobrania odpowiednich danych GeoTIFF. Adresy URL są ważne przez godzinę od utworzenia na podstawie pierwotnego żądania warstw danych. Pliki GeoTIFF mogą być przechowywane przez maksymalnie 30 dni.
Z wyjątkiem warstwy RGB pliki GeoTIFF są wyświetlane nieprawidłowo w przeglądarce obrazów, ponieważ treść to kodowane dane, a nie obrazy RGB. Plików GeoTIFF nie można też używać bezpośrednio jako obrazów nad powierzchnią w interfejsie Maps JavaScript API.
Tabela poniżej zawiera szczegółowe informacje na temat każdej warstwy.
| Warstwa | Głębia pikseli | Rozdzielczość | Opis |
|---|---|---|---|
| Cyfrowy model powierzchni (DSM) | 32-bitowa liczba zmiennoprzecinkowa | 0,1 m/piksel | Dane o wysokości reprezentujące topografia powierzchni Ziemi, w tym obiekty naturalne i zabudowane. Wartości są podawane w metrach nad poziomem morza. Nieprawidłowe lokalizacje, czyli 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 regionu. Plik zdjęciowy GeoTIFF zawiera 3 pasma odpowiadające wartościom czerwonego, zielonego i niebieskiego, aby utworzyć 24-bitową wartość RGB dla każdego piksela. Domyślna rozdzielczość piksela to 0,1 m/piksel. |
| Maska budynku | 1-bitowa | 0,1 m/piksel | Po jednym bitu na piksel, który wskazuje, czy piksel jest uważany za część dachu. |
| Strumień roczny | 32-bitowa liczba zmiennoprzecinkowa | 0,1 m/piksel | Roczna mapa natężenia strumienia wody, czyli roczne światło słoneczne na dachach regionu.
Wartości to kWh/kW/rok. Strumień danych jest obliczany dla każdej lokalizacji, a nie tylko dla budynków. Nieprawidłowe lokalizacje, czyli obszary, w których nie udało się obliczyć strumienia, są zapisywane jako -9999. Lokalizacje spoza obszaru zasięgu są nieprawidłowe. Uwaga: to jest strumień niezamaskowane. |
| Strumień miesięczny | 32-bitowa liczba zmiennoprzecinkowa | 0,5 m/piksel | Miesięczna mapa natężenia światła w regionie (słońce na dachach, z podziałem na miesiące). Wartości to kWh/kW/rok. Plik zdjęciowy GeoTIFF zawiera 12 pasm odpowiadających okresom od stycznia do grudnia. |
| Cień godzinowy | 32-bitowa liczba całkowita | 1 m/piksel | 12 adresów URL dla godzinowych map cieni dla okresu od stycznia do grudnia. Każdy plik GeoTIFF zawiera 24 pasma, które odpowiadają 24 godzinom dnia. Każdy piksel to 32-bitowa liczba całkowita odpowiadająca (maksymalnie) 31 dniom tego miesiąca. Wartość 1 bitu oznacza, że dana lokalizacja jest w stanie zobaczyć słońce w danym dniu, o tej godzinie i w danym miesiącu. Nieprawidłowe lokalizacje są przechowywane jako -9999 i mają ustawiony bit 31, ponieważ odpowiada on 32 dniu miesiąca, więc jest nieprawidłowy. |
Dekoduj co godzinę rastery
Godzinowe dane o cieniu są kodowane w rasterach wielopasmowych. Więcej informacji o podstawach systemu rastrowego znajdziesz w artykule Pojęcia związane z interfejsem Solar API.
Gdy przesyłasz prośbę o godzinowe dane o cieniu, możesz otrzymać maksymalnie 12 rabatów na każdy miesiąc w roku kalendarzowym (od stycznia do grudnia). Każdy raster składa się z 24 warstw, czyli pasm, które odpowiadają 24 godzinom dnia.
Każdy pasek jest reprezentowany przez macierz komórek, czyli piksele. Głębokość każdego piksela wynosi 32 bity, co odpowiada (maksymalnej) liczbie 31 dni miesiąca. Dlatego dekodowanie danych z dnia, godziny i miesiąca wymaga zrozumienia analizowanego fragmentu, pasma i rastru.
Aby np. ustalić, czy w danej lokalizacji we współrzędnych (x, y) słońce było widoczne 22 czerwca o 16:00, wykonaj te czynności:
- Wyślij żądanie warstw danych do wszystkich warstw dotyczących lokalizacji (x, y).
- Czerwiec jest szóstym miesiącem roku, więc pobierz szósty adres URL z listy
hourlyShadeUrls. - Pasma godzinowe są podawane w formacie 24-godzinnym. Aby uzyskać dane z godziny 16:00 (16:00), wyszukaj 17 kanał.
- Indeks bitów (dni) od 0. Aby poznać dane z 22 dnia czerwca, przeczytaj bit 21.
- Bity dostarczają danych binarnych wskazujących, czy dana lokalizacja miała ustawioną datę i godzinę „słońce”. Jeśli bit ma wartość 1, lokalizacja wskazuje słońce. Jeśli bit ma wartość 0, lokalizacja cienia.
Ten kod podsumowuje powyższe kroki:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))