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 das camadas de dados 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 a geração a partir da solicitação das camadas de dados originais. 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 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.
| Camada | Profundidade de pixels | Resolução | Descrição |
|---|---|---|---|
| Modelo de superfície digital (DSM) | Número de ponto 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 sem 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 imagem GeoTIFF contém três bandas correspondentes aos valores vermelho, verde e azul para formar o valor RGB de 24 bits para cada pixel. Por padrão, a resolução do pixel é 0,1 m/pixel. |
| Criar máscara | 1 bit | 0,1 m/pixel | Um bit por pixel indicando se esse pixel é considerado parte de um telhado. |
| Fluxo anual | Número de ponto flutuante de 32 bits | 0,1 m/pixel | O mapa de fluxo anual, ou a 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 os telhados dos 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:este é um fluxo sem máscara. |
| Fluxo mensal | Número de ponto flutuante de 32 bits | 0,5 m/pixel | O mapa de fluxo mensal (luz solar nos telhados, dividido por mês) da região. Os valores são kWh/kW/ano. O arquivo de imagem 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 bandas, correspondendo às 24 horas do dia. Cada pixel é um número inteiro de 32 bits, correspondendo a (até) 31 dias daquele mês. Um bit 1 significa que o local correspondente consegue 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 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.
Quando você faz uma solicitação de dados de sombra por hora, é possível receber até 12 rasters, um para cada mês do ano (de janeiro a dezembro). Cada raster é composto por 24 camadas, ou faixas, 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 ao máximo de 31 dias do mês. A decodificação do dia, da hora e do mês dos dados de sombra exige, portanto, 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) teve 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 de localização (x, y).
- Como junho é o sexto mês do ano, busque o sexto
URL na lista
hourlyShadeUrls. - As faixas de hora são fornecidas no formato de 24 horas. Para receber dados das 16h, procure o 17º canal.
- Índice de bits (dias) a partir de 0. Para acessar os dados do 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 especificadas. Se o bit for 1, o local teve sol. Se o bit for 0, o local terá sombra.
O código abaixo resume as etapas acima:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))