Le point de terminaison dataLayers renvoie des données encodées au format GeoTIFF, utilisables dans n'importe quelle zone géographique une application SIG (système d'information) pour concevoir des systèmes solaires.
Chaque chaîne de la réponse dataLayers contient une URL, que vous pouvez pour récupérer le fichier GeoTIFF correspondant. Les URL sont valides pendant une durée maximale d'une heure après elles sont générées à partir de la requête d'origine des couches de données. Les fichiers GeoTIFF peuvent être et les stocker pendant 30 jours.
À l'exception du calque RVB, les fichiers GeoTIFF ne s'affichent pas correctement avec un lecteur d'images, car le contenu est encodé des données et non des images RVB. 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 | des données d'altitude qui représentent la topographie de la surface de la Terre ; y compris les caractéristiques naturelles et construites. Les valeurs sont exprimées en mètres au-dessus de la mer d'application. Les lieux non valides ou ceux pour lesquels 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 image GeoTIFF contient
trois bandes correspondant aux valeurs rouge, vert et bleu afin de former
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 le pixel est considéré comme une 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 zone géographique, et non pour à construire des toits. Emplacements incorrects ou zones où nous n'avons pas pu calculent le flux, sont stockés sous la forme -9999. Lieux en dehors de nos zone de couverture ne sont pas valides. Remarque:Ce flux n'est pas masqué. |
| Flux mensuel | Flottant 32 bits | 0,5 m/pixel | Carte de flux mensuelle (lumière du soleil sur les toits, décomposée par mois) des dans la même 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. |
| Ombre par heure | Entier 32 bits | 1 m/pixel | 12 URL de cartes de nuanceurs horaires correspondant à la période de janvier à décembre, au
commande. Chaque fichier GeoTIFF contient 24 bandes correspondant à l'élément 24 heures de la journée. Chaque pixel est un entier de 32 bits, correspondant à (jusqu'à) 31 jours du mois en question. 1 bit signifie que le lieu peut voir le soleil ce jour-là, à cette heure-là et au cours du mois en question. Les emplacements non valides sont stockés sous la forme -9999 et le bit 31 est défini, car qui correspond au 32e jour du mois et 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 trames de base, 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 du jour.
Chaque bande est représentée par une matrice de cellules, ou pixels. Chaque pixel a une de 32 bits, ce qui correspond aux 31 jours (maximum) du mois. Décoder le jour, l'heure et le mois des données de nuance 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 la dimanche à 16h00 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).
- Puisque le mois de juin est le sixième mois de l'année, récupérez le sixième
URL dans la liste
hourlyShadeUrls. - Les bandes horaires sont fournies au format 24 heures. Pour obtenir des données concernant 16:00 (16:00), recherchez la 17e chaîne.
- 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 au à la date et à l'heure indiquées. Si le bit est égal à 1, la position a vu le soleil. Si le bit est 0, le lieu a vu l'ombre.
Le code suivant résume les étapes ci-dessus:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))