O endpoint dataLayers retorna dados codificados como arquivos GeoTIFF, que podem ser usados em qualquer aplicativo de sistema de informações geográficas (SIG) para projetar sistemas solares.
Cada string na resposta de dataLayers contém um URL, que pode ser usado para buscar o GeoTIFF correspondente. Os URLs são válidos por até uma hora depois de serem gerados a partir da 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, porque o conteúdo são dados codificados em vez de imagens RGB. Os arquivos GeoTIFF 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.
| incorporada | 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 elementos naturais e construídos. Os valores estão em metros acima do nível do mar. Locais inválidos ou áreas onde não temos dados são armazenados como -9999. |
| 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 vermelho, verde e azul para formar um valor RGB de 24 bits para cada pixel. Por padrão, a resolução do pixel é 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 todos os locais, não apenas para telhados. Locais inválidos ou áreas em que não foi possível calcular o fluxo são armazenados 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) da região. Os valores são kWh/kW/ano. O arquivo de imagens GeoTIFF contém 12 faixas correspondentes ao período de janeiro a dezembro, nessa ordem. |
| Sombra por hora | Número inteiro de 32 bits | 1 m/pixel | 12 URLs para mapas de sombra por hora correspondentes ao período de janeiro a dezembro, em
ordem. Cada arquivo GeoTIFF contém 24 faixas que correspondem às 24 horas do dia. Cada pixel é um número inteiro de 32 bits que corresponde aos (até) 31 dias desse mês. O valor "1 bit" significa que o local correspondente pode ver o sol naquele dia, na hora certa do mês. Locais inválidos são armazenados como -9999 e têm o bit 31 definido, que corresponde ao 32o dia do mês e, portanto, são inválidos. |
Decodificar varreduras de tonalidade por hora
Os dados de sombra por hora são codificados em rasterizações multibanda. Para saber mais sobre os fundamentos de varredura, consulte Conceitos da API Solar.
Ao solicitar dados de sombra por hora, você pode receber até 12 varreduras, uma para cada mês do ano (janeiro a dezembro). Cada varredura é composta 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 uma profundidade de 32 bits, que corresponde ao (máximo) de 31 dias do mês. Portanto, a decodificação do dia, da hora e do mês dos dados de sombra exige a compreensão do bit, da banda e da varredura que você está analisando.
Por exemplo, para identificar se um determinado local nas coordenadas (x, y) viu o sol à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
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.
- Os bits fornecem dados binários que indicam se o local teve sol na data e hora determinadas. Se a broca for 1, significa que o local teve sol. Se o bit for 0, significa que a localização teve sombra.
O código a seguir resume as etapas acima:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))