Índice
Solar(interfaz)BuildingInsights(mensaje)CashPurchaseSavings(mensaje)DataLayerView(enumeración)DataLayers(mensaje)FinancedPurchaseSavings(mensaje)FinancialAnalysis(mensaje)FinancialDetails(mensaje)FindClosestBuildingInsightsRequest(mensaje)GetDataLayersRequest(mensaje)GetGeoTiffRequest(mensaje)ImageryQuality(enumeración)LatLngBox(mensaje)LeasingSavings(mensaje)RoofSegmentSizeAndSunshineStats(mensaje)RoofSegmentSummary(mensaje)SavingsOverTime(mensaje)SizeAndSunshineStats(mensaje)SolarPanel(mensaje)SolarPanelConfig(mensaje)SolarPanelOrientation(enumeración)SolarPotential(mensaje)
Solar
Definición del servicio de la API de Solar.
| FindClosestBuildingInsights |
|---|
|
Ubica el edificio cuyo centroide está más cerca de un punto de consulta. Muestra un error con el código
|
| GetDataLayers |
|---|
|
Obtiene información solar de una región que rodea una ubicación. Muestra un error con el código
|
| GetGeoTiff |
|---|
|
Muestra una imagen por su ID.
|
BuildingInsights
Mensaje de respuesta para Solar.FindClosestBuildingInsights. Información sobre la ubicación, las dimensiones y el potencial solar de un edificio.
| Campos | |
|---|---|
name |
Es el nombre del recurso del edificio, con el formato |
center |
Un punto cerca del centro del edificio |
bounding_box |
Es el cuadro de límite del edificio. |
imagery_date |
Es la fecha en que se adquirieron las imágenes subyacentes. Esta es una aproximación. |
imagery_processed_date |
Indica cuándo se completó el procesamiento de estas imágenes. |
postal_code |
Código postal (p.ej., código postal de EE.UU.) en el que se encuentra el edificio. |
administrative_area |
Es el área administrativa 1 (p. ej., en EE.UU., el estado) que contiene este edificio. Por ejemplo, en EE.UU., la abreviatura puede ser “MA” o “CA”. |
statistical_area |
Área de estadísticas (p.ej., sección del censo de EE.UU.) en la que se encuentra el edificio. |
region_code |
Es el código de región del país (o la región) en el que se encuentra el edificio. |
solar_potential |
Potencial solar del edificio |
imagery_quality |
Es la calidad de las imágenes que se usaron para calcular los datos de este edificio. |
CashPurchaseSavings
Costo y beneficio de la compra directa de una configuración particular de paneles solares con un uso específico de electricidad.
| Campos | |
|---|---|
out_of_pocket_cost |
Costo inicial antes de los incentivos fiscales: Es el importe que se debe pagar de forma personal. Compara esto con |
upfront_cost |
Costo inicial después de los incentivos fiscales: Es el importe que se debe pagar durante el primer año. Compara esto con |
rebate_value |
Es el valor de todos los reembolsos de impuestos. |
savings |
Cuánto se ahorra (o no) durante el período de vida útil. |
payback_years |
Cantidad de años hasta que se produce el retorno de la inversión. Un valor negativo significa que el retorno de la inversión nunca se produce dentro del período de vida útil. |
DataLayerView
Qué subconjunto de la información solar se mostrará.
| Enumeraciones | |
|---|---|
DATA_LAYER_VIEW_UNSPECIFIED |
Equivale a FULL. |
DSM_LAYER |
Obtén solo el DSM. |
IMAGERY_LAYERS |
Obtén el DSM, el RGB y la máscara. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
Obtén el DSM, el RGB, la máscara y el flujo anual. |
IMAGERY_AND_ALL_FLUX_LAYERS |
Obtén el DSM, el RGB, la máscara, el flujo anual y el flujo mensual. |
FULL_LAYERS |
Obtén todos los datos. |
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 pixel_size_meters en GetDataLayersRequest, la resolución mínima en los archivos GeoTIFF será ese valor.
| Campos | |
|---|---|
imagery_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. |
imagery_processed_date |
Indica cuándo se completó el procesamiento de estas imágenes. |
dsm_url |
Es la URL de una imagen del DSM (modelo de superficie digital) 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. |
rgb_url |
Es la URL de una imagen de datos RGB (foto aérea) de la región. |
mask_url |
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. |
annual_flux_url |
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. |
monthly_flux_url |
Es 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 apunta esta URL contendrá doce bandas, correspondientes a enero, febrero, etc., en orden. |
hourly_shade_urls[] |
Doce URLs para la sombra por hora, correspondientes a los meses de 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:
De forma más formal: Dado donde |
imagery_quality |
La calidad de las imágenes del resultado |
FinancedPurchaseSavings
Costo y beneficio de usar un préstamo para comprar una configuración particular de paneles solares con un uso específico de electricidad.
| Campos | |
|---|---|
annual_loan_payment |
Pagos anuales del préstamo |
rebate_value |
Es el valor de todas las devoluciones de impuestos (incluido el Crédito fiscal federal por inversión (ITC)). |
loan_interest_rate |
Es la tasa de interés de los préstamos que se supone en este conjunto de cálculos. |
savings |
Cuánto se ahorra (o no) durante el período de vida útil. |
FinancialAnalysis
Análisis del costo y los beneficios de la disposición solar óptima para un tamaño de factura eléctrica en particular.
| Campos | |
|---|---|
monthly_bill |
La factura eléctrica mensual que supone este análisis. |
default_bill |
Indica si este es el tamaño de factura seleccionado para ser la factura predeterminada del área en la que se encuentra el edificio. Exactamente un |
average_kwh_per_month |
La cantidad de electricidad que consume la casa en un mes promedio, según el tamaño de la factura y las tarifas locales de electricidad. |
financial_details |
Es la información financiera que se aplica independientemente de la forma de financiación que se utilice. |
leasing_savings |
Costo y beneficio de alquilar los paneles solares. |
cash_purchase_savings |
Costo y beneficio de comprar los paneles solares con efectivo. |
financed_purchase_savings |
Costo y beneficio de comprar los paneles solares financiando la compra. |
panel_config_index |
Es el índice en |
FinancialDetails
Son los detalles de un análisis financiero. Algunos de estos detalles ya se almacenan en niveles superiores (p.ej., el costo de bolsillo). Los importes monetarios totales se calculan durante un período de vida definido por el campo panel_lifetime_years en SolarPotential. Nota: El costo de compra de los paneles se indica en el campo out_of_pocket_cost en CashPurchaseSavings.
| Campos | |
|---|---|
initial_ac_kwh_per_year |
Es la cantidad de kWh de CA que creemos que generarán los paneles solares en su primer año. |
remaining_lifetime_utility_bill |
Factura de electricidad por la electricidad que no se produce con energía solar, durante la vida útil de los paneles. |
federal_incentive |
Es el importe de dinero disponible de los incentivos federales. Esto se aplica si el usuario compra (con o sin un préstamo) los paneles. |
state_incentive |
Es la cantidad de dinero disponible de los incentivos estatales. Esto se aplica si el usuario compra (con o sin un préstamo) los paneles. |
utility_incentive |
Es la cantidad de dinero disponible de los incentivos de la empresa de servicios públicos. Esto se aplica si el usuario compra (con o sin un préstamo) los paneles. |
lifetime_srec_total |
Es la cantidad de dinero que el usuario recibirá de los créditos de energía renovable solar durante la vida útil de los paneles. Esto se aplica si el usuario compra los paneles (con o sin un préstamo). |
cost_of_electricity_without_solar |
Es el costo total de electricidad que el usuario habría pagado durante el período de vida útil si no hubiera instalado energía solar. |
net_metering_allowed |
Indica si se permite la medición neta. |
solar_percentage |
Es el porcentaje (de 0 a 100) de la energía del usuario que se suministra a través de energía solar. Es válida para el primer año, pero es aproximadamente correcta para los años futuros. |
percentage_exported_to_grid |
El porcentaje (0-100) de producción de electricidad solar que suponemos que se exportó a la red, según el primer trimestre de producción. Esto afecta los cálculos si no se permite la medición neta. |
FindClosestBuildingInsightsRequest
Mensaje de solicitud para Solar.FindClosestBuildingInsights.
| Campos | |
|---|---|
location |
Es obligatorio. La longitud y la latitud desde las que la API busca el edificio conocido más cercano. |
required_quality |
Opcional. Es el nivel de calidad mínimo permitido en los resultados. No se mostrará ningún resultado con una calidad inferior a esta. Si no se especifica, se limita solo a la calidad ALTA. |
GetDataLayersRequest
Mensaje de solicitud para Solar.GetDataLayers.
| Campos | |
|---|---|
location |
Es obligatorio. La longitud y la latitud del centro de la región para la que se deben obtener datos |
radius_meters |
Es obligatorio. Es el radio, en metros, que define la región que rodea ese punto central para el que se deben mostrar los datos. Las limitaciones de este valor son las siguientes:
|
view |
Opcional. Es el subconjunto deseado de los datos que se mostrarán. |
required_quality |
Opcional. Es el nivel de calidad mínimo permitido en los resultados. No se mostrará ningún resultado con una calidad inferior a esta. Si no se especifica, se limita solo a la calidad ALTA. |
pixel_size_meters |
Opcional. Es la escala mínima, en metros por píxel, de los datos que se mostrarán. Se admiten los valores 0.1 (el valor predeterminado, si no se establece este campo de forma explícita), 0.25, 0.5 y 1.0. Los componentes de imágenes cuya resolución normal sea inferior a |
exact_quality_required |
Opcional. Indica si se requiere una calidad exacta de las imágenes. Si se establece en "false", el campo |
GetGeoTiffRequest
Mensaje de solicitud para Solar.GetGeoTiff.
| Campos | |
|---|---|
id |
Es obligatorio. Es el ID del recurso que se solicita. |
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 provienen de imágenes satelitales mejoradas procesadas a 0.25 m/píxel. |
BASE |
Los datos solares se obtienen de imágenes satelitales mejoradas procesadas a 0.25 m/píxel. |
LatLngBox
Un cuadro de límite en coordenadas de latitud y longitud.
LeasingSavings
Costo y beneficio de alquilar una configuración particular de paneles solares con un uso de electricidad determinado.
| Campos | |
|---|---|
leases_allowed |
Si se permiten los arrendamientos en esta jurisdicción (no se permiten en algunos estados) Si este campo es falso, es probable que se deban ignorar los valores de este mensaje. |
leases_supported |
Indica si el motor de cálculo financiero admite los arrendamientos en esta jurisdicción. Si este campo es falso, es probable que se deban ignorar los valores de este mensaje. Esto es independiente de |
annual_leasing_cost |
Es el costo anual estimado del arrendamiento. |
savings |
Cuánto se ahorra (o no) durante el período de vida útil. |
RoofSegmentSizeAndSunshineStats
Información sobre el tamaño y los cuantiles de insolación de un segmento de techo.
| Campos | |
|---|---|
stats |
Tamaño total y cuantiles de luz solar para el segmento de techo |
center |
Un punto cerca del centro del segmento del techo. |
bounding_box |
Es el cuadro de límite del segmento de techo. |
pitch_degrees |
Es el ángulo del segmento de techo en relación con el plano teórico del suelo. 0 = paralelo al suelo, 90 = perpendicular al suelo. |
azimuth_degrees |
Es la dirección de la brújula hacia la que apunta el segmento del techo. 0 = Norte, 90 = Este, 180 = Sur. Para un segmento de techo "plano" ( |
plane_height_at_center_meters |
Es la altura del plano del segmento del techo, en metros sobre el nivel del mar, en el punto designado por |
RoofSegmentSummary
Información sobre un segmento de techo del edificio, con una cantidad determinada de paneles.
| Campos | |
|---|---|
panels_count |
Es la cantidad total de paneles en este segmento. |
yearly_energy_dc_kwh |
Cantidad de energía solar que captura esta parte del diseño a lo largo de un año, en kWh de CC, si se supone que los paneles son los descritos anteriormente. |
pitch_degrees |
Es el ángulo del segmento de techo en relación con el plano teórico del suelo. 0 = paralelo al suelo, 90 = perpendicular al suelo. |
azimuth_degrees |
Es la dirección de la brújula hacia la que apunta el segmento del techo. 0 = Norte, 90 = Este, 180 = Sur. Para un segmento de techo "plano" ( |
segment_index |
Es el índice en |
SavingsOverTime
Información financiera que se comparte entre diferentes métodos de financiación
| Campos | |
|---|---|
savings_year1 |
Ahorros en el primer año después de la instalación de los paneles. |
savings_year20 |
Ahorros en los primeros veinte años después de la instalación de los paneles. |
present_value_of_savings_year20 |
Con la tasa de descuento asumida, ¿cuál es el valor actual de los ahorros acumulados durante 20 años? |
savings_lifetime |
Ahorros durante toda la vida útil del panel |
present_value_of_savings_lifetime |
Con la tasa de descuento asumida, ¿cuál es el valor actual de los ahorros acumulados de por vida? |
financially_viable |
Indica si esta situación es viable financieramente. Será falso para situaciones con baja viabilidad financiera (p.ej., pérdida de dinero). |
SizeAndSunshineStats
Cuantiles de tamaño y soleamiento de un techo o parte de un techo.
| Campos | |
|---|---|
area_meters2 |
Es el área del techo o del tramo del techo, en m2. Esta es el área del techo (considerando la inclinación), no el área de la huella en el suelo. |
sunshine_quantiles[] |
Cuantiles de la insolación puntual en el área. Si hay N valores aquí, esto representa los (N-1)-iles. Por ejemplo, si hay 5 valores, estos serían los cuartiles (mín., 25%, 50%, 75% y máx.). Los valores se expresan en kWh/kW anuales, como |
ground_area_meters2 |
Es el área de la huella en el suelo que cubre el techo o el segmento del techo, en m2. |
SolarPanel
SolarPanel describe la posición, la orientación y la producción de un solo panel solar. Consulta los campos panel_height_meters, panel_width_meters y panel_capacity_watts en SolarPotential para obtener información sobre los parámetros del panel.
| Campos | |
|---|---|
center |
El centro del panel. |
orientation |
Es la orientación del panel. |
yearly_energy_dc_kwh |
Es la cantidad de energía solar que captura este diseño a lo largo de un año, en kWh de CC. |
segment_index |
Es el índice en |
SolarPanelConfig
SolarPanelConfig describe una ubicación particular de los paneles solares en el techo.
| Campos | |
|---|---|
panels_count |
Cantidad total de paneles. Ten en cuenta que esto es redundante con (la suma de) los campos correspondientes en |
yearly_energy_dc_kwh |
Es la cantidad de energía solar que capta este diseño a lo largo de un año, en kWh de CC, si se supone que se usan los paneles descritos anteriormente. |
roof_segment_summaries[] |
Información sobre la producción de cada segmento de techo que lleva al menos un panel en este diseño. |
SolarPanelOrientation
Es la orientación de un panel solar. Esto se debe interpretar en relación con el azimut del segmento del techo en el que se coloca el panel.
| Enumeraciones | |
|---|---|
SOLAR_PANEL_ORIENTATION_UNSPECIFIED |
No se conoce la orientación del panel. |
LANDSCAPE |
Un panel LANDSCAPE tiene su borde largo perpendicular a la dirección del azimut del segmento de techo en el que se coloca. |
PORTRAIT |
Un panel PORTRAIT tiene su borde largo paralelo a la dirección del azimut del segmento de techo en el que se coloca. |
SolarPotential
Información sobre el potencial solar de un edificio. Algunos campos se definen en términos de "paneles". Los campos panel_capacity_watts, panel_height_meters y panel_width_meters describen los parámetros del modelo de panel que se usa en estos cálculos.
| Campos | |
|---|---|
max_array_panels_count |
Es el tamaño del array máximo, es decir, la cantidad máxima de paneles que pueden caber en el techo. |
panel_capacity_watts |
Es la capacidad, en vatios, del panel que se usa en los cálculos. |
panel_height_meters |
Es la altura, en metros en orientación vertical, del panel que se usa en los cálculos. |
panel_width_meters |
Es el ancho, en metros en orientación vertical, del panel que se usa en los cálculos. |
panel_lifetime_years |
Es la vida útil esperada, en años, de los paneles solares. Esto se usa en los cálculos financieros. |
max_array_area_meters2 |
Es el tamaño, en metros cuadrados, del array máximo. |
max_sunshine_hours_per_year |
Es la cantidad máxima de horas de sol recibidas por año en cualquier punto de la azotea. Las horas de sol son una medida de la cantidad total de insolación (energía) que se recibe por año. 1 hora de sol = 1 kWh por kW (donde kW se refiere a kW de capacidad en condiciones de prueba estándar). |
carbon_offset_factor_kg_per_mwh |
Es la cantidad equivalente de CO2 producido por MWh de electricidad de la red. Esta es una medida de la intensidad de carbono de la electricidad de la red desplazada por la electricidad solar. |
whole_roof_stats |
Tamaño total y cuantiles de luz solar para la parte del techo que se asignó a algún segmento de techo. A pesar del nombre, es posible que no incluya todo el edificio. Consulta los |
building_stats |
Tamaño y cuantiles de luz solar para todo el edificio, incluidas las partes de la azotea que no se asignaron a ningún segmento de la azotea. Debido a que las orientaciones de estas partes no están bien caracterizadas, la estimación del área del techo no es confiable, pero la estimación del área del suelo sí lo es. Es posible que se pueda obtener un área de techo más confiable para todo el edificio si se ajusta el área de techo de |
roof_segment_stats[] |
Cuantiles de tamaño y luz solar para cada segmento de techo |
solar_panels[] |
Cada |
solar_panel_configs[] |
Cada |
financial_analyses[] |
Un |