El extremo dataLayers muestra datos codificados como archivos GeoTIFF, que se pueden usar en cualquier aplicación de sistema de información geográfica (GIS) para diseñar sistemas solares.
Cada string en la respuesta de dataLayers contiene una URL que puedes usar para recuperar el GeoTIFF correspondiente. Las URLs son válidas hasta una hora después de que se generan a partir de la solicitud original de las capas de datos. Los archivos GeoTIFF se pueden almacenar por hasta 30 días.
A excepción de la capa RGB, los archivos GeoTIFF no se muestran correctamente con un visor de imágenes, ya que el contenido está codificado como datos en lugar de imágenes RGB. Los archivos GeoTIFF tampoco se pueden usar directamente como una imagen superpuesta con la API de Maps JavaScript.
En la siguiente tabla, se describe cada capa en detalle.
| de pesos | Profundidad en píxeles | Resolución | Descripción |
|---|---|---|---|
| Modelo de superficie digital (DSM) | Número de punto flotante de 32 bits | 0.1 m/píxel | Datos de elevación que representan la topografía de la superficie de la Tierra, incluidos elementos naturales y construidos. Los valores se indican en metros sobre el nivel del mar. Las ubicaciones no válidas o las áreas donde no tenemos datos se almacenan con -9999. |
| RGB | De 8 bits | 0.1 m/píxel 0.25 m/píxel 0.5 m/píxel 1 m/píxel |
Imagen aérea de la región. El archivo de imágenes GeoTIFF contiene tres bandas que corresponden a los valores rojo, verde y azul para formar un valor RGB de 24 bits para cada píxel. De forma predeterminada, la resolución de píxeles es de 0.1 m/píxel. |
| Máscara de construcción | 1 bit | 0.1 m/píxel | Un bit por píxel que indica si se considera que ese píxel forma parte de una azotea. |
| Flujo anual | Número de punto flotante de 32 bits | 0.1 m/píxel | El mapa de flujo anual, o luz solar anual en los techos, de la región.
Los valores son kWh/kW/año. El flujo se calcula para cada ubicación, no solo para las azoteas de edificios. Las ubicaciones no válidas o las áreas en las que no pudimos calcular el flujo se almacenan con -9999. Las ubicaciones fuera de nuestra área de cobertura no son válidas. Nota: Esto es un flujo sin enmascarar. |
| Flujo mensual | Número de punto flotante de 32 bits | 0.5 m/píxel | El mapa de flujo mensual (luz del sol en los techos, desglosado por mes) de la región. Los valores son kWh/kW/año. El archivo de imagen GeoTIFF contiene 12 bandas que corresponden a enero a diciembre, en orden. |
| Tono por hora | Número entero de 32 bits | 1 m/píxel | 12 URLs para mapas de sombreados por hora correspondientes a enero y diciembre, en orden Cada archivo GeoTIFF contiene 24 bandas que corresponden a las 24 horas del día. Cada píxel es un número entero de 32 bits que corresponde a los 31 días (hasta) de ese mes. Un bit 1 significa que la ubicación correspondiente puede ver el sol en ese día, a esa hora, en ese mes. Las ubicaciones no válidas se almacenan como -9999 y tienen configurado el bit 31, ya que corresponde al día 32 del mes y, por lo tanto, no es válido. |
Decodifica las tramas de sombra por hora
Los datos de sombreado por hora se codifican en tramas multibanda. Para obtener más información sobre los conceptos básicos de las tramas, consulta los Conceptos de la API de Solar.
Cuando solicitas datos de tonos por hora, puedes recibir hasta 12 tramas, una por cada mes del año calendario (de enero a diciembre). Cada trama está compuesta por 24 capas, o bandas, que corresponden a las 24 horas del día.
Cada banda está representada por una matriz de celdas o píxeles. Cada píxel tiene una profundidad de 32 bits, que corresponden a los 31 días (máximo) del mes. Por lo tanto, para decodificar el día, la hora y el mes de los datos del sombreado, es necesario comprender el bit, la banda y la trama que estás analizando.
Por ejemplo, para identificar si una ubicación determinada en las coordenadas (x, y) vio el sol a las 4:00 p.m. del 22 de junio, haz lo siguiente:
- Realiza una solicitud de capas de datos para todas las capas para la ubicación (x, y).
- Como junio es el sexto mes del año, recupera la sexta URL de la lista
hourlyShadeUrls. - Las bandas por hora se proporcionan en el formato de 24 horas. Para obtener los datos de las 4:00 p.m. (16:00), busca el canal 17.
- Índice de bits (días) desde 0. Para obtener datos del día 22 de junio, lee el bit 21.
- Los bits proporcionan datos binarios que indican si esa ubicación vio sol en la fecha y hora determinadas. Si el bit es 1, la ubicación vio sol. Si el bit es 0, la ubicación muestra la sombra.
En el siguiente código, se resumen los pasos anteriores:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))