Method: buildingInsights.findClosest

object (LatLng)

필수 항목입니다. API가 가장 가까운 알려진 건물을 찾는 경도 및 위도입니다.

enum (ImageryQuality)

선택사항입니다. 결과에 허용되는 최소 품질 수준입니다. 이보다 품질이 낮은 결과는 반환되지 않습니다. 지정하지 않으면 고화질로만 제한하는 것과 같습니다.

{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}

object (LatLng)

상자의 남서쪽 모서리입니다.

object (LatLng)

상자의 북동쪽 모서리입니다.

{
  "maxArrayPanelsCount": integer,
  "panelCapacityWatts": number,
  "panelHeightMeters": number,
  "panelWidthMeters": number,
  "panelLifetimeYears": integer,
  "maxArrayAreaMeters2": number,
  "maxSunshineHoursPerYear": number,
  "carbonOffsetFactorKgPerMwh": number,
  "wholeRoofStats": {
    object (SizeAndSunshineStats)
  },
  "buildingStats": {
    object (SizeAndSunshineStats)
  },
  "roofSegmentStats": [
    {
      object (RoofSegmentSizeAndSunshineStats)
    }
  ],
  "solarPanels": [
    {
      object (SolarPanel)
    }
  ],
  "solarPanelConfigs": [
    {
      object (SolarPanelConfig)
    }
  ],
  "financialAnalyses": [
    {
      object (FinancialAnalysis)
    }
  ]
}

integer

최대 배열 크기 - 즉, 지붕에 들어갈 수 있는 최대 패널 수입니다.

number

계산에 사용된 패널의 용량(와트 단위)입니다.

number

계산에 사용된 패널의 높이(세로 방향)입니다(미터 단위).

number

계산에 사용된 패널의 너비(세로 방향 방향의 미터)입니다.

integer

태양광 패널의 예상 수명(년)입니다. 재무 계산에 사용됩니다.

number

최대 배열의 크기(제곱미터)입니다.

number

연간 지붕 위 어느 지점에서나 받을 수 있는 최대 일사 시간. 햇빛 시간은 연간 받는 총 일사량 (에너지)의 양을 측정한 값입니다. 1일광시간 = kW당 1kWh (여기서 kW는 표준 테스트 조건에서의 용량 kW를 나타냄)

number

전력망 전력 1MWh당 생산된 CO2 등가량입니다. 태양광 발전으로 대체된 전력망 전기의 탄소 강도를 측정한 값입니다.

object (SizeAndSunshineStats)

일부 지붕 세그먼트에 할당된 지붕 부분의 총 크기 및 일광 분위수입니다. 이름과 달리 건물 전체가 포함되어 있지 않을 수도 있습니다. buildingStats 페이지를 참고하세요.

object (SizeAndSunshineStats)

일부 지붕 세그먼트에 할당되지 않은 지붕 부분을 포함하여 전체 건물의 크기 및 일광 분위수입니다. 이러한 부품의 방향이 잘 특성이 나오지 않기 때문에 지붕 면적 추정치는 신뢰할 수 없지만 지면 면적 추정값은 신뢰할 수 있습니다. wholeRoofStats의 지상 면적을 buildingStats와 wholeRoofStats의 지면 면적 비율로 확장하면 건물 지붕 전체의 면적을 더 안정적으로 늘릴 수 있습니다.

object (RoofSegmentSizeAndSunshineStats)

각 옥상 세그먼트의 크기 및 일광 분위수입니다.

object (SolarPanel)

각 SolarPanel는 단일 태양 전지판을 설명합니다. 패널 레이아웃 알고리즘이 배치한 순서대로 나열됩니다. 항상 그런 것은 아니지만 일반적으로 연간 에너지 생산량이 줄어드는 경향이 있습니다.

object (SolarPanelConfig)

각 SolarPanelConfig은 지붕에 설치된 태양 전지판의 다양한 배치를 설명합니다. 패널 수가 증가하는 순으로 표시됩니다. panelsCount=N인 SolarPanelConfig는 solarPanels 목록의 처음 N개 패널을 기반으로 합니다. 이 필드는 지붕에 4개 이상의 패널을 맞출 수 있는 경우에만 채워집니다.

object (FinancialAnalysis)

FinancialAnalysis은 주어진 월간 청구서와 특정 전력 공급자를 가정하여 태양광 사용으로 절감하는 금액입니다. 월별 청구 금액이 증가하는 순으로 표시됩니다. Solar API가 재무 계산을 수행하기에 충분한 정보가 없는 지역의 건물은 이 필드가 비어 있습니다.

{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}

number

지붕 또는 지붕 세그먼트의 면적입니다(m^2). 이는 지면 풋프린트 면적이 아닌 옥상 면적 (기울기로 계산됨)입니다.

number

