O endpoint dataLayers retorna dados codificados como arquivos GeoTIFF, que podem ser usados em qualquer aplicativo de sistema de informações geográficas (GIS, na sigla em inglês) para projetar sistemas solares.
Cada string na resposta do dataLayer 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 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, porque o conteúdo é um dado 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) | 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 |
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 indicando 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 sobre os telhados, da região.
Os valores são kWh/kW/ano. O fluxo é calculado para cada local, não apenas edifícios. Locais inválidos ou áreas em que não foi possível calcular o fluxo são armazenados como -9999. Os locais fora da nossa área de cobertura são inválidos. Observação:esse é um fluxo sem máscara. |
| Fluxo mensal | 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 imagens GeoTIFF contém 12 faixas correspondentes a janeiro e dezembro, em ordem. |
| Sombra de hora em hora | Número inteiro de 32 bits | 1 m/pixel | 12 URLs para mapas de sombra por hora correspondentes a janeiro e dezembro, em
ordem. Cada arquivo GeoTIFF contém 24 faixas, correspondentes às 24 horas do dia. Cada pixel é um número inteiro de 32 bits, correspondente aos 31 dias do mês. Um bit significa que o local correspondente pode ver o sol naquele dia, a essa hora, daquele mês. Locais inválidos são armazenados como -9999 e têm o bit 31 definido, já que isso corresponde ao 32o dia do mês e, portanto, é inválido. |
Decodificar varreduras de sombra por hora
Os dados de sombra por hora são codificados em varreduras de banda múltipla. Para saber mais sobre os conceitos básicos de varredura, consulte Conceitos da API Solar.
Ao solicitar dados de sombra por hora, você pode receber até 12 rasterizações, uma para cada mês do ano (de janeiro a dezembro). Cada varredura é composta por 24 camadas, ou faixas, 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 aos 31 dias (máximo) do mês. Portanto, para decodificar o dia, a hora e o mês dos dados de sombra é preciso 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 sol às 16h em 22 de junho, faça o seguinte:
- Faça uma solicitação de camadas de dados para todas as camadas para a localização (x, y).
- Como o mês de junho é o sexto mês, busque o sexto
URL na lista
hourlyShadeUrls. - As faixas de hora em hora são fornecidas no formato de 24 horas. Para acessar dados das 16h (16h), procure o 17o canal.
- Índice de bits (dias) a partir de 0. Para obter dados do dia 22 de junho, leia o bit 21.
- Os bits fornecem dados binários indicando se aquele local foi detectado pelo sol na data e hora determinadas. Se o bit for 1, o local detectou 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))