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 esta mensagem contém URLs: Cada string na mensagem DataLayers contém um URL no qual o GeoTIFF correspondente pode ser buscado. Esses URLs são válidos por algumas horas depois de serem gerados. A maioria dos arquivos GeoTIFF está em 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 a 1 m/pixel. Se um valor pixelSizeMeters tiver sido 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 tiradas. É um pouco aproximado, porque as imagens podem ter sido tiradas mais de um dia.
imageryProcessedDate

object (Date)

Quando o processamento das imagens foi concluído.
dsmUrl

string

O URL para uma imagem do DMS (modelo de superfície digital) 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 construção: um bit por pixel informando se aquele pixel é considerado parte de um telhado ou não.
annualFluxUrl

string

O URL para o mapa de fluxo anual (luz solar anual nos telhados) da região. Os valores são kWh/kW/ano. Esse é um fluxo sem máscara: ele é calculado para todos os locais, não apenas coberturas de edifícios. Locais inválidos são armazenados como -9999: 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 para o 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 doze faixas, correspondentes a janeiro...dezembro, em ordem.
hourlyShadeUrls[]

string

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

Um exemplo pode ser útil. Para saber se um ponto (na localização de pixels (x, y)) viu o sol às 16h no dia 22 de junho, faça o seguinte:

  1. busque o sexto URL dessa lista (correspondente a junho).
  2. procure o 17o canal (correspondente às 16h).
  3. lê o valor de 32 bits em (x, y).
  4. lê o bit 21 do valor (correspondente ao dia 22 do mês).
  5. se o bit for 1, então aquele local viu o sol às 16h no dia 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 em uma posição (x, y) é o bit

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

em que (x, y) é indexação espacial, [month - 1] se refere à busca do month - 1o URL (indexação de zero), [hour] é a indexação dos 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 "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 um dia, com ano zero (por exemplo, uma data comemorativa).
  • Um ano sozinho, com mês zero e dia zero.
  • Um ano e um mês, com um dia zero (por exemplo, uma data de validade do 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 9999 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 CPM 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 DFP foram processados a 0,1 m/pixel.
MEDIUM As imagens subjacentes e os dados do DFP foram processados a 0,25 m/pixel.
LOW As imagens subjacentes e os dados do DFP foram processados a 0,5 m/pixel.

Métodos

get

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