REST Resource: dataLayers

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

object (Date)

Date à laquelle les images sources (d'où proviennent toutes les autres données) de cette région ont été prises. Elle est nécessairement assez approximative, car les images peuvent avoir été prises plus d'une journée.

object (Date)

Lorsque le traitement de ces images s'est terminé.

string

URL d'une image du modèle de surface numérique (DSM) de la région. Les valeurs sont exprimées en mètres au-dessus du géoïde EGM96 (au niveau de la mer). Les emplacements incorrects (lorsque nous ne disposons pas de données) sont stockés sous la forme -9999.

string

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

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.

string

URL de la carte des flux annuels (ensoleillement annuel sur les 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 lieu, et pas seulement pour les toits. Les lieux non valides sont stockés sous la forme -9999: les lieux situés en dehors de notre zone de couverture ne sont pas valides. De même, quelques lieux dans lesquels nous n'avons pas pu calculer le flux ne sont pas valides.

string

URL de la carte des flux mensuels (la lumière du soleil sur les toits, ventilées par mois) de la région. Les valeurs sont exprimées en kWh/kW/an. Le GeoTIFF pointe vers cette URL contiendra douze bandes, correspondant à janvier et décembre, dans l'ordre.

string

Douze URL pour l'ombre horaire, correspondant à janvier et décembre, dans l'ordre. Chaque GeoTIFF contient 24 bandes, correspondant aux 24 heures de la journée. Chaque pixel est un nombre entier de 32 bits qui correspond aux 31 jours (jusqu'à) du mois en question. 1 bit signifie que le lieu correspondant peut voir le soleil ce jour-là, à cette heure-là, du mois en question. Les emplacements non valides sont stockés sous la forme -9999 (puisqu'il s'agit d'une valeur 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 vous être utile. Pour savoir si un point (à l'emplacement des pixels (x, y)) a vu le soleil le 22 juin à 16h, procédez comme suit:

1. extraire la sixième URL de cette liste (correspondant à juin).
2. recherchez la 17e chaîne (correspondant à 16h).
3. lire la valeur 32 bits en (x, y).
4. lire le bit 21 de la valeur (correspondant au 22 du mois).
5. si ce bit est un 1, alors ce spot a vu le soleil à 16 h 00 le 22 juin.

Plus formellement: avec month (1-12), day (1...mois maximum ; février compte 28 jours) et hour (0-23), la nuance/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 - 1re URL (indexée à partir de zéro), [hour] à l'indexation dans les chaînes et un résultat final différent de zéro signifie "ensoleillé". Il n'y a pas de jour intercalaire ni d'heure d'été (tous les jours durent 24 heures, midi correspond toujours à midi, à l'heure normale).

enum (ImageryQuality)

La qualité des images obtenues dans les résultats.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Année de la date. La valeur doit être comprise entre 1 et 9999, ou égale à 0 pour indiquer une date sans année.

integer

Mois de l'année. La valeur doit être comprise entre 1 et 12, ou 0 pour indiquer une année sans mois ni jour.

integer

Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou la valeur 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif.