O endpoint dataLayers retorna dados codificados como arquivos GeoTIFF, que podem ser usados em qualquer aplicativo de sistema de informações (SIG) para projetar sistemas solares.
Cada string na resposta de dataLayers contém um URL, que pode ser usar para buscar o GeoTIFF correspondente. Os URLs são válidos por até uma hora após elas são geradas com base na solicitação original das camadas de dados. Os arquivos GeoTIFF podem ser armazenados por até 30 dias.
Com exceção da camada RGB, os arquivos GeoTIFF não são exibidos corretamente com um visualizador de imagens, pois o conteúdo são dados codificados em vez de imagens RGB. GeoTIFF Os arquivos também não podem ser usados diretamente como uma imagem de sobreposição com a API Maps JavaScript.
A tabela a seguir descreve cada camada em detalhes.
| Camada | Profundidade de pixels | Resolução | Descrição |
|---|---|---|---|
| Modelo de superfície digital (DSM) | Flutuante de 32 bits | 0,1 m/pixel | Dados de elevação que representam a topografia da superfície da Terra. incluindo atributos naturais e construídos. Os valores estão em metros acima do mar nível Locais inválidos ou áreas onde não temos dados são armazenados como -9.999, |
| RGB | 8 bits | 0,1 m/pixel 0,25 m/pixel 0,5 m/pixel 1 m/pixel |
Uma imagem aérea da região. O arquivo de imagens GeoTIFF contém
três faixas correspondentes aos valores de vermelho, verde e azul, para formar
Valor RGB de 24 bits para cada pixel. Por padrão, a resolução de pixel é de 0,1 m/pixel. |
| Máscara de construção | 1 bit | 0,1 m/pixel | Um bit por pixel que indica se esse pixel é considerado parte de um telhado. |
| Fluxo anual | Flutuante de 32 bits | 0,1 m/pixel | O mapa de fluxo anual, ou luz solar anual nos telhados, da região.
Os valores são kWh/kW/ano. O fluxo é calculado para cada local, não para apenas construir telhados. Locais inválidos ou áreas em que não foi possível calculam o fluxo, são armazenadas como -9999. Locais fora da nossa área de cobertura são inválidos. Observação:este é um fluxo não mascarado. |
| Fluxo mensal | Flutuante de 32 bits | 0,5 m/pixel | O mapa de fluxo mensal (luz solar nos telhados, dividida por mês) do na mesma região. Os valores são kWh/kW/ano. O arquivo de imagens GeoTIFF contém 12 bandas correspondentes a janeiro a dezembro, em ordem. |
| Sombra por hora | Número inteiro de 32 bits | 1 m/pixel | 12 URLs para mapas de sombra por hora correspondentes a janeiro a dezembro, em
ordem. Cada arquivo GeoTIFF contém 24 faixas, correspondentes ao 24 horas por dia. Cada pixel é um número inteiro de 32 bits, correspondente ao (até) 31 dias desse mês. Um bit significa que o valor seja capaz de ver o sol naquele dia, naquela hora, naquele mês. Locais inválidos são armazenados como -9999 e têm o bit 31 definido, conforme que corresponde ao 32o dia do mês e, portanto, é inválido. |
Decodificar varreduras de tonalidade por hora
Os dados de sombra por hora são codificados em rasterizações multibanda. Para saber mais sobre varredura noções básicas, consulte Conceitos da API Solar.
Ao solicitar dados de tonalidade por hora, você pode receber até 12 varreduras, uma para cada mês do ano (janeiro a dezembro). Cada varredura é composto por 24 camadas, ou bandas, que correspondem às 24 horas do dia.
Cada faixa é representada por uma matriz de células ou pixels. Cada pixel tem um profundidade de 32 bits, que corresponde aos 31 dias (máximo) do mês. Decodificar o dia, a hora e o mês dos dados de sombra requer entender o bit, a banda e a varredura que você está analisando.
Por exemplo, para identificar se um determinado local nas coordenadas (x, y) viu o domingo às 16h do dia 22 de junho, faça o seguinte:
- Faça uma solicitação de camadas de dados para todas as camadas referentes à localização (x, y).
- Como junho é o sexto mês do ano, busque o sexto mês
URL na lista de
hourlyShadeUrls. - As faixas por hora são fornecidas no formato 24 horas. Para obter dados para as 16h (16h), procure o 17o canal.
- Índice de bits (dias) a partir de 0. Para obter dados para o dia 22 de junho, leia o bit 21.
- Bits fornecem dados binários indicando se aquele local teve sol no determinada data e hora. Se a broca for 1, significa que o local teve sol. Se o bit for 0, o local teve sombra.
O código a seguir resume as etapas acima:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))