REST Resource: dataLayers

Recurso: DataLayers

Informações sobre o potencial solar de uma região. Os dados reais estão contidos em vários arquivos GeoTIFF que abrangem a região solicitada, para os quais a mensagem contém URLs: cada string na mensagem DataLayers contém um URL em que o GeoTIFF correspondente pode ser buscado. Esses URLs são válidos por algumas horas depois de serem gerados. A maioria dos arquivos GeoTIFF tem uma resolução de 0,1 m/pixel, mas o arquivo de fluxo mensal tem 0,5 m/pixel e os arquivos de sombra por hora estão em 1 m/pixel. Se um valor pixelSizeMeters foi especificado em GetDataLayersRequest, a resolução mínima nos arquivos GeoTIFF será esse valor.

Representação JSON 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
Campos
imageryDate

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.
imageryProcessedDate

object (Date)

Quando o processamento das imagens foi concluído.
dsmUrl

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.
rgbUrl

string

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

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.
annualFluxUrl

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.
monthlyFluxUrl

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.
hourlyShadeUrls[]

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).
imageryQuality

enum (ImageryQuality)

A qualidade das imagens do resultado.

Data

Representa uma data inteira ou parcial do calendário, como um aniversário. A hora do dia e o fuso horário são especificados em outro lugar ou são insignificantes. A data é referente ao calendário gregoriano. Isso pode representar uma das seguintes opções:

  • uma data completa, com valores de ano, mês e dia diferentes de zero;
  • um mês e dia, com um ano zero (por exemplo, uma data comemorativa);
  • um ano sozinho, com um mês zero e um dia zero;
  • um ano e mês, com um dia zero (por exemplo, uma data de validade de cartão de crédito).

Tipos relacionados:

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

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

integer

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

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.

ImageryQuality

A qualidade das imagens usadas para calcular algum resultado da API.

Observação: independentemente do nível de qualidade das imagens, as saídas do DSM sempre têm uma resolução de 0,1 m/pixel, as saídas de fluxo mensal sempre têm uma resolução de 0,5 m/pixel e as saídas de sombra por hora sempre têm uma resolução de 1 m/pixel.

Enums
IMAGERY_QUALITY_UNSPECIFIED Nenhuma qualidade é conhecida.
HIGH As imagens subjacentes e os dados do DSM foram processados a 0,1 m/pixel.
MEDIUM As imagens subjacentes e os dados do DSM foram processados a 0,25 m/pixel.
LOW As imagens subjacentes e os dados do DSM foram processados a 0,5 m/pixel.

Métodos

get

 Recebe informações sobre energia solar de uma região ao redor de um local.