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 dataLayers contém um URL que pode ser usado para buscar o GeoTIFF correspondente. Os URLs são válidos por até uma hora após serem gerados na solicitação de camadas de dados original. 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 é codificado em dados, e não em 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.
| Camada | Profundidade de pixels | Resolução | Descrição |
|---|---|---|---|
| Modelo de superfície digital (DSM, na sigla em inglês) | Ponto flutuante de 32 bits | 0,1 m/pixel | Dados de elevação que representam a topografia da superfície da Terra, incluindo recursos naturais e construídos. Os valores estão em metros acima do nível do mar. Locais inválidos ou áreas em que não temos dados são armazenados como -9999. |
| RGB | 8 bits | 0,1 m/pixel 0,25 m/pixel |
Uma imagem aérea ou de satélite da região. O arquivo de imagens GeoTIFF contém
três bandas correspondentes aos valores vermelho, verde e azul para formar
um valor RGB de 24 bits para cada pixel. Por padrão, a resolução de pixels é de 0,1 m/pixel. |
| Máscara de construção | 1 bit | 0,1 m/pixel | Um bit por pixel indicando se esse pixel é considerado parte de um telhado. |
| Fluxo anual | Ponto flutuante de 32 bits | 0,1 m/pixel | O mapa de fluxo anual, ou luz solar anual em telhados, da região.
Os valores são kWh/kW/ano. O fluxo é calculado para todos os locais, não apenas para telhados de edifícios. 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:esse é um fluxo não mascarado. |
| Fluxo mensal | Ponto flutuante de 32 bits | 0,5 m/pixel | O mapa de fluxo mensal (luz solar em telhados, dividido por mês) da 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 | 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 bandas, correspondentes às 24 horas do dia. Cada pixel é um número inteiro de 32 bits, correspondente aos (até) 31 dias desse mês. Um bit significa que o local correspondente pode ver o sol naquele dia, naquela hora e naquele mês. Locais inválidos são armazenados como -9999 e têm o bit 31 definido, já que ele corresponde ao 32º dia do mês e, portanto, é inválido. |
Decodificar rasters de sombra por hora
Os dados de sombra por hora são codificados em rasters de várias bandas. Para saber mais sobre os conceitos básicos de raster, consulte Conceitos da API Solar.
Ao fazer uma solicitação de dados de sombra por hora, você pode receber até 12 rasters, um para cada mês do ano civil (de janeiro a dezembro). Cada raster é composto de 24 camadas ou bandas, que correspondem às 24 horas do dia.
Cada banda é representada por uma matriz de células ou pixels. Cada pixel tem uma profundidade de 32 bits, que correspondem aos (máximo) 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 do raster 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 todos os locais (x, y).
- Como junho é o sexto mês do ano, busque o sexto URL na lista
hourlyShadeUrls. - As bandas horárias são fornecidas no formato de 24 horas. Para receber dados das 16h (16h), procure o 17º canal.
- Os bits (dias) são indexados a partir de 0. Para receber dados do dia 22 de junho, leia o bit 21.
- Os bits fornecem dados binários indicando se o local viu o sol na data e hora especificadas. Se o bit for 1, o local viu o sol. Se o bit for 0, o local viu a sombra.
O código a seguir resume as etapas acima:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))