Method: dataLayers.get

Recupera le informazioni solari per una regione che circonda 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)

Obbligatorio. La longitudine e la latitudine del centro della regione per cui recuperare 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 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 i valori superiori a 175 m, il DataLayerView nella richiesta non deve includere il flusso mensile o l'ombreggiatura oraria.
view

enum (DataLayerView)

Facoltativo. Il sottoinsieme di dati da restituire.

requiredQuality

enum (ImageryQuality)

Facoltativo. Il livello qualitativo minimo consentito nei risultati. Non verrà restituito alcun risultato con una qualità inferiore a questa. Se non viene specificato, equivale a limitare 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 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 è uguale o superiore a pixelSizeMeters verranno restituiti alla risoluzione normale.

exactQualityRequired

boolean

Facoltativo. Indica se richiedere la qualità esatta delle immagini. Se impostato su false, il campo requiredQuality viene interpretato come la qualità minima richiesta, in modo che le immagini di qualità ALTA possano essere restituite quando requiredQuality è impostato su MEDIA. Se impostato su true, requiredQuality viene interpretato come la qualità esatta richiesta e vengono restituite solo immagini di qualità MEDIUM se requiredQuality è impostato su MEDIUM.

experiments[]

enum (Experiment)

Facoltativo. Specifica gli esperimenti pre-GA da attivare. Le richieste che utilizzano questo campo sono classificate come offerta pre-GA ai sensi dei Termini specifici dei servizi della piattaforma Google Maps. Per ulteriori dettagli, consulta le [descrizioni della fase di lancio]( https://cloud.google.com/maps-platform/terms/launch-stages).

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 FULL.
DSM_LAYER Recupera solo il DSM.
IMAGERY_LAYERS Recupera il DSM, l'RGB e la maschera.
IMAGERY_AND_ANNUAL_FLUX_LAYERS Recupera il DSM, l'RGB, la maschera e il flusso annuale.
IMAGERY_AND_ALL_FLUX_LAYERS Recupera il DSM, l'RGB, la maschera, il flusso annuale e il flusso mensile.
FULL_LAYERS Recupera tutti i dati.