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 en el mensaje DataLayers
contiene una URL desde la cual se puede recuperar el GeoTIFF correspondiente. Estas URLs son válidas durante unas horas después de que se han generado. La mayoría de los archivos GeoTIFF tienen una resolución de 0.1 m/píxel, pero el archivo de flujo mensual es de 0.5 m/píxel, y los archivos de sombreado por hora son de 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 ( |
Campos | |
---|---|
imageryDate |
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. |
imageryProcessedDate |
Cuándo se completó el procesamiento de estas imágenes. |
dsmUrl |
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. |
rgbUrl |
La URL de una imagen de datos RGB (foto aérea) de la región. |
maskUrl |
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. |
annualFluxUrl |
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. |
monthlyFluxUrl |
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. |
hourlyShadeUrls[] |
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:
Más formalmente: dado
donde |
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 no son significativas. La fecha está relacionada con el calendario gregoriano. Esto puede representar una de las siguientes opciones:
- Una fecha completa con valores de año, mes y día que no sean cero
- Es un mes y un día con un año cero (por ejemplo, un aniversario).
- Un año 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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Representación JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campos | |
---|---|
year |
Año de la fecha. Debe encontrarse entre 1 y 9999, o bien entre 0 para especificar una fecha sin año. |
month |
Mes del año Debe encontrarse entre 1 y 12, o bien 0 para especificar un año sin mes ni día. |
day |
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. |
ImageryQuality
La calidad de las imágenes usadas 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 mensual siempre tienen una resolución de 0.5 m/píxel y las salidas de sombreado por hora siempre tienen una resolución de 1 m/píxel.
Enumeradores | |
---|---|
IMAGERY_QUALITY_UNSPECIFIED |
No se conoce la calidad. |
HIGH |
Las imágenes subyacentes y los datos DSM se procesaron a 0.1 m/píxel. |
MEDIUM |
Las imágenes subyacentes y los datos DSM se procesaron a 0.25 m/píxel. |
LOW |
Las imágenes subyacentes y los datos DSM se procesaron a 0.5 m/píxel. |
Métodos |
|
---|---|
|
Obtiene información solar de una región que rodea una ubicación. |