지역 전역의 점 단위 햇빛의 분위수입니다. 여기에 N개의 값이 있으면 (N-1)-타일을 나타냅니다. 예를 들어 5개의 값이 있으면 사분위 (최소, 25%, 50%, 75%, 최대)가 됩니다. 값은 연간 kWh/kW(예: maxSunshineHoursPerYear)입니다.

number

지붕 또는 지붕 세그먼트로 덮인 지면 면적(m^2)입니다.

{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}

object (SizeAndSunshineStats)

지붕 세그먼트의 총 크기 및 일광 분위수입니다.

object (LatLng)

지붕 세그먼트의 중심 근처에 있는 점입니다.

object (LatLngBox)

지붕 세그먼트의 경계 상자입니다.

number

이론적 기준면을 기준으로 한 지붕 구간의 각도입니다. 0 = 지면과 평행, 90 = 지면에 수직

number

지붕 세그먼트가 가리키는 나침반 방향입니다. 0 = 북쪽, 90 = 동쪽, 180 = 남쪽. '평평한' 지붕 세그먼트 (pitchDegrees이 0에 매우 가까움)의 경우 방위각이 잘 정의되지 않으므로 일관성을 위해 임의적으로 0 (북쪽)으로 정의합니다.

number

center에서 지정한 지점에서 해수면 위의 지붕 세그먼트 평면 높이입니다(단위: 미터). 이 값은 피치, 방위각, 중심 위치와 함께 지붕 세그먼트 평면을 완전히 정의합니다.

{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}

object (LatLng)

패널의 중앙입니다.

enum (SolarPanelOrientation)

패널의 방향입니다.

number

이 레이아웃에서 1년 동안 수집한 일광 에너지의 양(DC kWh)입니다.

integer

RoofSegmentSizeAndSunshineStats의 roofSegmentStats에 있는 색인으로, 이 패널이 위치한 지붕 세그먼트에 해당합니다.

{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}

integer

총 패널 수입니다. 이는 roofSegmentSummaries의 해당 필드의 합계와 중복된다는 점에 유의하세요.

number

위에 설명된 패널을 가정할 때 이 레이아웃에서 1년 동안 포착하는 일광 에너지의 양(DC kWh)입니다.

object (RoofSegmentSummary)

이 레이아웃에서 패널을 하나 이상 포함하고 있는 각 지붕 세그먼트의 생성에 대한 정보입니다. roofSegmentSummaries[i]은 크기, 예상 생산량, 방향 등 i번째 지붕 세그먼트를 설명합니다.

{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}

integer

이 세그먼트의 총 패널 수입니다.

number

위에서 설명한 패널을 가정할 때 레이아웃의 이 부분이 1년 동안 캡처하는 햇빛 에너지의 양(DC kWh)입니다.

number

이론적 기준면을 기준으로 한 지붕 구간의 각도입니다. 0 = 지면과 평행, 90 = 지면에 수직

number

지붕 세그먼트가 가리키는 나침반 방향입니다. 0 = 북쪽, 90 = 동쪽, 180 = 남쪽. '평평한' 지붕 세그먼트 (pitchDegrees이 0에 매우 가까움)의 경우 방위각이 잘 정의되지 않으므로 일관성을 위해 임의적으로 0 (북쪽)으로 정의합니다.

integer

해당 RoofSegmentSizeAndSunshineStats의 roofSegmentStats에 있는 색인입니다.

{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}

object (Money)

이 분석에서 가정하는 월간 전기 요금입니다.

boolean

이 건물이 있는 지역의 기본 청구서 크기인지 여부를 나타냅니다. BuildingSolarPotential에 있는 정확히 하나의 FinancialAnalysis에는 defaultBill가 설정되어 있어야 합니다.

number

청구서 규모와 현지 전기 요금을 기준으로 한 월 평균 전력량입니다.

object (FinancialDetails)

사용된 파이낸싱 수단과 관계없이 적용되는 재무 정보입니다.

object (LeasingSavings)

태양 전지판 임대 비용 및 이점

object (CashPurchaseSavings)

태양 전지판을 현금으로 구매할 경우의 비용 및 혜택.

object (FinancedPurchaseSavings)

파이낸싱을 통한 태양 전지판 구매 비용 및 혜택

integer

이 청구서 크기의 최적 태양광 레이아웃 배치의 solarPanelConfigs 색인입니다. -1은 레이아웃이 없음을 나타냅니다. 나머지 하위 메시지는 생략됩니다.

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

ISO 4217에 정의된 3자리 통화 코드입니다.

string (int64 format)

금액의 전체 단위입니다. 예를 들어 currencyCode가 "USD"이면 1단위는 1달러(USD)입니다.

integer

