Method: dataLayers.get
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 está fuera del área de cobertura.
Solicitud HTTP
GET https://solar.googleapis.com/v1/dataLayers:get
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros |
location |
object (LatLng )
Obligatorio. La longitud y la latitud del centro de la región para la que se deben obtener datos
|
radiusMeters |
number
Obligatorio. Es el radio, en metros, que define la región que rodea ese punto central para el que se deben mostrar los datos. Las limitaciones de este valor son las siguientes:
- Siempre se puede especificar cualquier valor de hasta 100 m.
- Se pueden especificar valores superiores a 100 m, siempre que
radiusMeters <= pixelSizeMeters * 1000 .
- Sin embargo, para valores superiores a 175 m, el
DataLayerView de la solicitud no debe incluir el flujo mensual ni la sombra por hora.
|
view |
enum (DataLayerView )
Opcional. Es el subconjunto deseado de los datos que se mostrarán.
|
requiredQuality |
enum (ImageryQuality )
Opcional. Es el nivel de calidad mínimo permitido en los resultados. No se mostrará ningún resultado con una calidad inferior a esta. Si no se especifica, se limita solo a la calidad ALTA.
|
pixelSizeMeters |
number
Opcional. Es la escala mínima, en metros por píxel, de los datos que se mostrarán. Se admiten los valores 0.1 (el valor predeterminado, si no se establece este campo de forma explícita), 0.25, 0.5 y 1.0. Los componentes de imágenes cuya resolución normal sea inferior a pixelSizeMeters se mostrarán en la resolución especificada por pixelSizeMeters . Los componentes de imágenes cuya resolución normal sea igual o superior a pixelSizeMeters se mostrarán en esa resolución normal.
|
exactQualityRequired |
boolean
Opcional. Indica si se requiere una calidad exacta de las imágenes. Si se establece en "false", el campo requiredQuality se interpreta como la calidad mínima requerida, de modo que se puedan mostrar imágenes de alta calidad cuando requiredQuality se establezca en "MEDIA". Si se establece como verdadero, requiredQuality se interpreta como la calidad requerida exacta y solo se muestran imágenes de calidad MEDIUM si requiredQuality se establece en MEDIUM .
|
experiments[] |
enum (Experiment )
Opcional. Especifica los experimentos de fase previa a la DG que se habilitarán.
|
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
.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/cloud-platform
DataLayerView
Qué subconjunto de la información solar se debe mostrar.
Enumeraciones |
DATA_LAYER_VIEW_UNSPECIFIED |
Equivale a FULL. |
DSM_LAYER |
Obtén solo el DSM. |
IMAGERY_LAYERS |
Obtén el DSM, el RGB y la máscara. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
Obtén el DSM, el RGB, la máscara y el flujo anual. |
IMAGERY_AND_ALL_FLUX_LAYERS |
Obtén el DSM, el RGB, la máscara, el flujo anual y el flujo mensual. |
FULL_LAYERS |
Obtén todos los datos. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-29 (UTC)
[null,null,["Última actualización: 2025-08-29 (UTC)"],[[["\u003cp\u003eRetrieves solar information for a specified region using latitude, longitude, and radius.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of data retrieval with parameters like \u003ccode\u003eview\u003c/code\u003e, \u003ccode\u003erequiredQuality\u003c/code\u003e, \u003ccode\u003epixelSizeMeters\u003c/code\u003e, and \u003ccode\u003eexactQualityRequired\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eReturns an error if the location is outside the coverage area or if radius exceeds limitations.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a \u003ccode\u003eDataLayers\u003c/code\u003e object containing the requested solar data subset if successful.\u003c/p\u003e\n"]]],["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"],null,["# Method: dataLayers.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [DataLayerView](#DataLayerView)\n- [Try it!](#try-it)\n\nGets solar information for a region surrounding a location. Returns an error with code `NOT_FOUND` if the location is outside the coverage area.\n\n### HTTP request\n\n`GET https://solar.googleapis.com/v1/dataLayers:get`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `location` | `object (`[LatLng](/maps/documentation/solar/reference/rest/v1/LatLng)`)` Required. The longitude and latitude for the center of the region to get data for. |\n| `radiusMeters` | `number` Required. The radius, in meters, defining the region surrounding that centre point for which data should be returned. The limitations on this value are: - Any value up to 100m can always be specified. - Values over 100m can be specified, as long as `radiusMeters` \\\u003c= `pixelSizeMeters * 1000`. - However, for values over 175m, the `DataLayerView` in the request must not include monthly flux or hourly shade. |\n| `view` | `enum (`[DataLayerView](/maps/documentation/solar/reference/rest/v1/dataLayers/get#DataLayerView)`)` Optional. The desired subset of the data to return. |\n| `requiredQuality` | `enum (`[ImageryQuality](/maps/documentation/solar/reference/rest/v1/dataLayers#ImageryQuality)`)` Optional. The minimum quality level allowed in the results. No result with lower quality than this will be returned. Not specifying this is equivalent to restricting to HIGH quality only. |\n| `pixelSizeMeters` | `number` Optional. The minimum scale, in meters per pixel, of the data to return. Values of 0.1 (the default, if this field is not set explicitly), 0.25, 0.5, and 1.0 are supported. Imagery components whose normal resolution is less than `pixelSizeMeters` will be returned at the resolution specified by `pixelSizeMeters`; imagery components whose normal resolution is equal to or greater than `pixelSizeMeters` will be returned at that normal resolution. |\n| `exactQualityRequired` | `boolean` Optional. Whether to require exact quality of the imagery. If set to false, the `requiredQuality` field is interpreted as the minimum required quality, such that HIGH quality imagery may be returned when `requiredQuality` is set to MEDIUM. If set to true, `requiredQuality` is interpreted as the exact required quality and only `MEDIUM` quality imagery is returned if `requiredQuality` is set to `MEDIUM`. |\n| `experiments[]` | `enum (`[Experiment](/maps/documentation/solar/reference/rest/v1/Experiment)`)` Optional. Specifies the pre-GA experiments to enable. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [DataLayers](/maps/documentation/solar/reference/rest/v1/dataLayers#DataLayers).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nDataLayerView\n-------------\n\nWhat subset of the solar information to return.\n\n| Enums ||\n|----------------------------------|--------------------------------------------------------|\n| `DATA_LAYER_VIEW_UNSPECIFIED` | Equivalent to FULL. |\n| `DSM_LAYER` | Get the DSM only. |\n| `IMAGERY_LAYERS` | Get the DSM, RGB, and mask. |\n| `IMAGERY_AND_ANNUAL_FLUX_LAYERS` | Get the DSM, RGB, mask, and annual flux. |\n| `IMAGERY_AND_ALL_FLUX_LAYERS` | Get the DSM, RGB, mask, annual flux, and monthly flux. |\n| `FULL_LAYERS` | Get all data. |"]]