Method: dataLayers.get

Obtient des informations sur l'ensoleillement pour une région entourant un emplacement. Renvoie une erreur avec le code NOT_FOUND si l'établissement se trouve en dehors de la zone de couverture.

Requête HTTP

GET https://solar.googleapis.com/v1/dataLayers:get

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
location

object (LatLng)

Obligatoire. Longitude et latitude du centre de la région pour laquelle obtenir des données.
radiusMeters

number

Obligatoire. Rayon, en mètres, définissant la région entourant ce point central pour laquelle les données doivent être renvoyées. Les limites de cette valeur sont les suivantes :

  • Vous pouvez toujours spécifier une valeur jusqu'à 100 m.
  • Vous pouvez spécifier des valeurs supérieures à 100 millions, à condition que radiusMeters <= pixelSizeMeters * 1000.
  • Toutefois, pour les valeurs supérieures à 175 m, le DataLayerView de la requête ne doit pas inclure le flux mensuel ni l'ombre horaire.
view

enum (DataLayerView)

Facultatif. Sous-ensemble de données à renvoyer.
requiredQuality

enum (ImageryQuality)

Facultatif. Niveau de qualité minimal autorisé dans les résultats. Aucun résultat de qualité inférieure ne sera renvoyé. Si vous ne spécifiez pas cette valeur, cela équivaut à limiter la qualité à ÉLEVÉE uniquement.
pixelSizeMeters

number

Facultatif. Échelle minimale, en mètres par pixel, des données à renvoyer. Les valeurs 0,1 (valeur par défaut si ce champ n'est pas défini explicitement), 0,25, 0,5 et 1,0 sont acceptées. Les composants d'imagerie dont la résolution normale est inférieure à pixelSizeMeters seront renvoyés à la résolution spécifiée par pixelSizeMeters. Les composants d'imagerie dont la résolution normale est égale ou supérieure à pixelSizeMeters seront renvoyés à cette résolution normale.
exactQualityRequired

boolean

Facultatif. Indique si la qualité exacte des images est requise. Si la valeur est définie sur "false", le champ requiredQuality est interprété comme la qualité minimale requise. Ainsi, des images de haute qualité peuvent être renvoyées lorsque requiredQuality est défini sur "MEDIUM". Si la valeur est définie sur "true", requiredQuality est interprété comme la qualité exacte requise et seules les images de qualité MEDIUM sont renvoyées si requiredQuality est défini sur MEDIUM.
experiments[]

enum (Experiment)

Facultatif. Spécifie les tests de pré-DG à activer. Les requêtes utilisant ce champ sont classées comme offre de pré-DG dans les Conditions spécifiques du service Google Maps Platform. Pour en savoir plus, consultez les [descriptions des étapes de lancement]( https://cloud.google.com/maps-platform/terms/launch-stages).

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de DataLayers.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

DataLayerView

Sous-ensemble des informations solaires à renvoyer.

Enums
DATA_LAYER_VIEW_UNSPECIFIED Équivaut à FULL.
DSM_LAYER Obtenez le DSM uniquement.
IMAGERY_LAYERS Obtenez le DSM, le RVB et le masque.
IMAGERY_AND_ANNUAL_FLUX_LAYERS Obtenez le DSM, le RVB, le masque et le flux annuel.
IMAGERY_AND_ALL_FLUX_LAYERS Obtenez le DSM, le RGB, le masque, le flux annuel et le flux mensuel.
FULL_LAYERS Obtenez toutes les données.