REST Resource: dataLayers

Zasób: DataLayers

Informacje o potencjale energii słonecznej w danym regionie. Rzeczywiste dane znajdują się w kilku plikach GeoTIFF obejmujących żądany region, do których adresy URL zawiera ten komunikat: każdy ciąg znaków w komunikacie DataLayers zawiera adres URL, z którego można pobrać odpowiedni plik GeoTIFF. Te adresy URL są ważne przez kilka godzin po wygenerowaniu. Większość plików GeoTIFF ma rozdzielczość 0,1 m/piksel, ale plik z miesięcznym strumieniem ma rozdzielczość 0,5 m/piksel, a pliki z godzinowymi cieniami mają rozdzielczość 1 m/piksel. Jeśli w parametrze GetDataLayersRequest określono wartość pixelSizeMeters, minimalna rozdzielczość w plikach GeoTIFF będzie równa tej wartości.

Zapis JSON 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
Pola
imageryDate

object (Date)

Kiedy w tym regionie zostały wykonane zdjęcia źródłowe (z których pochodzą wszystkie inne dane). Jest to wartość przybliżona, ponieważ zdjęcia mogły zostać zrobione w różnych dniach.
imageryProcessedDate

object (Date)

Kiedy zakończono przetwarzanie tych zdjęć.
dsmUrl

string

Adres URL obrazu DSM (cyfrowego modelu powierzchni) regionu. Wartości są podawane w metrach nad geoidą EGM96 (czyli nad poziomem morza). Nieprawidłowe lokalizacje (w przypadku których nie mamy danych) są przechowywane jako -9999.
rgbUrl

string

Adres URL obrazu danych RGB (zdjęcia lotniczego) regionu.
maskUrl

string

Adres URL obrazu maski budynku: 1 bit na piksel określający, czy piksel jest uznawany za część dachu.
annualFluxUrl

string

Adres URL rocznej mapy strumienia (roczne nasłonecznienie dachów) w regionie. Wartości są podawane w kWh/kW/rok. Jest to niezamaskowany strumień: strumień jest obliczany dla każdej lokalizacji, a nie tylko dla dachów budynków. Nieprawidłowe lokalizacje są przechowywane jako -9999: nieprawidłowe będą lokalizacje poza obszarem, który obsługujemy, a także niektóre lokalizacje w tym obszarze, w których nie udało nam się obliczyć strumienia.
monthlyFluxUrl

string

Adres URL miesięcznej mapy strumienia (światło słoneczne padające na dachy z podziałem na miesiące) w danym regionie. Wartości są podawane w kWh/kW/rok. Plik GeoTIFF, na który wskazuje ten adres URL, będzie zawierać 12 pasm odpowiadających kolejno miesiącom od stycznia do grudnia.
hourlyShadeUrls[]

string

12 adresów URL dla cienia w poszczególnych godzinach, odpowiadających kolejno miesiącom od stycznia do grudnia. Każdy plik GeoTIFF będzie zawierać 24 pasma odpowiadające 24 godzinom doby. Każdy piksel to 32-bitowa liczba całkowita odpowiadająca (maksymalnie) 31 dniom danego miesiąca. Bit o wartości 1 oznacza, że w danym dniu, o danej godzinie i w danym miesiącu w odpowiednim miejscu widać słońce. Nieprawidłowe lokalizacje są przechowywane jako -9999 (ponieważ jest to liczba ujemna, ma ustawiony bit 31, a żadna prawidłowa wartość nie może mieć ustawionego bitu 31, ponieważ odpowiadałoby to 32 dniowi miesiąca).

Przykład może być przydatny. Jeśli chcesz sprawdzić, czy punkt (w lokalizacji piksela (x, y)) był oświetlony przez słońce o godzinie 16:00 22 czerwca, wykonaj te czynności:

  1. pobrać szósty adres URL na tej liście (odpowiadający czerwcowi).
  2. wyszukać 17 kanał (odpowiadający godzinie 16:00).
  3. odczytać 32-bitową wartość w punkcie (x, y).
  4. odczytać bit 21 wartości (odpowiadający 22 dniu miesiąca).
  5. Jeśli ten bit ma wartość 1, oznacza to, że w tym miejscu 22 czerwca o godzinie 16:00 było słońce.

Bardziej formalnie: dla month (1–12), day (1...maksymalna liczba dni w miesiącu; luty ma 28 dni) i hour (0–23) cień/słońce w danym miesiącu/dniu/godzinie w pozycji (x, y) to bit

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

gdzie (x, y) to indeksowanie przestrzenne, [month - 1] odnosi się do pobierania month - 1-tego adresu URL (indeksowanie od zera), [hour] to indeksowanie kanałów, a końcowy wynik różny od zera oznacza „słonecznie”. Nie ma dni przestępnych ani czasu letniego (wszystkie dni trwają 24 godziny, a godzina 12:00 to zawsze południe czasu standardowego).
imageryQuality

enum (ImageryQuality)

Jakość obrazów w wyniku.

Data

Reprezentuje całą lub częściową datę kalendarzową, np. datę urodzin. Pora dnia i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podana w kalendarzu gregoriańskim. Może to być jedna z tych wartości:

  • Pełna data z wartościami roku, miesiąca i dnia różnymi od zera.
  • Miesiąc i dzień z rokiem zerowym (np. rocznica).
  • Sam rok, z miesiącem i dniem o wartości zero.
  • Rok i miesiąc z zerowym dniem (np. data ważności karty kredytowej).

Powiązane typy:

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, aby określić datę bez roku.
month

integer

Miesiąc roku. Wartość musi mieścić się w przedziale od 1 do 12 lub wynosić 0, jeśli chcesz określić rok bez miesiąca i dnia.
day

integer

Dzień miesiąca. Musi być liczbą od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub liczbą od 0 do 31, jeśli chcesz podać sam rok albo rok i miesiąc, w których dzień nie ma znaczenia.

ImageryQuality

Jakość zdjęć użytych do obliczenia niektórych wyników interfejsu API.

Uwaga: niezależnie od poziomu jakości zdjęć dane wyjściowe DSM mają zawsze rozdzielczość 0,1 m/piksel, miesięczne dane wyjściowe dotyczące strumienia mają zawsze rozdzielczość 0,5 m/piksel, a godzinowe dane wyjściowe dotyczące cienia mają zawsze rozdzielczość 1 m/piksel.

Wartości w polu enum
IMAGERY_QUALITY_UNSPECIFIED Nieznana jakość.
HIGH Dane dotyczące energii słonecznej pochodzą ze zdjęć lotniczych wykonanych na małej wysokości i przetworzonych w rozdzielczości 0,1 m/piksel.
MEDIUM Dane dotyczące energii słonecznej pochodzą z ulepszonych zdjęć lotniczych wykonanych na dużej wysokości i przetworzonych w rozdzielczości 0,25 m na piksel.
BASE Dane dotyczące energii słonecznej pochodzą z ulepszonych zdjęć satelitarnych przetwarzanych w rozdzielczości 0,25 m/piksel.

Metody

get

 Pobieranie informacji o energii słonecznej w regionie otaczającym lokalizację.