Punkt końcowy dataLayers zwraca dane zakodowane jako pliki GeoTIFF, których można użyć w dowolnym z użyciem systemów informatycznych (GIS) do projektowania systemów słonecznych.
Każdy ciąg w odpowiedzi obiektu dataLayer zawiera adres URL, którego służy do pobrania odpowiedniego pliku GeoTIFF. Adresy URL są ważne przez maksymalnie godzinę po generowane są na podstawie pierwotnego żądania warstwy danych. Pliki GeoTIFF mogą być przechowywane do 30 dni.
Z wyjątkiem warstwy RGB pliki GeoTIFF nie są wyświetlane poprawnie z przeglądarki obrazów, ponieważ są to dane zakodowane w formacie RGB, a nie obrazy w formacie RGB. GeoTIFF nie można też używać ich 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łębokość pikseli | Rozdzielczość | Opis |
|---|---|---|---|
| Digital Surface Model (DSM) | 32-bitowa liczba zmiennoprzecinkowa | 0,1 m/piksel | dane o wzniesieniu wysokości, które reprezentują topografię powierzchni Ziemi, w tym naturalne i zabudowane obiekty. Wartości są podane w metrach nad poziomem morza na poziomie 300%. 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
trzech pasm odpowiadających wartościom czerwonym, zielonym i niebieskim, aby utworzyć
24-bitowa wartość RGB dla każdego piksela. Domyślnie to 0,1 m/piksel. |
| Maska budynku | 1-bitowy | 0,1 m/piksel | 1 bit na piksel wskazujący, czy ten piksel jest uważany za jest częścią 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. Strumień jest obliczany dla każdej lokalizacji, a nie dla tylko przy budowaniu dachów. Nieprawidłowe lokalizacje lub obszary, w których przypadku nie udało się obliczanie strumienia, są przechowywane jako -9999. Lokalizacje poza naszą pokrycie są nieprawidłowe. Uwaga: to jest niemaskowany strumień. |
| Strumień miesięczny | 32-bitowa liczba zmiennoprzecinkowa | 0,5 m/piksel | Miesięczną mapę strumieni (słońce słoneczne na dachach, z podziałem na miesiące) i regionie. Wartości to kWh/kW/rok. Plik zdjęć GeoTIFF zawiera 12 elementów pasma odpowiadające okresowi od stycznia do grudnia, po kolei. |
| 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,
zamówienie. Każdy plik GeoTIFF zawiera 24 pasma odpowiadające wartości Przez całą dobę. Każdy piksel to 32-bitowa liczba całkowita odpowiadająca (maksymalnie) przez 31 dni tego miesiąca. 1 bit oznacza, że odpowiedni parametr aby zobaczyć słońce w tym dniu, o tej godzinie, w danym miesiącu. Nieprawidłowe lokalizacje są przechowywane jako -9999 i mają ustawiony bit 31: odpowiadający 32 dniu miesiąca, dlatego jest nieprawidłowy. |
Dekoduj cogodzinne rastry cieniowania
Godzinowe dane dotyczące cieni są kodowane w wielopasmowych rastrach. Więcej informacji o rastrach podstawowe informacje zawiera artykuł Solar API Concepts.
Gdy poprosisz o godziny dotyczące cieni, możesz otrzymać maksymalnie 12 rastry, po jednym na każdy miesiąc roku kalendarzowego (od stycznia do grudnia). Każdy rastr składa się z 24 warstw, czyli pasm, które odpowiadają 24-godzinnym dzień.
Każde pasmo jest reprezentowane przez macierz komórek lub pikseli. Każdy piksel ma głębokość 32 bitów, co odpowiada (maksymalnie) 31 dniom miesiąca. Zrozumienie danych dotyczących dnia, godziny i miesiąca zacienienia wymaga więc rozpoznać bit, pas i rastrowanie, które analizujesz.
Aby na przykład sprawdzić, czy dana lokalizacja we współrzędnych (x, y) zobaczyła 22 czerwca o 16:00, wykonaj te czynności:
- Wygeneruj żądanie warstw danych dotyczące wszystkich warstw związanych z lokalizacją (x, y).
- Ponieważ czerwiec to szósty miesiąc w roku, pobierz szósty miesiąc
Adres URL na liście
hourlyShadeUrls. - Pasma godzinowe są podawane w formacie 24-godzinnym. Aby pobrać dane dotyczące godziny 16:00 (16:00): aby znaleźć 17. kanał.
- Indeks bitów (dni) od 0. Aby uzyskać dane z 22 dnia czerwca, przeczytaj część 21.
- Bity dostarczają dane binarne wskazujące, czy w danej lokalizacji słońce pojawiło się danej daty i godziny. Jeśli bit to 1, lokalizacja widziała słońce. Jeśli bit to 0, miejsce w cieniu.
Ten kod podsumowuje powyższe kroki:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))