Method: dataLayers.get

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 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.
FULL_LAYERS Ottieni tutti i dati.