Le point de terminaison dataLayers renvoie des données encodées en tant que fichiers GeoTIFF, qui peuvent être utilisées dans n'importe quelle application de système d'information géographique (SIG) pour concevoir des systèmes solaires.
Chaque chaîne de la réponse dataLayers contient une URL, que vous pouvez utiliser pour extraire le GeoTIFF correspondant. Les URL sont valides pendant une heure maximum après avoir été générées à partir de la requête d'origine des calques de données. Les fichiers GeoTIFF peuvent être stockés pendant 30 jours maximum.
À l'exception de la couche RVB, les fichiers GeoTIFF ne s'affichent pas correctement avec un visionneuse d'images, car le contenu est constitué de données encodées plutôt que d'images RVB. Les fichiers GeoTIFF ne peuvent pas non plus être utilisés directement comme image superposée avec l'API Maps JavaScript.
Le tableau suivant décrit chaque couche en détail.
| intégrée | Profondeur de pixel | Solution | Description |
|---|---|---|---|
| Modèle de surface numérique (DSM) | Float 32 bits | 0,1 m/pixel | Données d'altitude représentant la topographie de la surface de la Terre, y compris les éléments naturels et construits. Les valeurs sont exprimées en mètres au-dessus du niveau de la mer. Les emplacements non valides ou les zones pour lesquelles nous ne disposons pas de données sont stockés sous la forme -9999. |
| RVB | 8 bits | 0,1 m/pixel 0,25 m/pixel 0,5 m/pixel 1 m/pixel |
Image aérienne de la région. Le fichier d'imagerie GeoTIFF contient trois bandes correspondant aux valeurs rouge, vert et bleu afin de former une valeur RVB de 24 bits pour chaque pixel. Par défaut, la résolution par pixel est de 0,1 m/pixel. |
| Masque de bâtiment | 1 bit | 0,1 m/pixel | Un bit par pixel indiquant si ce pixel est considéré comme faisant partie d'un toit. |
| Flux annuel | Float 32 bits | 0,1 m/pixel | Carte du flux annuel (ensoleillement annuel sur les toits) de la région.
Les valeurs sont exprimées en kWh/kW/an. Le flux est calculé pour chaque emplacement, et pas seulement pour les toits des bâtiments. Les emplacements non valides ou les zones pour lesquelles nous n'avons pas pu calculer le flux sont stockés sous la valeur -9999. Les lieux situés en dehors de notre zone de couverture ne sont pas valides. Remarque:Il s'agit d'un flux non masqué. |
| Flux mensuel | Float 32 bits | 0,5 m/pixel | 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 d'images GeoTIFF contient 12 bandes correspondant à janvier à décembre, dans l'ordre. |
| Ombrage horaire | Entier 32 bits | 1 m/pixel | 12 URL pour les cartes d'ombre horaire correspondant à janvier à décembre, dans l'ordre. Chaque fichier GeoTIFF contient 24 bandes, correspondant aux 24 heures de la journée. Chaque pixel est un entier 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, ce mois. Les emplacements non valides sont stockés sous la forme -9999 et le bit 31 est défini, car il correspond au 32e jour du mois et est donc non valide. |
Décoder les rasters d'ombre toutes les heures
Les données d'ombre horaire sont encodées dans des rasters multibandes. Pour en savoir plus sur les principes de base des rasters, consultez la section Concepts de l'API Solar.
Lorsque vous demandez des données d'ombre horaire, vous pouvez recevoir jusqu'à 12 rasters, un pour chaque mois de l'année civile (de janvier à décembre). Chaque raster est composé de 24 couches ou bandes, qui correspondent aux 24 heures de la journée.
Chaque bande est représentée par une matrice de cellules, ou pixels. Chaque pixel a une profondeur de 32 bits, qui correspond aux 31 jours (maximum) du mois. Pour décoder le jour, l'heure et le mois des données d'ombre, vous devez donc comprendre le bit, la bande et le raster que vous analysez.
Par exemple, pour déterminer si un emplacement donné aux coordonnées (x, y) a vu le soleil à 16h00 le 22 juin, procédez comme suit :
- Envoyez une requête de calques de données pour toutes les couches pour la position (x, y).
- Comme le mois de juin est le sixième mois de l'année, récupérez la sixième URL de la liste
hourlyShadeUrls. - Les plages horaires sont indiquées au format 24 heures. Pour obtenir les données de 16h00, recherchez le 17e canal.
- Index des bits (jours) à partir de 0. Pour obtenir les données du 22 juin, lisez le bit 21.
- Les bits fournissent des données binaires indiquant si cet emplacement a vu le soleil à la date et à l'heure données. Si le bit est défini sur 1, l'emplacement a vu le soleil. Si le bit est à 0, la zone a été ombragée.
Le code suivant récapitule les étapes ci-dessus:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))