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 extrait. 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'ombre horaire sont à 1 m/pixel. Si une valeur pixelSizeMeters a été spécifiée dans le GetDataLayersRequest, la résolution minimale dans les 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 est nécessairement quelque peu approximatif, 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 DSM (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 (niveau de la mer). Les emplacements non valides (pour lesquels nous ne disposons pas de données) sont stockés sous la valeur -9999.
rgbUrl

string

URL d'une image des 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 du flux annuel (ensoleillement annuel sur les toits) de la région. Les valeurs sont exprimées en kWh/kW/an. Il s'agit du 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 valeur -9999. Les zones géographiques situées en dehors de notre zone de couverture ne sont pas valides, et certaines zones situées dans la zone de couverture pour lesquelles nous n'avons pas pu calculer le flux ne sont pas valides non plus.
monthlyFluxUrl

string

URL de la carte mensuelle du flux (soleil sur les toits, ventilé par mois) de la région. Les valeurs sont exprimées en kWh/kW/an. Le fichier GeoTIFF pointé par cette URL contiendra douze bandes, correspondant à janvier, février, mars, etc., dans l'ordre.
hourlyShadeUrls[]

string

Douze URL pour l'ombre horaire, correspondant à janvier, février, etc., dans l'ordre. Chaque GeoTIFF contient 24 bandes, correspondant aux 24 heures de la journée. Chaque pixel est un entier de 32 bits, correspondant aux 31 jours (maximum) de ce mois. Un bit 1 signifie que l'emplacement correspondant peut voir le soleil à ce jour, à cette heure et ce mois. Les emplacements non valides sont stockés sous la forme -9999 (étant donné qu'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 être utile. Si vous souhaitez savoir si un point (à l'emplacement du pixel (x, y)) a vu le soleil à 16h le 22 juin, procédez comme suit:

  1. récupérer la sixième URL de cette liste (correspondant à juin).
  2. recherchez la 17e chaîne (correspondant à 16h).
  3. lire la valeur de 32 bits à (x, y).
  4. lire le bit 21 de la valeur (correspondant au 22 du mois).
  5. Si ce bit est un 1, cela signifie que le soleil a brillé à 16h le 22 juin.

Plus formellement: étant donné month (1 à 12), day (1 … mois maximum ; février compte 28 jours) et hour (0 à 23), l'ombre/le soleil pour ce mois/ce jour/cette heure à la 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] à la récupération de l'month - 1re URL (indexation à partir de zéro), [hour] à l'indexation dans les canaux et un résultat final non nul à "ensoleillé". Il n'y a pas de jours bissextiles et l'heure d'été n'existe pas (tous les jours durent 24 heures et midi correspond toujours à l'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. Il peut s'agir de 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 pour spécifier une année sans mois ni jour.
day

integer

Jour d'un mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 pour spécifier 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 un résultat de l'API.

Remarque: Quelle que soit la 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'ombres horaires ont toujours une résolution de 1 m/pixel.

Enums
IMAGERY_QUALITY_UNSPECIFIED Aucune qualité n'est connue.
HIGH Les données solaires sont dérivées d'images aériennes capturées à basse altitude et traitées à 0,1 m/pixel.
MEDIUM Les données solaires sont dérivées d'images aériennes améliorées capturées à haute altitude et traitées à 0,25 m/pixel.
LOW Les données solaires sont dérivées d'images satellite améliorées traitées à 0,25 m/pixel.

Méthodes

get

 Récupère des informations sur l'ensoleillement pour une région entourant un emplacement.