Obtiene información solar de una región que rodea una ubicación. Muestra un error con el código NOT_FOUND si la ubicación se encuentra fuera del área de cobertura.
Solicitud HTTP
GET https://solar.googleapis.com/v1/dataLayers:get
Obligatorio. La longitud y la latitud del centro de la región de las que se obtendrán datos.
radiusMeters
number
Obligatorio. Es el radio, en metros, que define la región que rodea ese punto central para el que se deben devolver los datos. Las limitaciones de este valor son las siguientes:
Siempre se puede especificar cualquier valor hasta 100m.
Se pueden especificar valores superiores a 100 m, siempre y cuando radiusMeters <= pixelSizeMeters * 1000.
Sin embargo, para valores superiores a 175m, el DataLayerView de la solicitud no debe incluir flujo mensual ni sombra por hora.
Opcional. Es el nivel de calidad mínimo permitido en los resultados. No se devolverá ningún resultado con una calidad inferior. No especificar esto equivale a restringirlo a ALTA calidad solamente.
pixelSizeMeters
number
Opcional. Es la escala mínima, en metros por píxel, de los datos que se mostrarán. Se admiten valores de 0.1 (el valor predeterminado, si este campo no se establece de forma explícita), 0.25, 0.5 y 1.0. Los componentes de imágenes cuya resolución normal es inferior a pixelSizeMeters se mostrarán con la resolución especificada por pixelSizeMeters; los componentes de imágenes cuya resolución normal sea igual o superior a pixelSizeMeters se mostrarán con esa resolución normal.
exactQualityRequired
boolean
Opcional. Si se requiere una calidad exacta de las imágenes Si se establece como falsa, el campo requiredQuality se interpreta como la calidad mínima requerida, de modo que se pueden mostrar imágenes de ALTA calidad cuando se establece requiredQuality en MEDIA. Si se establece como verdadera, requiredQuality se interpreta como la calidad exacta requerida y solo se muestran imágenes de calidad MEDIUM si se establece requiredQuality en MEDIUM.
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de DataLayers.
Alcances de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/cloud-platform
DataLayerView
Qué subconjunto de información de energía solar se va a devolver.
Enumeradores
DATA_LAYER_VIEW_UNSPECIFIED
Equivale a FULL.
DSM_LAYER
Obtén solo el DSM.
IMAGERY_LAYERS
Obtén el DSM, RGB y la máscara.
IMAGERY_AND_ANNUAL_FLUX_LAYERS
Obtén el DSM, RGB, máscara y flujo anual.
IMAGERY_AND_ALL_FLUX_LAYERS
Obtén el DSM, RGB, máscara, flujo anual y flujo mensual.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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"]]