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 GeoTIFF correspondant peut être extrait. Une fois générées, ces URL restent valides quelques heures plus tard. 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 de teinte par heure sont à 1 m/pixel. Si une valeur pixelSizeMeters a été spécifiée dans le fichier 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) ont été prises pour cette région. Il est nécessairement relativement approximatif, car les images peuvent avoir été prises pendant plus d'une journée.
imageryProcessedDate

object (Date)

Date de fin du traitement de ces images.
dsmUrl

string

URL d'une image du DSM (Digital Surface Model) de la région. Les valeurs sont exprimées en mètres au-dessus du géoïde EGM96 (c'est-à-dire le 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 contenant 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 de flux annuel (lumière solaire annuelle sur les toits) de la région. Les valeurs sont exprimées en kWh/kW/an. Il s'agit d'un flux non masqué: il est calculé pour chaque lieu, et pas seulement pour les toits des bâtiments. Les emplacements non valides sont stockés sous la forme -9999: les lieux situés en dehors de notre zone de couverture ne seront pas valides, et quelques emplacements situés au sein de cette zone, pour lesquels nous n'avons pas pu calculer le flux, seront également incorrects.
monthlyFluxUrl

string

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

string

Douze URL pour les teintes toutes les heures, correspondant aux mois de janvier et décembre, 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. 1 bit signifie que le lieu correspondant peut voir le soleil à ce jour, à cette heure et au cours du mois en question. Les emplacements non valides sont stockés sous la forme -9999 (puisque 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, ce qui correspondrait au 32e jour du mois).

Un exemple peut vous être utile. Pour savoir si un point (au niveau de l'emplacement des pixels (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. rechercher la 17e chaîne (correspondant à 16 h).
  3. lire la valeur 32 bits à (x, y).
  4. le bit 21 de la valeur (correspondant au 22 du mois).
  5. si ce bit est un 1, alors ce point a vu le soleil à 16h 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 à 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] fait référence à la récupération de la month - 1première URL (indexation à partir de zéro), [hour] à l'indexation dans les canaux et un résultat final différent de zéro signifie "soleil". Il n'y a pas de jours intercalaires et il n'existe pas d'heure d'été (toutes les journées durent 24 heures ; midi correspond toujours à "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 zéro.
  • 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. Doit être comprise entre 1 et 9999, ou 0 pour indiquer une date sans année.
month

integer

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

integer

Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou 0 pour indiquer 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 d'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 mensuelles de 0,5 m/pixel et les couleurs de teinte générées par heure de 1 m/pixel.

Enums
IMAGERY_QUALITY_UNSPECIFIED Aucune qualité n'est connue.
HIGH Les images sous-jacentes et les données DSM ont été traitées à 0,1 m/pixel.
MEDIUM Les images sous-jacentes et les données DSM ont été traitées à 0,25 m/pixel.
LOW Les images sous-jacentes et les données DSM ont été traitées à 0,5 m/pixel.

Méthodes

get

 Obtient des informations sur l'ensoleillement d'une région autour d'un lieu.