REST Resource: dataLayers

Recurso: DataLayers

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 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 0.5 m/píxel y los archivos de sombra por hora tienen 1 m/píxel. Si se especificó un valor pixelSizeMeters en 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)

Cuándo se tomaron las imágenes de origen (de las que se derivan todos los demás datos) en esta región. Es necesariamente un tanto aproximado, 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 se indican 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 la máscara del edificio: 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 techos) de la región. Los valores son kWh/kW/año. Este es el flujo sin enmascarar: 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 de la á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 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, correspondientes a enero, febrero, etc., en orden.
hourlyShadeUrls[]

string

Doce URLs para la sombra por hora, correspondientes 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 (hasta) 31 días de ese mes. Un bit de 1 significa que la ubicación correspondiente puede ver el sol en ese día, a esa hora, de ese mes. Las ubicaciones no válidas se almacenan como -9999 (como 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 de píxeles (x, y)) vio el sol a las 4 p.m. del 22 de junio, haz lo siguiente:

  1. recuperar la sexta URL de esta lista (que corresponde a junio).
  2. busca el canal 17 (que corresponde a las 4 p.m.).
  3. Lee el valor de 32 bits en (x, y).
  4. Lee el bit 21 del valor (que corresponde al día 22 del mes).
  5. Si ese bit es un 1, significa que ese lugar vio el sol a las 4 p.m. del 22 de junio.

De forma más formal: Dado month (1-12), day (1…mes máx.; febrero tiene 28 días) y hour (0-23), la sombra o el sol de ese mes, día o 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] hace referencia a la recuperación de la month - 1ª URL (indexación desde cero), [hour] indexa en los canales y un resultado final distinto de cero significa "soleada". No hay días intercalares y no existe el horario de verano (todos los días tienen 24 horas y el mediodía siempre es el mediodía de “hora estándar”).
imageryQuality

enum (ImageryQuality)

La 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

Es la calidad de las imágenes que se usan 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 procesadas 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.
LOW Los datos solares se obtienen de imágenes satelitales mejoradas procesadas a 0.25 m/píxel.

Métodos

get

 Obtiene información solar de una región que rodea una ubicación.