Method: dataLayers.get

Recebe informações solares para 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 extrair dados.
radiusMeters

number

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

  • É possível especificar qualquer valor até 100 m.
  • 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 de dados desejado a ser retornado.
requiredQuality

enum (ImageryQuality)

Opcional. O nível mínimo de qualidade permitido nos resultados. Nenhum resultado com qualidade inferior a essa será retornado. Não especificar isso é equivalente 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 esse campo não for definido explicitamente), 0,25, 0,5 e 1,0 são aceitos. Os componentes de imagem com resolução normal inferior a pixelSizeMeters serão retornados na resolução especificada por pixelSizeMeters. Os componentes de imagem com resolução normal igual ou superior a pixelSizeMeters serão retornados nessa resolução normal.
exactQualityRequired

boolean

Opcional. Se a qualidade exata das imagens é obrigatória. Se definido como "false", o campo requiredQuality é interpretado como a qualidade mínima necessária. Assim, imagens de ALTA qualidade podem ser retornadas quando requiredQuality é definido como MEDIUM. Se definido como "true", requiredQuality é interpretado como a qualidade exata necessária, e apenas imagens de qualidade MEDIUM sã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

Qual subconjunto das informações solares retornar.

Enums
DATA_LAYER_VIEW_UNSPECIFIED É equivalente a "FULL".
DSM_LAYER Receber apenas o DSM.
IMAGERY_LAYERS Receba o DSM, o RGB e a máscara.
IMAGERY_AND_ANNUAL_FLUX_LAYERS Receba o DSM, RGB, máscara e fluxo anual.
IMAGERY_AND_ALL_FLUX_LAYERS Receba o DSM, RGB, máscara, fluxo anual e fluxo mensal.
FULL_LAYERS Receber todos os dados.