REST Resource: dataLayers

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

object (Date)

Quando as imagens de origem (de onde todos os outros dados são derivados) dessa região foram tiradas. Ela é aproximada, já que as imagens podem ter sido tiradas durante mais de um dia.

object (Date)

Quando o processamento das imagens foi concluído.

string

O URL de uma imagem do modelo de superfície digital (DSM, na sigla em inglês) da região. Os valores estão em metros acima do geoid EGM96 (ou seja, nível do mar). Locais inválidos (onde não temos dados) são armazenados como -9999.

string

O URL para uma imagem de dados RGB (foto aérea) da região.

string

É o URL da imagem da máscara de edifícios: um bit por pixel, informando se o pixel é considerado parte de um telhado ou não.

string

O URL do mapa de fluxo anual (luz solar anual nos telhados) da região. Os valores são kWh/kW/ano. Este é um fluxo sem máscara: ele é calculado para todos os locais, não apenas telhados de edifícios. Os locais inválidos são armazenados como -9999: os locais fora da nossa área de cobertura serão inválidos e alguns locais dentro da área de cobertura, onde não foi possível calcular o fluxo, também serão inválidos.

string

O URL do mapa de fluxo mensal (luz solar nos telhados, dividida por mês) da região. Os valores são kWh/kW/ano. O GeoTIFF apontado por este URL contém doze faixas, correspondentes a janeiro...dezembro, em ordem.

string

Doze URLs para sombra por hora, correspondendo a janeiro a dezembro, em ordem. Cada GeoTIFF contém 24 faixas, correspondendo às 24 horas do dia. Cada pixel é um número inteiro de 32 bits, correspondendo aos (até) 31 dias daquele mês. um bit significa que o local correspondente é capaz de ver o sol naquele dia, naquela hora, do mês. Locais inválidos são armazenados como -9999 (pois é negativo, tem o bit 31 definido e nenhum valor válido poderia ter o bit 31 definido, pois corresponderia ao 32o dia do mês).

Um exemplo pode ser útil. Se você quiser saber se um ponto (na localização de pixels (x, y)) viu o sol às 16h do dia 22 de junho:

1. buscar o sexto URL nessa lista (correspondente a junho).
2. procure o 17o canal (correspondente às 16h).
3. ler o valor de 32 bits em (x, y).
4. ler o bit 21 do valor (correspondente ao dia 22 do mês).
5. se aquela parte é 1, então aquele local viu o sol às 16h de 22 de junho.

Mais formalmente: considerando month (1-12), day (máximo de 1...mês; fevereiro tem 28 dias) e hour (0-23), a sombra/sol para esse mês/dia/hora na posição (x, y) é o bit

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

em que (x, y) é a indexação espacial, [month - 1] se refere à busca do month - 1o URL (indexando a partir de zero), [hour] está indexando nos canais e um resultado final diferente de zero significa "ensolarado". Não há dias bissextos, e o horário de verão não existe (todos os dias têm 24 horas de duração; meio-dia é sempre o meio-dia no horário padrão).

enum (ImageryQuality)

A qualidade das imagens do resultado.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.