Method: dataLayers.get

Recupera le informazioni sull'energia solare per una regione intorno a una località. Restituisce un errore con il 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 ricerca

Parametri
location

object (LatLng)

Obbligatoria. La longitudine e la latitudine del centro della regione per la quale ottenere i dati.

radiusMeters

number

Obbligatoria. Il raggio, in metri, che definisce la regione circostante il punto centrale per cui devono essere restituiti i dati. Le limitazioni su questo valore sono:

  • È sempre possibile specificare qualsiasi valore fino a 100 m.
  • È possibile specificare valori superiori a 100 m, purché radiusMeters <= pixelSizeMeters * 1000.
  • Tuttavia, per valori superiori a 175 m, DataLayerView nella richiesta non deve includere il flusso mensile o il colore orario.
view

enum (DataLayerView)

Campo facoltativo. Il sottoinsieme di dati desiderato da restituire.

requiredQuality

enum (ImageryQuality)

Campo facoltativo. Il livello qualitativo minimo consentito nei risultati. Non verrà restituito nessun risultato con una qualità inferiore. Non specificarlo equivale a limitare solo alla qualità ALTA.

pixelSizeMeters

number

Campo facoltativo. La scala minima, in metri per pixel, dei dati da restituire. Sono supportati i valori 0,1 (valore predefinito, se questo campo non è impostato in modo esplicito), 0,25, 0,5 e 1,0. I componenti di immagini la cui risoluzione normale è inferiore a pixelSizeMeters verranno restituiti alla risoluzione specificata da pixelSizeMeters; i componenti di immagini la cui risoluzione normale è pari o superiore a pixelSizeMeters verranno restituiti alla risoluzione normale.

exactQualityRequired

boolean

Campo facoltativo. Se richiedere la qualità esatta delle immagini. Se viene impostato su false, il campo requiredQuality viene interpretato come la qualità minima richiesta, in modo che possano essere restituite immagini di ALTA qualità quando requiredQuality viene impostato su MEDIUM. Se impostato su true, requiredQuality viene interpretato come l'esatta qualità richiesta e vengono restituite solo immagini di 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

Quale sottoinsieme di informazioni sul sole restituire.

Enum
DATA_LAYER_VIEW_UNSPECIFIED Equivalente a FULL.
DSM_LAYER Scaricare solo il database.
IMAGERY_LAYERS Recuperare i valori DS, RGB e la maschera.
IMAGERY_AND_ANNUAL_FLUX_LAYERS Ottieni i valori predefiniti dei modelli DS, RGB, la maschera e il flusso annuale.
IMAGERY_AND_ALL_FLUX_LAYERS Ottieni i seguenti valori: MasterCard, RGB, maschera, flusso annuale e flusso mensile.
FULL_LAYERS Recupera tutti i dati.