Le point de terminaison dataLayers renvoie des données encodées sous forme de fichiers GeoTIFF, qui peuvent être utilisés dans toute application SIG (système d'information géographique) pour concevoir des systèmes solaires.
Chaque chaîne de la réponse dataLayers contient une URL que vous pouvez utiliser pour récupérer le fichier GeoTIFF correspondant. Les URL sont valides jusqu'à une heure après leur génération à partir de la requête de couches de données d'origine. Les fichiers GeoTIFF peuvent être stockés pendant 30 jours au maximum.
À l'exception de la couche RVB, les fichiers GeoTIFF ne s'affichent pas correctement avec une visionneuse d'images, car le contenu correspond à des données encodées et non à des images RVB. Les fichiers GeoTIFF ne peuvent pas non plus être utilisés directement en tant qu'image superposée avec l'API Maps JavaScript.
Le tableau suivant décrit chaque couche en détail.
| cachée | Profondeur en pixels | Solution | Description |
|---|---|---|---|
| Modèle de surface numérique (DSM) | Flottant 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 géographiques naturels et construits. Les valeurs sont exprimées en mètres au-dessus du niveau de la mer. Les lieux non valides, ou les zones où 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'image GeoTIFF contient trois bandes correspondant aux valeurs rouge, verte et bleue pour former une valeur RVB 24 bits pour chaque pixel. Par défaut, la résolution en pixels 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 | Flottant 32 bits | 0,1 m/pixel | Carte de flux annuel, ou ensoleillement annuel sur les toits, de la région.
Les valeurs sont exprimées en kWh/kW/an. Le flux est calculé pour chaque lieu, et pas uniquement pour la construction de toits. Les emplacements non valides, ou les zones où nous n'avons pas pu calculer le flux, sont stockés sous la forme -9 999. 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 | Flottant 32 bits | 0,5 m/pixel | La carte de flux mensuelle (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 fichier d'image GeoTIFF contient 12 bandes correspondant à la période allant de janvier à décembre, dans l'ordre. |
| Teinte par heure | Entier 32 bits | 1 m/pixel | 12 URL pour les mappages d'ombrage horaires correspondant à janvier et décembre, dans l'ordre. Chaque fichier GeoTIFF contient 24 bandes, correspondant aux 24 heures de la journée. Chaque pixel est un entier de 32 bits correspondant aux 31 jours (au maximum) du mois en question. 1 bit signifie que l'emplacement correspondant peut voir le soleil ce jour-là, à cette heure-là, au cours de ce mois. Les emplacements non valides sont stockés sous la forme -9999 et le bit 31 est défini, car cela correspond au 32e jour du mois et n'est donc pas valide. |
Décoder les trames de nuanceur horaires
Les données de nuance horaires sont encodées en trames multibandes. Pour en savoir plus sur les bases des trames, consultez la page Concepts de l'API Solar.
Lorsque vous effectuez une requête de données horaires sur les nuances, vous pouvez recevoir jusqu'à 12 rasters, un pour chaque mois de l'année civile (de janvier à décembre). Chaque trame est composée 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, ce qui correspond aux 31 jours (maximum) du mois. Par conséquent, décoder le jour, l'heure et le mois des données de nuance nécessite de comprendre le bit, la bande et la trame que vous analysez.
Par exemple, pour déterminer si un lieu donné aux coordonnées (x, y) a vu le soleil à 16h le 22 juin, procédez comme suit :
- Envoyez une requête de calques de données pour tous les calques de l'emplacement (x, y).
- Comme le mois de juin est le sixième mois de l'année, récupérez la sixième URL dans la liste
hourlyShadeUrls. - Les bandes horaires sont exprimées au format 24 heures. Pour obtenir les données de 16h (16h), recherchez le 17e canal.
- Index de 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 la valeur est égale à 1, cela signifie que l'emplacement a vu le soleil. Si le bit est 0, l'emplacement a vu ombre.
Le code suivant récapitule les étapes ci-dessus:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))