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 GeoTIFF correspondant. Les URL sont valides jusqu'à une heure après avoir été générées à partir de la requête initiale de couches de données. Les fichiers GeoTIFF peuvent être stockés jusqu'à 30 jours.
À l'exception de la couche RVB, les fichiers GeoTIFF ne s'affichent pas correctement avec une visionneuse d'images, car le contenu est encodé au lieu d'images RVB. Les fichiers GeoTIFF ne peuvent pas non plus être utilisés directement comme image de superposition avec l'API Maps JavaScript.
Le tableau suivant décrit chaque couche en détail.
| intégrée | Profondeur en pixels | Solution | Description |
|---|---|---|---|
| Modèle numérique de surface (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 zones non valides ou pour lesquelles nous ne disposons pas de données sont stockées 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, vert et bleu afin de 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 lumière annuelle sur les toits, de la région.
Les valeurs sont exprimées en kWh/kW/an. Flux est calculé pour chaque site, et pas uniquement pour les toitures 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 forme -9999. Les emplacements situés en dehors de notre zone de couverture ne sont pas valides. Remarque:Ce flux n'est pas masqué. |
| Flux mensuel | Flottant 32 bits | 0,5 m/pixel | Carte des flux mensuels (ensoleillement sur les toits, décomposé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 et décembre, dans l'ordre. |
| Ombre par heure | Entier 32 bits | 1 m/pixel | 12 URL pour les cartes de teintes par heure correspondant à la période de 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 de 32 bits correspondant aux 31 jours (maximum) de ce mois. La valeur 1 bit signifie que le lieu correspondant peut voir le soleil ce jour-là, à cette heure-là et ce mois-là. 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. Il n'est donc pas valide. |
Décoder les trames de nuance toutes les heures
Les données de nuance horaires sont encodées au moyen de trames multibandes. Pour en savoir plus sur les principes de base des trames, consultez la page Concepts de l'API Solar.
Lorsque vous demandez des données de teintes par heure, 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. Pour décoder le jour, l'heure et le mois des données de nuance, vous devez donc 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 couches de données pour tous les calques de l'emplacement (x, y).
- Étant donné que 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 fournies au format 24 heures. Pour obtenir des données pour 16h00, recherchez le 17ème canal.
- Index des bits (jours) à partir de 0. Pour obtenir des données pour le 22e jour de 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 égal à 1, la position a vu le soleil. Si le bit est 0, l'emplacement voit l'ombre.
Le code suivant résume les étapes ci-dessus:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))