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
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.
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-02-27 UTC."],[[["Retrieves solar information for a specified region using latitude, longitude, and radius."],["Allows customization of data retrieval with parameters like `view`, `requiredQuality`, `pixelSizeMeters`, and `exactQualityRequired`."],["Returns an error if the location is outside the coverage area or if radius exceeds limitations."],["Requires authorization with the `https://www.googleapis.com/auth/cloud-platform` scope."],["Response includes a `DataLayers` object containing the requested solar data subset if successful."]]],["This content details how to retrieve solar information for a specific region via a `GET` request to `https://solar.googleapis.com/v1/dataLayers:get`. The request requires parameters like `location` (latitude/longitude), `radiusMeters`, and optional parameters including `view`, `requiredQuality`, `pixelSizeMeters` and `exactQualityRequired`. The body is empty and a successful response will provide solar data via `DataLayers`. Specific authorization scope `https://www.googleapis.com/auth/cloud-platform` is required. `DataLayerView` allows one to define the solar information subset to be retrieved.\n"]]