- 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
- 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 a aproximadamente 50 m del punto de la búsqueda.
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. Longitud y 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. Si no se especifica, equivale a restringir la búsqueda solo a la calidad ALTA. |
exactQualityRequired |
Opcional. Indica si se requiere la calidad exacta de las imágenes. Si se establece como 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. Es la 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 |
Nombre del recurso del edificio, con el formato |
center |
Un punto cerca del centro del edificio |
boundingBox |
Es el cuadro delimitador del edificio. |
imageryDate |
Fecha en la que se adquirieron las imágenes subyacentes. Este valor es aproximado. |
imageryProcessedDate |
Indica 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.) que contiene este edificio. |
administrativeArea |
Á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., sector censal de EE.UU.) en la que se encuentra este edificio. |
regionCode |
Es el código de región del país (o la región) en el que se encuentra el 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 DETECTED_ARRAYS se incluye en el campo |
Permisos de autorización
Requiere el siguiente permiso de OAuth:
https://www.googleapis.com/auth/cloud-platform
AdditionalInsights
Es información adicional sobre el edificio, como la geometría del techo y los arrays de paneles solares, que se puede devolver en BuildingInsights.
| Enums | |
|---|---|
ADDITIONAL_INSIGHTS_UNSPECIFIED |
Es el valor predeterminado. Se devolverá el objeto 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 suroeste de la caja. |
ne |
Es la esquina noreste del cuadro. |
SolarPotential
Es información sobre el potencial solar de un edificio. Varios campos de este objeto 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 |
Tamaño del array máximo, es decir, la cantidad máxima de paneles que pueden caber en el techo. |
panelCapacityWatts |
Capacidad, en vatios, del panel que se usa en los cálculos. |
panelHeightMeters |
Altura, en metros en orientación vertical, del panel que se usa en los cálculos. |
panelWidthMeters |
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. Este valor se usa en los cálculos financieros. |
maxArrayAreaMeters2 |
Tamaño, en metros cuadrados, del array máximo. |
maxSunshineHoursPerYear |
Cantidad máxima de horas de sol que recibe por año cualquier punto del techo. 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). |
carbonOffsetFactorKgPerMwh |
Cantidad equivalente de CO2 producido por cada 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 la electricidad solar. |
wholeRoofStats |
Cuantiles de tamaño total y luz solar para la parte del techo que se asignó a algún segmento del techo. A pesar del nombre, es posible que no incluya todo el edificio. Consulta los |
buildingStats |
Cuantiles de tamaño y luz solar para todo el edificio, incluidas las partes del techo que no se asignaron a ningún segmento del techo. Dado 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 del área del suelo sí lo es. Es posible que se pueda obtener una superficie del techo de todo el edificio más confiable si se ajusta la superficie del techo de |
roofSegmentStats[] |
Cuantiles de tamaño y luz solar para cada segmento del 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 un techo.
| 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 (que tiene en cuenta la inclinación), no el área de la huella en el suelo. |
sunshineQuantiles[] |
Cuantiles de la exposición solar puntual en toda 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 están en kWh/kW anuales, como |
groundAreaMeters2 |
Es el área de la huella en el suelo que cubre el techo o el segmento del techo, en m². |
RoofSegmentSizeAndSunshineStats
Es información sobre los cuantiles de tamaño y soleamiento de un segmento de techo.
| Representación JSON |
|---|
{ "stats": { object ( |
| Campos | |
|---|---|
stats |
Son los cuantiles de tamaño total y luz solar del segmento del techo. |
center |
Es un punto cerca del centro del segmento del techo. |
boundingBox |
Es el cuadro delimitador del segmento del techo. |
pitchDegrees |
Ángulo del segmento del techo en relación con el plano del suelo teórico. 0 = paralelo al suelo, 90 = perpendicular al suelo. |
azimuthDegrees |
Es la dirección de la brújula hacia la que apunta el segmento del techo. 0 = norte, 90 = este, 180 = sur En el caso de un segmento de techo "plano" ( |
planeHeightAtCenterMeters |
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 |
Es el centro del panel. |
orientation |
Es la orientación del panel. |
yearlyEnergyDcKwh |
Cuánta energía solar capta este diseño a lo largo de un año, en kWh de CC. |
segmentIndex |
Índice en |
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.
| 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 azimut del segmento del techo en el que se coloca. |
PORTRAIT |
Un panel PORTRAIT tiene su borde largo paralelo a la dirección del azimut del segmento del techo en el que se coloca. |
SolarPanelConfig
SolarPanelConfig describe una colocación particular de 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 este campo es redundante con los campos correspondientes en |
yearlyEnergyDcKwh |
Cuánta energía solar capta este diseño a lo largo de un año, en kWh de CC, suponiendo que se usan los paneles descritos anteriormente. |
roofSegmentSummaries[] |
Es la información sobre la producción de cada segmento del techo que contiene al menos un panel en este diseño. |
RoofSegmentSummary
Es información sobre un segmento del techo del edificio, con una cierta 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 en este tramo. |
yearlyEnergyDcKwh |
Cuánta energía solar capta esta parte del diseño durante un año, en kWh de CC, suponiendo que se usan los paneles descritos anteriormente |
pitchDegrees |
Á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 segmento del techo. 0 = norte, 90 = este, 180 = sur En el caso de un segmento de techo "plano" ( |
segmentIndex |
Índice en |
FinancialAnalysis
Análisis del costo y los beneficios de la distribución solar óptima para un tamaño de factura eléctrica en particular
| Representación JSON |
|---|
{ "monthlyBill": { object ( |
| Campos | |
|---|---|
monthlyBill |
Es la factura mensual de electricidad que se supone en este análisis. |
defaultBill |
Indica si este es el tamaño de la factura seleccionado para ser la factura predeterminada del área en la que se encuentra este edificio. Exactamente un |
averageKwhPerMonth |
Cuánta electricidad usa la casa en un mes promedio, según el importe de la factura y las tarifas eléctricas locales |
financialDetails |
Es la 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 |
Costo y beneficio de comprar los paneles solares financiando la compra |
panelConfigIndex |
Í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 totales de dinero se calculan para un período de duración definido por el campo panelLifetimeYears en SolarPotential. Nota: El costo de bolsillo de la compra de los paneles se indica en el campo outOfPocketCost en CashPurchaseSavings.
| Representación JSON |
|---|
{ "initialAcKwhPerYear": number, "remainingLifetimeUtilityBill": { object ( |
| Campos | |
|---|---|
initialAcKwhPerYear |
La cantidad de kWh de CA que creemos que generarán los paneles solares en su primer año. |
remainingLifetimeUtilityBill |
Factura de electricidad no producida por 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 préstamo). |
stateIncentive |
Es la cantidad de dinero disponible a partir de los incentivos estatales. Esto se aplica si el usuario compra los paneles (con o sin préstamo). |
utilityIncentive |
Es la cantidad de dinero disponible de los incentivos de servicios públicos. Esto se aplica si el usuario compra los paneles (con o sin préstamo). |
lifetimeSrecTotal |
Es la cantidad de dinero que el usuario recibirá por los créditos de energía renovable solar durante la vida útil del panel. Esto se aplica si el usuario compra los paneles (con o sin préstamo). |
costOfElectricityWithoutSolar |
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. |
netMeteringAllowed |
Indica si se permite la medición neta. |
solarPercentage |
Porcentaje (de 0 a 100) de la energía del usuario que proviene de la 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 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. |
LeasingSavings
Costo y beneficio de alquilar 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, probablemente 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, probablemente se deban ignorar los valores de este mensaje. Esto es independiente de |
annualLeasingCost |
Costo anual estimado del alquiler. |
savings |
Cuánto se ahorra (o no) durante el período de vida útil. |
SavingsOverTime
Es la información financiera que se comparte entre los diferentes métodos de financiación.
| 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 en 20 años? |
savingsLifetime |
Ahorro 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 la vida útil? |
financiallyViable |
Indica si esta situación es viable desde el punto de vista financiero. Será falso para las situaciones con poca viabilidad financiera (p.ej., pérdidas económicas). |
CashPurchaseSavings
Costo y beneficio de la compra directa de una configuración particular de paneles solares con un uso de electricidad específico.
| Representación JSON |
|---|
{ "outOfPocketCost": { object ( |
| Campos | |
|---|---|
outOfPocketCost |
Costo inicial antes de los incentivos fiscales: Es el importe que se debe pagar de bolsillo. Compara esto con |
upfrontCost |
Costo inicial después de los incentivos fiscales: Es el importe que se debe pagar durante el primer año. Compara esto con |
rebateValue |
Es el valor de todas las devoluciones de impuestos. |
savings |
Cuánto se ahorra (o no) durante el período de vida útil. |
paybackYears |
Cantidad de años hasta que se produce la recuperación. Un valor negativo significa que la recuperación nunca se produce dentro del período de vida útil. |
FinancedPurchaseSavings
Costo y 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 del préstamo |
rebateValue |
Es el valor de todas las devoluciones de impuestos (incluido el Crédito Fiscal por Inversión [ITC] federal). |
loanInterestRate |
Es la tasa de interés de los préstamos que se supone en este conjunto de cálculos. |
savings |
Indica cuánto se ahorra (o no) durante el período. |
DetectedArrays
Es 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. |
latestCaptureDate |
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. |