El extremo dataLayers devuelve datos codificados como archivos GeoTIFF, que pueden utilizarse en cualquier ubicación geográfica, aplicación de sistemas de información (GIS) de Google para diseñar sistemas solares.
Cada cadena de la respuesta dataLayers contiene una URL, que puedes usar para recuperar el GeoTIFF correspondiente. Las URL son válidas hasta una hora después se generan a partir de la solicitud original de capas de datos. Los archivos GeoTIFF se pueden almacenados por hasta 30 días.
Con la excepción de la capa RGB, los archivos GeoTIFF no se muestran correctamente con un visor de imágenes, ya que el contenido es datos codificados en lugar de imágenes RGB. GeoTIFF Estos archivos tampoco se pueden usar directamente como imagen superpuesta con la API de Maps JavaScript.
En la siguiente tabla, se describe cada capa en detalle.
| Capa | Profundidad de píxeles | Solució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 terrestre, incluidas las características naturales y de construcción. 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 como −9,999. |
| 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 correspondientes a los valores rojo, verde y azul para formar
Es un valor RGB de 24 bits para cada píxel. De forma predeterminada, se usa 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 | Uno por píxel, que indica si ese píxel se considera parte de un techo. |
| 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 para con solo construir tejados. Ubicaciones no válidas o áreas en las que no pudimos calcular el flujo, se almacenan como -9999. Ubicaciones fuera de nuestra área de cobertura no son válidos. Nota: Este es un flujo sin enmascarar. |
| Flujo mensual | Número de punto flotante de 32 bits | 0.5 m/píxel | Mapa de flujo mensual (luz solar en techos desglosada por mes) del región. Los valores son kWh/kW/año. El archivo de imágenes GeoTIFF contiene 12 bandas correspondientes a enero a diciembre, en orden. |
| Sombra por hora | Número entero de 32 bits | 1 m/píxel | 12 URL para mapas de sombras por hora correspondientes a enero a diciembre de
en el orden personalizado. Cada archivo GeoTIFF contiene 24 bandas, que corresponden al las 24 horas del día. Cada píxel es un entero de 32 bits, que corresponde al hasta 31 días de ese mes. Un bit de 1 bit significa que el valor correspondiente puede ver el sol ese día, a esa hora y en ese mes. Las ubicaciones no válidas se almacenan como -9999 y tienen el bit 31 configurado, como que corresponde al día 32 del mes y, por lo tanto, no es válido. |
Decodifica tramas de sombras por hora
Los datos de sombra por hora se codifican en tramas multibanda. Para obtener más información sobre la trama consulta Conceptos de la API de Solar.
Cuando solicitas datos de sombra por hora, puedes recibir hasta 12 tramas, una para cada mes del año calendario (de enero a diciembre). Cada trama consta de 24 capas, o bandas, que corresponden a las 24 horas de la día.
Cada banda se representa mediante una matriz de celdas o píxeles. Cada píxel tiene un de 32 bits, que corresponden a los 31 días (máximos) del mes. Por lo tanto, decodificar el día, la hora y el mes de los datos de sombras requiere entender el bit, la banda y la trama que estás analizando.
Por ejemplo, para identificar si una determinada ubicación en las coordenadas (x, y) vio el el domingo a las 4:00 p.m. el 22 de junio, haz lo siguiente:
- Permite realizar una solicitud de capas de datos para todas las capas relacionadas con la ubicación (x, y).
- Como el mes de junio es el sexto mes del año, recupera el sexto.
URL en la lista
hourlyShadeUrls. - Las bandas por hora se muestran en formato de 24 horas. Para obtener datos de las 4:00 p.m. (16:00), busca el canal 17.
- Índice de bits (días) de 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, el lugar vio sombra.
En el siguiente código, se resumen los pasos anteriores:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))