REST Resource: dataLayers

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

object (Date)

Cuándo se tomaron las imágenes de origen (de las que se derivan todos los demás datos) de esta región. Es necesariamente aproximada, ya que las imágenes pueden haberse tomado durante más de un día.

object (Date)

Cuándo se completó el procesamiento de estas imágenes.

string

URL de una imagen del DSM (modelo de superficie digital) de la región. Los valores se expresan en metros sobre el geoide EGM96 (es decir, el nivel del mar). Las ubicaciones no válidas (donde no tenemos datos) se almacenan como -9999.

string

La URL de una imagen de datos RGB (foto aérea) de la región.

string

La URL de la imagen de la máscara del edificio: un bit por píxel que indica si ese píxel se considera parte de una azotea o no.

string

URL del mapa de flujo anual (luz anual en los techos) de la región. Los valores son kWh/kW/año. Esto es un flujo sin enmascarar: el flujo se calcula para cada ubicación, no solo para azoteas de edificios. Las ubicaciones no válidas se almacenan como -9999: las ubicaciones fuera de nuestra área de cobertura no serán válidas, y algunas ubicaciones dentro del área de cobertura, donde no pudimos calcular el flujo, tampoco lo estarán.

string

La URL del mapa de flujo mensual (luz solar en los techos, desglosado por mes) de la región. Los valores son kWh/kW/año. El GeoTIFF al que apunta esta URL contendrá doce bandas, que corresponden a enero a diciembre, en orden.

string

Doce URLs para el tono por hora, que corresponden a enero a diciembre, en orden. Cada GeoTIFF contendrá 24 bandas, correspondientes 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, en esa hora, de ese mes. Las ubicaciones no válidas se almacenan como -9999 (dado que esto es negativo, tiene configurado el bit 31, y ningún valor válido podría tener configurado el bit 31, ya que correspondería al día 32 del mes).

Un ejemplo podría ser útil. Si deseas saber si un punto (en la ubicación de píxeles (x, y)) vio sol a las 4 p.m. el 22 de junio, harías lo siguiente:

1. recupera la sexta URL de esta lista (correspondiente a junio).
2. busca el canal número 17 (correspondiente a las 4:00 p.m.).
3. lee el valor de 32 bits en (x, y).
4. lee el bit 21 del valor (correspondiente al día 22 del mes).
5. si ese bit es un 1, entonces ese punto vio el sol a las 4 p.m. el 22 de junio.

Más formalmente: dado month (1-12), day (1...mes como máximo; febrero tiene 28 días) y hour (0-23), el tono/sol de ese mes/día/hora en una posición (x, y) es el bit

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

donde (x, y) es la indexación espacial, [month - 1] se refiere a recuperar la month - 1st URL (indexación desde cero), [hour] se indexa en los canales y un resultado final distinto de cero significa "soleado". No hay días bisiestos y el DST no existe (todos los días tienen una duración de 24 horas; el mediodía es siempre el mediodía "hora estándar").

enum (ImageryQuality)

La calidad de las imágenes del resultado

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Año de la fecha. Debe encontrarse entre 1 y 9999, o bien entre 0 para especificar una fecha sin año.

integer

Mes del año Debe encontrarse entre 1 y 12, o bien 0 para especificar un año sin mes ni día.

integer

Día del mes. Debe encontrarse entre 1 y 31 y ser válido para el año y el mes, o bien 0 para especificar solo un año o un año y mes en los que el día no sea importante.