Method: dataLayers.get

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

radiusMeters

number

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

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

enum (DataLayerView)

Opcional. O subconjunto desejado dos dados a serem retornados.

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 à 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 aceitos. Os componentes de imagens cuja resolução normal for menor que pixelSizeMeters serão retornados na resolução especificada por pixelSizeMeters. Os componentes de imagens cuja resolução normal for igual ou maior que pixelSizeMeters serão retornados nessa resolução normal.

exactQualityRequired

boolean

Opcional. Se a qualidade exata das imagens é necessária. Se definido 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 for definido como "MEDIUM". Se definido como "true", requiredQuality será interpretado como a qualidade exata necessária, e somente imagens de qualidade MEDIUM serão retornadas se requiredQuality for definido como MEDIUM.

experiments[]

enum (Experiment)

Opcional. Especifica os experimentos pré-GA a serem ativados. As solicitações que usam esse campo são classificadas como um produto ou recurso em pré-GA nos Termos de Serviço específicos da Plataforma Google Maps. Consulte as [descrições da fase de lançamento]( https://cloud.google.com/maps-platform/terms/launch-stages) para mais detalhes.

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 será retornado.

Tipos enumerados
DATA_LAYER_VIEW_UNSPECIFIED Equivalente a FULL.
DSM_LAYER Receba apenas o DSM.
IMAGERY_LAYERS Acesse 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.