- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- AdditionalInsights
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Dinero
- FinancialDetails
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- DetectedArrays
- DetectionStatus
- SolarArray
- Pruébalo
Ubica el edificio cuyo centroide está más cerca de un punto de consulta. Devuelve un error con el código NOT_FOUND si no hay edificios en un radio de aproximadamente 50 m del punto de consulta.
Solicitud HTTP
GET https://solar.googleapis.com/v1/buildingInsights:findClosest
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
| Parámetros | |
|---|---|
location |
Obligatorio. La longitud y la latitud desde las que la API busca el edificio conocido más cercano. |
requiredQuality |
Opcional. Es el nivel de calidad mínimo permitido en los resultados. No se devolverá ningún resultado con una calidad inferior a esta. No especificar esto equivale a restringir solo a calidad ALTA. |
exactQualityRequired |
Opcional. Indica si se requiere la calidad exacta de las imágenes. Si se establece en falso, el campo |
experiments[] |
Opcional. Especifica los experimentos de fase previa a la DG que se habilitarán. Las solicitudes que usan este campo se clasifican como una oferta previa a la DG según las Condiciones Específicas del Servicio de Google Maps Platform. Consulta las descripciones de la etapa de lanzamiento para obtener más detalles. |
additionalInsights[] |
Opcional. Es una lista de |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Mensaje de respuesta para Solar.FindClosestBuildingInsights. Información sobre la ubicación, las dimensiones y el potencial solar de un edificio.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
|---|
{ "name": string, "center": { object ( |
| Campos | |
|---|---|
name |
Es el nombre del recurso del edificio, con el formato |
center |
Un punto cerca del centro del edificio. |
boundingBox |
Es el cuadro delimitador del edificio. |
imageryDate |
Es la fecha en que se adquirieron las imágenes subyacentes. Este es un valor aproximado. |
imageryProcessedDate |
Cuándo se completó el procesamiento de estas imágenes. |
postalCode |
Es el código postal (p. ej., el código postal de EE.UU.) en el que se encuentra este edificio. |
administrativeArea |
Es el área administrativa 1 (p. ej., en EE.UU., el estado) que contiene este edificio. Por ejemplo, en EE.UU., la abreviatura podría ser "MA" o "CA". |
statisticalArea |
Es el área estadística (p. ej., el sector censal de EE.UU.) en la que se encuentra este edificio. |
regionCode |
Es el código de región del país (o región) en el que se encuentra este edificio. |
solarPotential |
Potencial solar del edificio. |
imageryQuality |
Es la calidad de las imágenes que se usan para calcular los datos de este edificio. |
detectedArrays |
Son los paneles solares detectados en el edificio. Este campo solo se propaga si se incluye DETECTED_ARRAYS en el |
Permisos de autorización
Requiere el siguiente permiso de OAuth:
https://www.googleapis.com/auth/cloud-platform
AdditionalInsights
Información adicional del edificio, como la geometría del techo y los paneles solares, que se puede mostrar en BuildingInsights.
| Enums | |
|---|---|
ADDITIONAL_INSIGHTS_UNSPECIFIED |
Es el valor predeterminado. Se devolverá el BuildingInsights predeterminado. |
DETECTED_ARRAYS |
Determina si la respuesta incluirá los arrays detectados. Si se especifica, el campo |
LatLngBox
Es un cuadro delimitador en coordenadas de latitud y longitud.
| Representación JSON |
|---|
{ "sw": { object ( |
| Campos | |
|---|---|
sw |
Es la esquina sudoeste del cuadro. |
ne |
Es la esquina noreste del cuadro. |
SolarPotential
Información sobre el potencial de energía solar de un edificio. Varios campos de este archivo se definen en términos de "paneles". Los campos panelCapacityWatts, panelHeightMeters y panelWidthMeters describen los parámetros del modelo de panel que se usa en estos cálculos.
| Representación JSON |
|---|
{ "maxArrayPanelsCount": integer, "panelCapacityWatts": number, "panelHeightMeters": number, "panelWidthMeters": number, "panelLifetimeYears": integer, "maxArrayAreaMeters2": number, "maxSunshineHoursPerYear": number, "carbonOffsetFactorKgPerMwh": number, "wholeRoofStats": { object ( |
| Campos | |
|---|---|
maxArrayPanelsCount |
Es el tamaño del conjunto máximo, es decir, la cantidad máxima de paneles que caben en el techo. |
panelCapacityWatts |
Es la capacidad, en vatios, del panel que se usa en los cálculos. |
panelHeightMeters |
Es la altura, en metros, en orientación vertical, del panel que se usa en los cálculos. |
panelWidthMeters |
Es el ancho, en metros, en orientación vertical, del panel que se usa en los cálculos. |
panelLifetimeYears |
Es la vida útil esperada, en años, de los paneles solares. Se usa en los cálculos financieros. |
maxArrayAreaMeters2 |
Es el tamaño, en metros cuadrados, del arreglo máximo. |
maxSunshineHoursPerYear |
Es la cantidad máxima de horas de sol que recibe cualquier punto del techo por año. Las horas de sol son una medida de la cantidad total de insolación (energía) recibida por año. 1 hora de sol = 1 kWh por kW (donde kW se refiere a los kW de capacidad en condiciones de prueba estándar). |
carbonOffsetFactorKgPerMwh |
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 que se reemplaza por electricidad solar. |
wholeRoofStats |
Son el tamaño total y los cuantiles de luz solar de 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 |
buildingStats |
Son los cuantiles de tamaño y luz solar de todo el edificio, incluidas las partes del techo que no se asignaron a algún segmento de techo. Debido a que las orientaciones de estas partes no están bien caracterizadas, la estimación de la superficie del techo no es confiable, pero la estimación de la superficie del suelo sí lo es. Es posible que se pueda obtener una superficie del techo de todo el edificio más confiable si se escala la superficie del techo de |
roofSegmentStats[] |
Cuantiles de tamaño y luz solar para cada segmento de techo. |
solarPanels[] |
Cada |
solarPanelConfigs[] |
Cada |
financialAnalyses[] |
Un |
SizeAndSunshineStats
Son los cuantiles de tamaño y exposición al sol de un techo o parte de él.
| Representación JSON |
|---|
{ "areaMeters2": number, "sunshineQuantiles": [ number ], "groundAreaMeters2": number } |
| Campos | |
|---|---|
areaMeters2 |
Es el área del techo o del segmento del techo, en m². Esta es la superficie del techo (teniendo en cuenta la inclinación), no el área de la huella del suelo. |
sunshineQuantiles[] |
Son los cuantiles de la luminosidad solar puntual en el área. Si hay N valores aquí, esto representa los (N-1)-iles. Por ejemplo, si hay 5 valores, serían los cuartiles (mín., 25%, 50%, 75%, máx.). Los valores se expresan en kWh/kW anuales, como |
groundAreaMeters2 |
Es el área de la huella del suelo que cubre el techo o el segmento del techo, en m². |
RoofSegmentSizeAndSunshineStats
Información sobre el tamaño y los cuantiles de insolación de un segmento de techo.
| Representación JSON |
|---|
{ "stats": { object ( |
| Campos | |
|---|---|
stats |
Es el tamaño total y los cuantiles de luz solar para el segmento del techo. |
center |
Es un punto cercano al centro del segmento del techo. |
boundingBox |
Es el cuadro delimitador del segmento del techo. |
pitchDegrees |
Es el ángulo del segmento del techo en relación con el plano del suelo teórico. 0 = paralelo al suelo, 90 = perpendicular al suelo. |
azimuthDegrees |
Dirección de la brújula hacia la que apunta el tramo del techo. 0 = norte, 90 = este, 180 = sur. En el caso de un segmento de techo "plano" ( |
planeHeightAtCenterMeters |
Es la altura del plano del segmento del techo, en metros sobre el nivel del mar, en el punto designado por |
SolarPanel
SolarPanel describe la posición, la orientación y la producción de un solo panel solar. Consulta los campos panelHeightMeters, panelWidthMeters y panelCapacityWatts en SolarPotential para obtener información sobre los parámetros del panel.
| Representación JSON |
|---|
{ "center": { object ( |
| Campos | |
|---|---|
center |
El centro del panel. |
orientation |
La orientación del panel. |
yearlyEnergyDcKwh |
Es la cantidad de energía solar que capta este diseño en el transcurso de un año, en kWh de CC. |
segmentIndex |
Es el índice en |
SolarPanelOrientation
Es la orientación de un panel solar. Esto se debe interpretar en relación con el acimut del segmento del techo en el que se coloca el panel.
| Enums | |
|---|---|
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 acimut del segmento de techo en el que se coloca. |
PORTRAIT |
Un panel PORTRAIT tiene su borde largo paralelo a la dirección del acimut del segmento de techo en el que se coloca. |
SolarPanelConfig
SolarPanelConfig describe una ubicación particular de los paneles solares en el techo.
| Representación JSON |
|---|
{
"panelsCount": integer,
"yearlyEnergyDcKwh": number,
"roofSegmentSummaries": [
{
object ( |
| Campos | |
|---|---|
panelsCount |
Es la cantidad total de paneles. Ten en cuenta que esto es redundante para (la suma de) los campos correspondientes en |
yearlyEnergyDcKwh |
Es la cantidad de energía solar que captura este diseño en el transcurso de un año, en kWh de CC, según los paneles descritos anteriormente. |
roofSegmentSummaries[] |
Información sobre la producción de cada segmento de techo que tiene al menos un panel en este diseño. |
RoofSegmentSummary
Es la información sobre un segmento del techo del edificio, con una cantidad de paneles colocados en él.
| Representación JSON |
|---|
{ "panelsCount": integer, "yearlyEnergyDcKwh": number, "pitchDegrees": number, "azimuthDegrees": number, "segmentIndex": integer } |
| Campos | |
|---|---|
panelsCount |
Es la cantidad total de paneles de este segmento. |
yearlyEnergyDcKwh |
Es la cantidad de energía solar que captura esta parte del diseño en el transcurso de un año, en kWh de CC, según los paneles descritos anteriormente. |
pitchDegrees |
Es el ángulo del segmento del techo en relación con el plano del suelo teórico. 0 = paralelo al suelo, 90 = perpendicular al suelo. |
azimuthDegrees |
Dirección de la brújula hacia la que apunta el tramo del techo. 0 = norte, 90 = este, 180 = sur. En el caso de un segmento de techo "plano" ( |
segmentIndex |
Es el índice en |
FinancialAnalysis
Análisis de los costos y beneficios del diseño solar óptimo para un importe de factura de electricidad específico.
| Representación JSON |
|---|
{ "monthlyBill": { object ( |
| Campos | |
|---|---|
monthlyBill |
La factura mensual de electricidad que se supone en este análisis. |
defaultBill |
Indica si este es el tamaño de factura seleccionado para ser la factura predeterminada del área en la que se encuentra este edificio. Exactamente un |
averageKwhPerMonth |
La cantidad de electricidad que usa la casa en un mes promedio, según el importe de la factura y las tarifas de electricidad locales |
financialDetails |
Información financiera que se aplica independientemente del método de financiación utilizado. |
leasingSavings |
Costo y beneficio de arrendar los paneles solares. |
cashPurchaseSavings |
Costo y beneficio de comprar los paneles solares en efectivo. |
financedPurchaseSavings |
Es el costo y el beneficio de comprar los paneles solares financiando la compra. |
panelConfigIndex |
Es el índice en |
Dinero
Representa un importe de dinero con su tipo de moneda.
| Representación JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| Campos | |
|---|---|
currencyCode |
Es el código de moneda de tres letras definido en la norma ISO 4217. |
units |
La unidad entera del importe. Por ejemplo, si |
nanos |
Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999. Si |
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 corresponden a un período de ciclo de vida definido por el campo panelLifetimeYears en SolarPotential. Nota: El costo de bolsillo de comprar los paneles se indica en el campo outOfPocketCost de CashPurchaseSavings.
| Representación JSON |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| Campos | |
|---|---|
initialAcKwhPerYear |
Es la cantidad de kWh de CA que creemos que generarán los paneles solares en su primer año. |
remainingLifetimeUtilityBill |
Es la factura de electricidad que no se produce con energía solar durante la vida útil de los paneles. |
federalIncentive |
Es la cantidad de dinero disponible de los incentivos federales. Esto se aplica si el usuario compra los paneles (con o sin un préstamo). |
stateIncentive |
Es la cantidad de dinero disponible de los incentivos estatales. Esto se aplica si el usuario compra los paneles (con o sin un préstamo). |
utilityIncentive |
Es la cantidad de dinero disponible de los incentivos de la empresa de servicios públicos. Esto se aplica si el usuario compra los paneles (con o sin un préstamo). |
lifetimeSrecTotal |
Es la cantidad de dinero que el usuario recibirá de los créditos de energía solar renovable durante la vida útil de los paneles. Esto se aplica si el usuario compra los paneles (con o sin un préstamo). |
costOfElectricityWithoutSolar |
Es el costo total de la electricidad que el usuario habría pagado durante el período de vida útil si no hubiera instalado paneles solares. |
netMeteringAllowed |
Indica si se permite la medición neta. |
solarPercentage |
Es el porcentaje (0-100) de la energía del usuario que se suministra con energía solar. Es válido para el primer año, pero es aproximadamente correcto para los años futuros. |
percentageExportedToGrid |
Es el porcentaje (de 0 a 100) de la producción de electricidad solar que supusimos que se exportó a la red eléctrica, según el primer trimestre de producción. Esto afecta los cálculos si no se permite la medición neta. |
LeasingSavings
Es el costo y el beneficio de arrendar una configuración particular de paneles solares con un uso de electricidad específico.
| Representación JSON |
|---|
{ "leasesAllowed": boolean, "leasesSupported": boolean, "annualLeasingCost": { object ( |
| Campos | |
|---|---|
leasesAllowed |
Indica si se permiten los arrendamientos en esta jurisdicción (en algunos estados, no se permiten). Si este campo es falso, es probable que se deban ignorar los valores de este mensaje. |
leasesSupported |
Indica si el motor de cálculo financiero admite 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 |
annualLeasingCost |
Costo anual estimado del arrendamiento. |
savings |
Cuánto se ahorra (o no) durante el período de ciclo de vida |
SavingsOverTime
Información financiera que se comparte entre diferentes métodos de financiamiento
| Representación JSON |
|---|
{ "savingsYear1": { object ( |
| Campos | |
|---|---|
savingsYear1 |
Ahorros en el primer año después de la instalación de los paneles. |
savingsYear20 |
Ahorros en los primeros veinte años después de la instalación de los paneles. |
presentValueOfSavingsYear20 |
Con la tasa de descuento supuesta, ¿cuál es el valor actual de los ahorros acumulados de 20 años? |
savingsLifetime |
Ahorros durante toda la vida útil del panel. |
presentValueOfSavingsLifetime |
Con la tasa de descuento supuesta, ¿cuál es el valor actual de los ahorros acumulados durante el ciclo de vida? |
financiallyViable |
Indica si esta situación es viable desde el punto de vista financiero. Será falso para situaciones con poca viabilidad financiera (p.ej., pérdida de dinero). |
CashPurchaseSavings
Es el costo y el beneficio de la compra directa de una configuración específica de paneles solares con un uso de electricidad determinado.
| Representación JSON |
|---|
{ "outOfPocketCost": { object ( |
| Campos | |
|---|---|
outOfPocketCost |
Costo inicial antes de impuestos: Es el importe que se debe pagar de forma directa. Contrasta con |
upfrontCost |
Costo inicial después de los incentivos fiscales: Es el importe que se debe pagar durante el primer año. Contrasta con el |
rebateValue |
Es el valor de todas las devoluciones de impuestos. |
savings |
Cuánto se ahorra (o no) durante el período de ciclo de vida |
paybackYears |
Es la cantidad de años que transcurren hasta que se produce la recuperación. Un valor negativo significa que el retorno nunca se produce dentro del período de vida útil. |
FinancedPurchaseSavings
Es el costo y el beneficio de usar un préstamo para comprar una configuración particular de paneles solares con un uso de electricidad específico.
| Representación JSON |
|---|
{ "annualLoanPayment": { object ( |
| Campos | |
|---|---|
annualLoanPayment |
Pagos anuales de préstamos |
rebateValue |
Es el valor de todas las devoluciones de impuestos (incluido el crédito fiscal federal por inversión [ITC]). |
loanInterestRate |
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 ciclo de vida |
DetectedArrays
Información sobre los paneles solares detectados en el edificio.
| Representación JSON |
|---|
{ "detectionStatus": enum ( |
| Campos | |
|---|---|
detectionStatus |
Indica el estado de detección de los paneles solares de este edificio. |
arrays[] |
Es una lista de paneles solares detectados en el edificio. |
latestCaptureDate |
Es la fecha que indica cuándo se capturaron los datos más recientes del panel solar. |
DetectionStatus
Indica el estado de detección de los paneles solares de este edificio.
| Enums | |
|---|---|
DETECTION_STATUS_UNSPECIFIED |
Indica que no se especificó el estado. |
DETECTION_STATUS_DATA_UNAVAILABLE |
Los datos detectados del panel solar no están disponibles para este edificio. |
DETECTION_STATUS_ARRAYS_DETECTED |
Se detectó al menos un panel solar en este edificio. |
DETECTION_STATUS_NO_ARRAYS_DETECTED |
No se detectaron paneles solares en este edificio. |
SolarArray
Son los detalles de un solo panel solar detectado.
| Representación JSON |
|---|
{ "polygonGeojson": { object } } |
| Campos | |
|---|---|
polygonGeojson |
Es una representación en GeoJSON del área del edificio en la que se detectaron paneles solares. Los datos de GeoJSON deben tener el formato RFC 7946 y representar un polígono para una sola área contigua. El polígono se representará con varios bucles cuando contenga agujeros. Ejemplo: { "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] } |