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 ( |
Campos | |
---|---|
imageryDate |
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 |
Quando o processamento das imagens foi concluído. |
dsmUrl |
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 |
O URL para uma imagem de dados RGB (foto aérea) da região. |
maskUrl |
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 |
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 |
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[] |
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:
Mais formalmente: considerando
em que |
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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Representação JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campos | |
---|---|
year |
Ano da data. Precisa ser de 1 a 9999 ou 0 para especificar uma data sem ano. |
month |
Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia. |
day |
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 |
|
---|---|
|
Recebe informações de energia solar de uma região ao redor de um local. |