Method: dataLayers.get
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Recupera le informazioni solari per una regione che circonda una località. Restituisce un errore con codice NOT_FOUND
se la località si trova al di fuori dell'area di copertura.
Richiesta HTTP
GET https://solar.googleapis.com/v1/dataLayers:get
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
Parametri |
location |
object (LatLng )
Obbligatorio. La longitudine e la latitudine del centro della regione per cui vuoi ottenere i dati.
|
radiusMeters |
number
Obbligatorio. Il raggio, in metri, che definisce la regione che circonda il punto centrale per cui devono essere restituiti i dati. Le limitazioni di questo valore sono:
- È sempre possibile specificare qualsiasi valore fino a 100 milioni.
- Possono essere specificati valori superiori a 100 m, purché
radiusMeters <= pixelSizeMeters * 1000 .
- Tuttavia, per valori superiori a 175 m, il valore
DataLayerView nella richiesta non deve includere il flusso mensile o l'ombra oraria.
|
view |
enum (DataLayerView )
Facoltativo. Il sottoinsieme di dati da restituire.
|
requiredQuality |
enum (ImageryQuality )
Facoltativo. Il livello di qualità minimo consentito nei risultati. Non verrà restituito alcun risultato di qualità inferiore. Se non lo specifichi, la restrizione è limitata solo alla qualità ALTA.
|
pixelSizeMeters |
number
Facoltativo. La scala minima, in metri per pixel, dei dati da restituire. Sono supportati i valori 0,1 (il valore predefinito, se questo campo non è impostato esplicitamente), 0,25, 0,5 e 1,0. I componenti delle immagini la cui risoluzione normale è inferiore a pixelSizeMeters verranno restituiti con la risoluzione specificata da pixelSizeMeters ; i componenti delle immagini la cui risoluzione normale è uguale o superiore a pixelSizeMeters verranno restituiti con questa risoluzione normale.
|
exactQualityRequired |
boolean
Facoltativo. Se richiedere una qualità esatta delle immagini. Se impostato su false, il campo requiredQuality viene interpretato come la qualità minima richiesta, in modo che le immagini di ALTA qualità possano essere restituite quando requiredQuality è impostato su MEDIO. Se impostato su true, requiredQuality viene interpretato come la qualità esatta richiesta e vengono restituite solo immagini con qualità MEDIUM se requiredQuality è impostato su MEDIUM .
|
experiments[] |
enum (Experiment )
Facoltativo. Specifica gli esperimenti pre-GA da attivare.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di DataLayers
.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
DataLayerView
Il sottoinsieme di informazioni solari da restituire.
Enum |
DATA_LAYER_VIEW_UNSPECIFIED |
Equivalente a COMPLETO. |
DSM_LAYER |
Ricevi solo DSM. |
IMAGERY_LAYERS |
Ottieni il DSM, l'RGB e la maschera. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
Ottieni DSM, RGB, maschera e flusso annuale. |
IMAGERY_AND_ALL_FLUX_LAYERS |
Visualizza DSM, RGB, maschera, flusso annuale e flusso mensile. |
FULL_LAYERS |
Ottieni tutti i dati. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]