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 cobrem a região solicitada, para os quais esta mensagem contém URLs: cada string na mensagem DataLayers contém um URL de onde 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 têm 1 m/pixel. Se um valor pixelSizeMeters foi especificado no 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) nessa região foram capturadas. Ela é necessariamente aproximada, já que as imagens podem ter sido tiradas em mais de um dia.
imageryProcessedDate

object (Date)

Quando o processamento dessas imagens foi concluído.
dsmUrl

string

O URL de uma imagem do DSM (Modelo Digital de Superfície) da região. Os valores estão em metros acima do geoide EGM96 (ou seja, o nível do mar). Locais inválidos (onde não temos dados) são armazenados como -9999.
rgbUrl

string

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

string

O URL da imagem da máscara do edifício: um bit por pixel indicando se esse 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. Esse é o fluxo sem máscara: o fluxo é calculado para todos os locais, não apenas para os telhados dos edifícios. Locais inválidos são armazenados como -9999: locais fora da nossa área de cobertura são inválidos, e alguns locais dentro da área de cobertura, onde não foi possível calcular o fluxo, também são inválidos.
monthlyFluxUrl

string

O URL do mapa de fluxo mensal (luz solar nos telhados, dividido por mês) da região. Os valores são kWh/kW/ano. O GeoTIFF apontado por esse URL contém 12 bandas, correspondentes a janeiro...dezembro, em ordem.
hourlyShadeUrls[]

string

Doze URLs para sombra por hora, correspondentes a janeiro...dezembro, em ordem. Cada GeoTIFF vai conter 24 bandas, correspondentes às 24 horas do dia. Cada pixel é um número inteiro de 32 bits, correspondente aos (até) 31 dias daquele mês. Um bit 1 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. Como esse valor é negativo, o bit 31 é definido, e nenhum valor válido pode ter o bit 31 definido, já que isso corresponderia ao 32º dia do mês.

Um exemplo pode ser útil. Se você quiser saber se um ponto (no local do pixel (x, y)) recebeu sol às 16h do dia 22 de junho, faça o seguinte:

  1. buscar o sexto URL desta lista (correspondente a junho).
  2. procure o 17º canal (correspondente às 16h).
  3. leia o valor de 32 bits em (x, y).
  4. leia o bit 21 do valor (correspondente ao 22º dia do mês).
  5. Se esse bit for 1, o local recebeu sol às 16h do dia 22 de junho.

Mais formalmente: considerando month (1 a 12), day (1 até o máximo de dias do mês; fevereiro tem 28 dias) e hour (0 a 23), a sombra/sol para esse mês/dia/hora em uma 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 - 1º URL (indexação de zero), [hour] é a indexação nos canais, e um resultado final diferente de zero significa "ensolarado". Não há anos bissextos, e o horário de verão não existe (todos os dias têm 24 horas; o meio-dia é sempre o meio-dia do "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 um resultado da API.

Observação: independente 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.

Tipos enumerados
IMAGERY_QUALITY_UNSPECIFIED Nenhuma qualidade é conhecida.
HIGH Os dados solares são derivados de imagens aéreas capturadas em baixa altitude e processadas a 0,1 m/pixel.
MEDIUM Os dados solares são derivados de imagens aéreas aprimoradas capturadas em alta altitude e processadas a 0,25 m/pixel.
BASE Os dados solares são derivados de imagens de satélite aprimoradas processadas a 0,25 m/pixel.

Métodos

get

 Recebe informações solares de uma região ao redor de um local.