REST Resource: dataLayers

Ressource : DataLayers

Informations sur le potentiel solaire d'une région. Les données réelles sont contenues dans un certain nombre de fichiers GeoTIFF couvrant la région demandée, pour lesquels ce message contient des URL : chaque chaîne du message DataLayers contient une URL à partir de laquelle le fichier GeoTIFF correspondant peut être récupéré. Ces URL sont valides pendant quelques heures après leur génération. La plupart des fichiers GeoTIFF ont une résolution de 0,1 m/pixel, mais le fichier de flux mensuel est à 0,5 m/pixel et les fichiers d'ombrage horaire sont à 1 m/pixel. Si une valeur pixelSizeMeters a été spécifiée dans le fichier GetDataLayersRequest, la résolution minimale des fichiers GeoTIFF sera cette valeur.

Représentation JSON 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
Champs
imageryDate

object (Date)

Date à laquelle les images sources (à partir desquelles toutes les autres données sont dérivées) de cette région ont été prises. Il s'agit nécessairement d'une approximation, car les images peuvent avoir été prises sur plusieurs jours.
imageryProcessedDate

object (Date)

Date à laquelle le traitement de ces images a été terminé.
dsmUrl

string

URL d'une image du MNS (modèle numérique de surface) de la région. Les valeurs sont exprimées en mètres au-dessus du géoïde EGM96 (c'est-à-dire au niveau de la mer). Les emplacements non valides (pour lesquels nous ne disposons pas de données) sont stockés sous la forme -9999.
rgbUrl

string

URL d'une image de données RVB (photo aérienne) de la région.
maskUrl

string

URL de l'image du masque de bâtiment : un bit par pixel indiquant si ce pixel est considéré comme faisant partie d'un toit ou non.
annualFluxUrl

string

URL de la carte de flux annuel (ensoleillement annuel des toits) de la région. Les valeurs sont exprimées en kWh/kW/an. Il s'agit d'un flux non masqué : le flux est calculé pour chaque emplacement, et pas seulement pour les toits des bâtiments. Les zones géographiques non valides sont stockées sous la forme -9999. Les zones géographiques en dehors de notre zone de couverture seront non valides, tout comme certaines zones géographiques à l'intérieur de la zone de couverture pour lesquelles nous n'avons pas pu calculer le flux.
monthlyFluxUrl

string

URL de la carte du flux mensuel (lumière du soleil sur les toits, ventilée par mois) de la région. Les valeurs sont exprimées en kWh/kW/an. Le fichier GeoTIFF indiqué par cette URL contiendra douze bandes, correspondant aux mois de janvier à décembre, dans l'ordre.
hourlyShadeUrls[]

string

Douze URL pour l'ombrage horaire, correspondant à janvier…décembre, dans l'ordre. Chaque fichier GeoTIFF contiendra 24 bandes, correspondant aux 24 heures de la journée. Chaque pixel est un entier de 32 bits, correspondant aux (jusqu'à) 31 jours de ce mois. Un bit 1 signifie que l'emplacement correspondant peut voir le soleil à ce jour, à cette heure et à ce mois. Les lieux non valides sont stockés sous la forme -9999 (puisque cette valeur est négative, le bit 31 est défini, et aucune valeur valide ne peut avoir le bit 31 défini, car cela correspondrait au 32e jour du mois).

Un exemple peut être utile. Si vous souhaitez savoir si un point (à l'emplacement du pixel (x, y)) a été ensoleillé à 16h le 22 juin, vous devez :

  1. récupérer la sixième URL de cette liste (correspondant à juin).
  2. rechercher le 17e canal (correspondant à 16h).
  3. lire la valeur 32 bits à (x, y).
  4. lire le bit 21 de la valeur (correspondant au 22e jour du mois).
  5. Si ce bit est défini sur 1, cela signifie que l'endroit a été ensoleillé le 22 juin à 16h.

Plus précisément : étant donné month (1-12), day (1...month max ; février compte 28 jours) et hour (0-23), l'ombre/le soleil pour ce mois/jour/heure à une position (x, y) est le bit

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

où (x, y) correspond à l'indexation spatiale, [month - 1] fait référence à la récupération de la month - 1e URL (indexation à partir de zéro), [hour] correspond à l'indexation dans les canaux, et un résultat final non nul signifie "ensoleillé". Il n'y a pas de jour bissextile et l'heure d'été n'existe pas (tous les jours durent 24 heures ; midi correspond toujours à midi en heure normale).
imageryQuality

enum (ImageryQuality)

Qualité des images du résultat.

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est donnée selon le calendrier grégorien. Elle peut être représentée par l'un des éléments suivants :

  • Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
  • Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
  • une année seule, avec un mois et un jour nuls ;
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés :

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Elle doit être comprise entre 1 et 9999, ou égale à 0 si vous spécifiez une date sans année.
month

integer

Mois d'une année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une année sans mois ni jour.
day

integer

Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez une année seule, ou une année et un mois où le jour n'est pas significatif.

ImageryQuality

Qualité des images utilisées pour calculer certains résultats de l'API.

Remarque : Quel que soit le niveau de qualité des images, les sorties DSM ont toujours une résolution de 0,1 m/pixel, les sorties de flux mensuels ont toujours une résolution de 0,5 m/pixel et les sorties d'ombre horaires ont toujours une résolution de 1 m/pixel.

Enums
IMAGERY_QUALITY_UNSPECIFIED La qualité est inconnue.
HIGH Les données solaires proviennent d'images aériennes capturées à basse altitude et traitées à 0,1 m/pixel.
MEDIUM Les données solaires proviennent d'images aériennes améliorées capturées à haute altitude et traitées à 0,25 m/pixel.
BASE Les données solaires proviennent d'images satellite améliorées traitées à 0,25 m/pixel.

Méthodes

get

 Obtient des informations sur l'ensoleillement pour une région entourant un emplacement.