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
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.
Facoltativo. Il livello di qualità minimo consentito nei risultati. Non verrà restituito alcun risultato con una qualità inferiore a questa. Se non lo specifichi, la ricerca è 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.
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
Ottieni DSM, RGB, maschera, flusso annuale e flusso mensile.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-12-21 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"]]