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 cuales este mensaje contiene URLs: cada cadena del mensaje DataLayers contiene una URL desde la que se puede obtener el GeoTIFF correspondiente. Estas URLs son válidas durante unas horas después de haberse generado. 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 sombreado por hora tienen 1 m/píxel. Si se especificó un valor 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)

Indica 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 un poco aproximado, ya que las imágenes pueden haberse tomado durante más de un día.
imageryProcessedDate

object (Date)

Cuando se completó el procesamiento de estas imágenes.
dsmUrl

string

Es la URL de una imagen del DSM (modelo de superficie digital) de la región. Los valores están en metros sobre el valor geoide EGM96 (es decir, el nivel del mar). Las ubicaciones no válidas (donde 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

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

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

string

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

string

Doce URLs para la sombra 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. 1 bit significa que la ubicación correspondiente puede ver el sol en ese día, en esa hora y en ese mes. Las ubicaciones no válidas se almacenan como -9999 (ya que esto es negativo, tiene el bit 31 configurado y ningún valor válido podría tener el bit 31 configurado, ya que correspondería al día 32 del mes).

Un ejemplo puede ser útil. Para saber si un punto (en ubicación en píxeles [x, y]) vio sol a las 4 p.m. el 22 de junio, tendrías que hacer lo siguiente:

  1. recupera la sexta URL de esta lista (correspondiente a junio).
  2. buscar el canal número 17 (correspondiente a las 4 p. m.).
  3. lee el valor de 32 bits en (x, y).
  4. leer 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:00 p.m. del 22 de junio.

Más formalmente: si se proporcionan month (1-12), day (1 mes como máximo; febrero tiene 28 días) y hour (0-23), la sombra y el sol para 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] hace referencia a la recuperación de la month - 1.a URL (indexación desde cero), [hour] indexa 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 duran 24 horas; el mediodía siempre es el "horario estándar" del mediodía).
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

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

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

Enumeraciones
IMAGERY_QUALITY_UNSPECIFIED No se conoce la calidad.
HIGH Las imágenes subyacentes y los datos del DSM se procesaron a 0.1 m/píxel.
MEDIUM Las imágenes subyacentes y los datos del DSM se procesaron a 0.25 m/píxel.
LOW Las imágenes subyacentes y los datos del DSM se procesaron a 0.5 m/píxel.

Métodos

get

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