Punkt końcowy dataLayers zwraca dane zakodowane w plikach GeoTIFF, których można użyć w dowolnej aplikacji systemu informacji geograficznych (GIS) do projektowania systemów słonecznych.
Każdy ciąg w odpowiedzi obiektu dataLayer zawiera adres URL, którego można użyć do pobrania odpowiedniego pliku GeoTIFF. Adresy URL są ważne przez maksymalnie godzinę po wygenerowaniu pierwotnego żądania warstwy danych. Pliki GeoTIFF można przechowywać maksymalnie przez 30 dni.
Z wyjątkiem warstwy RGB pliki GeoTIFF nie wyświetlają się poprawnie w przeglądarce obrazów, ponieważ zawartość jest zakodowana, a nie RGB. Plików GeoTIFF nie można też używać bezpośrednio jako obrazów nakładek przy użyciu interfejsu Maps JavaScript API.
Tabela poniżej zawiera szczegółowe informacje na temat każdej warstwy.
| Warstwa | Głębokość pikseli | Rozdzielczość | Opis |
|---|---|---|---|
| Digital Surface Model (DSM) | 32-bitowa liczba zmiennoprzecinkowa | 0,1 m/piksel | Dane o wzniesieniu, które reprezentują topografię powierzchni Ziemi, w tym obiekty naturalne i zabudowane. 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 regionu z lotu ptaka. Plik zdjęć GeoTIFF zawiera 3 pasma odpowiadające wartościom czerwonym, zielonym i niebieskim, tworząc 24-bitową wartość RGB dla każdego piksela. Domyślnie rozdzielczość w pikselach wynosi 0,1 m/piksel. |
| Maska budynku | 1-bitowy | 0,1 m/piksel | Jeden bit na piksel, który wskazuje, czy ten piksel jest uważany za część dachu. |
| Strumień roczny | 32-bitowa liczba zmiennoprzecinkowa | 0,1 m/piksel | Mapa fluktuacji fluktuacyjnej, czyli doroczne światło słoneczne na dachach regionu.
Wartości to kWh/kW/rok. Technologia Flux jest obliczana 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ć strumienia, są przechowywane jako -9999. Lokalizacje poza naszym obszarem zasięgu są nieprawidłowe. Uwaga: to jest niemaskowany strumień. |
| Strumień miesięczny | 32-bitowa liczba zmiennoprzecinkowa | 0,5 m/piksel | Miesięczna mapa strumieni (słońce słoneczne na dachach, z podziałem na miesiące) w regionie. Wartości to kWh/kW/rok. Plik zdjęciowy GeoTIFF zawiera po kolei 12 pasm odpowiadających okresowi od stycznia do grudnia. |
| Cień na godzinę | 32-bitowa liczba całkowita | 1 m/piksel | 12 adresów URL do godzinowych map odcieni odpowiadających okresowi od stycznia do grudnia. Każdy plik GeoTIFF zawiera 24 pasma odpowiadające 24 godzinom dnia. Każdy piksel to 32-bitowa liczba całkowita, która odpowiada (maksymalnie) 31 dniom danego miesiąca. 1 bit oznacza, że dana lokalizacja widzi słońce w danym dniu, o tej godzinie, w danym miesiącu. Nieprawidłowe lokalizacje są przechowywane jako -9999 i mają ustawiony bit 31, ponieważ odpowiada 32 dniu miesiąca i dlatego jest nieprawidłowy. |
Dekoduj cogodzinne rastry cieniowania
Godzinowe dane dotyczące cieni są kodowane w wielopasmowych rastrach. Więcej informacji o podstawach rastrów znajdziesz w Solar API Concepts.
Po wysłaniu prośby o godzinowe dane dotyczące cieni możesz otrzymać maksymalnie 12 rastry, po 1 na każdy miesiąc w roku kalendarzowym (od stycznia do grudnia). Każdy raster składa się z 24 warstw, czyli pasm odpowiadających 24 godzinom dnia.
Każde pasmo jest reprezentowane przez macierz komórek lub pikseli. Każdy piksel ma 32 bity, co odpowiada (maksymalnie) 31 dniom miesiąca. Dekodowanie dnia, godziny i miesiąca danych dotyczących cieniowania wymaga więc zrozumienia danych dotyczących fragmentu, pasma i rastru, które są analizowane.
Aby na przykład sprawdzić, czy dana lokalizacja we współrzędnych (x, y) zobaczyła Słońce 22 czerwca o godzinie 16:00, wykonaj te czynności:
- Wygeneruj żądanie warstw danych dotyczące wszystkich warstw związanych z lokalizacją (x, y).
- Czerwiec to szósty miesiąc w roku, więc pobierz szósty adres URL na liście
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 uzyskać dane z 22 dnia czerwca, przeczytaj część 21.
- Bity udostępniają dane binarne, które wskazują, czy w danej lokalizacji w danej lokalizacji wykryto słońce. Jeśli bit ma wartość 1, lokalizacja widziała słońce. Jeśli bit ma wartość 0, lokalizacja ma cień.
Ten kod podsumowuje powyższe kroki:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))