REST Resource: dataLayers

Recurso: DataLayers

Es información sobre el potencial solar de una región. Los datos reales se encuentran en varios archivos GeoTIFF que abarcan la región solicitada, para los que este mensaje contiene URLs: Cada cadena del mensaje DataLayers contiene una URL desde la que se puede recuperar el archivo GeoTIFF correspondiente. Estas URLs son válidas durante algunas horas después de que se generan. La mayoría de los archivos GeoTIFF tienen una resolución de 0.1 m/píxel, pero el archivo de flujo mensual tiene una resolución de 0.5 m/píxel y los archivos de sombra por hora tienen una resolución de 1 m/píxel. Si se especificó un valor de pixelSizeMeters en el GetDataLayersRequest, la resolución mínima en los archivos GeoTIFF será ese valor.

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

object (Date)

Fecha en la que se tomaron las imágenes fuente (de las que se derivan todos los demás datos) en esta región. Es necesariamente aproximada, ya que las imágenes pueden haberse tomado en más de un día.
imageryProcessedDate

object (Date)

Indica cuándo se completó el procesamiento de estas imágenes.
dsmUrl

string

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

string

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

string

Es la URL de la imagen de máscara de edificios: un bit por píxel que indica si ese píxel se considera parte de un techo o no.
annualFluxUrl

string

Es la URL del mapa de flujo anual (luz solar anual en los techos) de la región. Los valores son kWh/kW/año. Se trata del flujo sin máscara: El flujo se calcula para cada ubicación, no solo para los techos de los 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, en las que no pudimos calcular el flujo, tampoco serán válidas.
monthlyFluxUrl

string

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

string

Doce URLs de sombra por hora, correspondientes a enero…diciembre, en orden. Cada GeoTIFF contendrá 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 (hasta) 31 días de ese mes. Un bit 1 significa que la ubicación correspondiente puede ver el sol en ese día, a esa hora y en ese mes. Las ubicaciones no válidas se almacenan como -9999 (como este valor es negativo, tiene el bit 31 establecido y ningún valor válido podría tener el bit 31 establecido, ya que eso correspondería al día 32 del mes).

Un ejemplo puede ser útil. Si quieres saber si un punto (en la ubicación del píxel [x, y]) recibió luz solar a las 4 pm del 22 de junio, debes hacer lo siguiente:

  1. Recupera la sexta URL de esta lista (que corresponde a junio).
  2. buscar el canal 17 (que corresponde a las 4 p.m.)
  3. leer 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, significa que ese punto vio el sol a las 4 p.m. del 22 de junio.

De manera más formal, dados month (1 a 12), day (1 a la cantidad máxima de días del mes; febrero tiene 28 días) y hour (0 a 23), la sombra o el sol para ese mes, día y hora en una posición (x, y) son los bits

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

donde (x, y) es la indexación espacial, [month - 1] hace referencia a la recuperación de la URL month - 1 (indexación desde cero), [hour] es la indexación en los canales y un resultado final distinto de cero significa "soleado". No hay días bisiestos ni horario de verano (todos los días duran 24 horas; el mediodía siempre es el mediodía del "horario estándar").
imageryQuality

enum (ImageryQuality)

Calidad de las imágenes del resultado.

Fecha

Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:

  • Una fecha completa con valores para el año, mes y día que no sean cero.
  • Un mes y un día, con cero año (por ejemplo, un aniversario).
  • Un año por sí solo, con un mes cero y un día cero.
  • Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).

Tipos relacionados:

Representación JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año.
month

integer

Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día.
day

integer

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

ImageryQuality

Calidad de las imágenes utilizadas para calcular algunos resultados de la API.

Nota: Independientemente del nivel de calidad de las imágenes, los resultados del DSM siempre tienen una resolución de 0.1 m/píxel, los resultados del flujo mensual siempre tienen una resolución de 0.5 m/píxel y los resultados de la sombra por hora siempre tienen una resolución de 1 m/píxel.

Enumeraciones
IMAGERY_QUALITY_UNSPECIFIED No se conoce la calidad.
HIGH Los datos solares se obtienen de imágenes aéreas capturadas a baja altitud y se procesan a 0.1 m/píxel.
MEDIUM Los datos solares se obtienen de imágenes aéreas mejoradas capturadas a gran altitud y procesadas a 0.25 m/píxel.
BASE Los datos solares se obtienen de imágenes satelitales mejoradas que se procesan a 0.25 m/píxel.

Métodos

get

 Obtiene información sobre la energía solar de una región que rodea una ubicación.