Method: dataLayers.get

Recebe informações sobre a energia solar de uma região ao redor de um local. Retorna um erro com o código NOT_FOUND se o local estiver fora da área de cobertura.

Solicitação HTTP

GET https://solar.googleapis.com/v1/dataLayers:get

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
location

object (LatLng)

Obrigatório. A longitude e a latitude do centro da região para os dados serem buscados.

radiusMeters

number

Obrigatório. O raio, em metros, que define a região em torno desse ponto central para o qual os dados devem ser retornados. As limitações desse valor são:

  • Qualquer valor de até 100 m sempre pode ser especificado.
  • Valores acima de 100 m podem ser especificados, desde que radiusMeters <= pixelSizeMeters * 1000.
  • No entanto, para valores acima de 175 m, o DataLayerView na solicitação não pode incluir fluxo mensal ou sombra por hora.
view

enum (DataLayerView)

Opcional. O subconjunto desejado dos dados a serem retornados.

requiredQuality

enum (ImageryQuality)

Opcional. O nível de qualidade mínimo permitido nos resultados. Nenhum resultado com qualidade inferior a essa será retornado. Não especificar isso equivale a restringir apenas a qualidade ALTA.

pixelSizeMeters

number

Opcional. A escala mínima, em metros por pixel, dos dados a serem retornados. Os valores 0,1 (padrão, se o campo não for definido explicitamente), 0,25, 0,5 e 1,0 são compatíveis. Componentes de imagem com resolução normal menor que pixelSizeMeters serão retornados na resolução especificada por pixelSizeMeters. Componentes de imagens com resolução normal igual ou maior que pixelSizeMeters serão retornados com essa resolução normal.

exactQualityRequired

boolean

Opcional. Se as imagens precisam de qualidade exata. Se a política for definida como "false", o campo requiredQuality será interpretado como a qualidade mínima necessária. Assim, imagens de ALTA qualidade poderão ser retornadas quando requiredQuality estiver definido como MÉDIO. Se definido como verdadeiro, requiredQuality será interpretado como a qualidade exata exigida e somente imagens de qualidade MEDIUM serão retornadas se requiredQuality for definido como MEDIUM.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de DataLayers.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

DataLayerView

Que subconjunto de informações solares retornar.

Enums
DATA_LAYER_VIEW_UNSPECIFIED Equivalente a FULL.
DSM_LAYER Obtenha apenas o DFP.
IMAGERY_LAYERS Obtenha o saber, o RGB e a máscara.
IMAGERY_AND_ANNUAL_FLUX_LAYERS Obtenha o DFP, o RGB, a máscara e o fluxo anual.
IMAGERY_AND_ALL_FLUX_LAYERS Obtenção de DDL, RGB, máscara, fluxo anual e fluxo mensal.
FULL_LAYERS Coletar todos os dados.