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, e esta 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 após a geração. 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 de 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) foram tiradas. Ele é necessariamente aproximado, já que as imagens podem ter sido tiradas em mais de um dia.
imageryProcessedDate

object (Date)

Quando o processamento foi concluído nas imagens.
dsmUrl

string

O URL de uma imagem do DSM (modelo de superfície digital) da região. Os valores estão em metros acima do geóide EGM96 (ou seja, do nível do mar). Os locais inválidos (onde não há 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 informando se o pixel é considerado parte de um telhado ou não.
annualFluxUrl

string

O URL do mapa de fluxo anual (insolação anual nos telhados) da região. Os valores são kWh/kW/ano. Esse é o fluxo desmascarado: o fluxo é calculado para cada local, não apenas para os telhados dos edifícios. Os 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, em que 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, dividido por mês) da região. Os valores são kWh/kW/ano. O GeoTIFF indicado por este URL vai conter 12 bandas, correspondentes a janeiro a dezembro, em ordem.
hourlyShadeUrls[]

string

Doze URLs para sombra por hora, correspondentes a janeiro...dezembro, em ordem. Cada GeoTIFF vai conter 24 faixas, correspondendo às 24 horas do dia. Cada pixel é um número inteiro de 32 bits, correspondente a até 31 dias daquele mês. Um bit significa que o local correspondente consegue ver o sol naquele dia, hora e mês. Locais inválidos são armazenados como -9999. Como esse valor é negativo, ele tem 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 (na localização do pixel (x, y)) teve sol às 16h do dia 22 de junho, faça o seguinte:

  1. buscar o sexto URL da lista (correspondente a junho).
  2. pesquise o canal 17 (correspondente às 16h).
  3. Leia o valor de 32 bits em (x, y).
  4. Leia o bit 21 do valor (correspondente ao dia 22 do mês).
  5. Se esse bit for 1, o local terá recebido luz solar às 16h do dia 22 de junho.

De forma mais formal: considerando month (1 a 12), day (1 a 31, no máximo, sendo que 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 URL month - 1st (indexação a partir de zero), [hour] é a indexação 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; o meio-dia é sempre "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 alguns resultados da API.

Observação: independentemente do nível de qualidade das imagens, as saídas de 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 A qualidade não é conhecida.
HIGH Os dados solares são derivados de imagens aéreas capturadas em baixa altitude e processados 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.
LOW 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.