금액의 나노 (10^-9) 단위 수입니다. 값은 -999,999,999 ~ +999,999,999(포함) 사이여야 합니다. units가 양수이면 nanos는 양수 또는 0이어야 합니다. units가 0이면 nanos는 양수, 0 또는 음수가 될 수 있습니다. units가 음수이면 nanos는 음수 또는 0이어야 합니다. 예를 들어 $-1.75는 units=-1, nanos=-750,000,000으로 나타냅니다.

{
  "initialAcKwhPerYear": number,
  "remainingLifetimeUtilityBill": {
    object (Money)
  },
  "federalIncentive": {
    object (Money)
  },
  "stateIncentive": {
    object (Money)
  },
  "utilityIncentive": {
    object (Money)
  },
  "lifetimeSrecTotal": {
    object (Money)
  },
  "costOfElectricityWithoutSolar": {
    object (Money)
  },
  "netMeteringAllowed": boolean,
  "solarPercentage": number,
  "percentageExportedToGrid": number
}

number

태양 전지판이 첫해에 생산할 수 있는 AC kWh 전력입니다.

object (Money)

패널 수명 기간 동안 태양광 발전으로 생산되지 않은 전기에 대한 공공요금 청구서입니다.

object (Money)

연방 인센티브에서 받을 수 있는 금액입니다. 사용자가 (대출 유무와 관계없이) 패널을 구매하는 경우에 적용됩니다.

object (Money)

주 정부 인센티브에서 받을 수 있는 금액입니다. 사용자가 (대출 여부에 관계없이) 패널을 구매하는 경우에 적용됩니다.

object (Money)

공공요금 인센티브를 통해 받을 수 있는 금액입니다. 대출 여부에 관계없이 패널을 구매하는 경우에 적용됩니다.

object (Money)

패널 수명 동안 사용자가 태양광 재생 에너지 크레딧에서 받는 금액입니다. 이는 사용자가 (대출 유무와 관계없이) 패널을 구매하는 경우에 적용됩니다.

object (Money)

태양광을 설치하지 않았다면 전체 기간 동안 사용자가 지불했을 총 전기 비용입니다.

boolean

네트워크 측정 허용 여부입니다.

number

태양광으로 공급되는 사용자 전력의 비율 (0~100)입니다. 처음 1년 동안은 유효하지만 이후 해에는 대략 정확합니다.

number

전력 생산량의 1/4을 기준으로 가정한 태양광 발전량의 비율 (0~100)을 전력망으로 수출했습니다. 이는 순 측정이 허용되지 않는 경우 계산에 영향을 미칩니다.

{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}

boolean

이 관할권에서 임대가 허용되는지 여부입니다 (일부 주에서는 임대가 허용되지 않음). 이 필드가 false이면 이 메시지의 값을 무시해야 할 수 있습니다.

boolean

이 관할권에서 금융 계산 엔진의 임대 지원 여부입니다. 이 필드가 false이면 이 메시지의 값을 무시해야 할 수 있습니다. 이는 leasesAllowed와는 별개입니다. 일부 지역에서는 임대가 허용되지만 금융 모델에서 처리하지 않는 조건에서는 임대가 허용됩니다.

object (Money)

예상 연간 임대 비용입니다.

object (SavingsOverTime)

전체 기간 동안 절약되는 (또는 절약되지 않는) 금액입니다.

{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}

object (Money)

패널 설치 후 1년 동안의 절감액

object (Money)

패널 설치 후 첫 20년간의 절감 효과

object (Money)

추정된 할인율을 사용할 때, 20년 동안 누적된 절감액의 현재 가치는 얼마입니까?

object (Money)

전체 패널 전체 기간의 절감액

object (Money)

추정된 할인율을 사용할 때 전체 기간 누적 절감액의 현재 가치는 무엇인가요?

boolean

이 시나리오가 재정적으로 타당한지 여부를 나타냅니다. 재정적 실행 가능성이 낮은 시나리오 (예: 손실)의 경우 거짓입니다.

{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}

object (Money)

세금 인센티브 적용 전 초기 비용: 본인 부담으로 지불해야 하는 금액입니다. 세금 인센티브가 적용되는 upfrontCost와 대비되는 개념입니다.

object (Money)

세금 인센티브 적용 후 초기 비용: 첫해에 지불해야 하는 금액입니다. 세금 인센티브 전인 outOfPocketCost와 대비되는 개념입니다.

object (Money)

모든 세금 환급 금액입니다.

object (SavingsOverTime)

전체 기간 동안 절약되는 (또는 절약되지 않는) 금액입니다.

number

회수까지 소요된 기간(년)입니다. 음수 값은 전체 기간 내에 회수가 발생하지 않음을 의미합니다.

{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}

object (Money)

연간 대출 상환.

object (Money)

모든 세금 환급 금액 (연방 투자 세액 (ITC) 포함)입니다.

number

이 계산에서 가정한 대출 이자율입니다.

object (SavingsOverTime)

전체 기간 동안 절약되는 (또는 절약되지 않는) 금액입니다.