Method: buildingInsights.findClosest

Xác định vị trí toà nhà gần nhất với điểm truy vấn. Trả về lỗi có mã NOT_FOUND nếu không có toà nhà nào trong phạm vi khoảng 50 m tính từ điểm truy vấn.

Yêu cầu HTTP

GET https://solar.googleapis.com/v1/buildingInsights:findClosest

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Tham số
location

object (LatLng)

Bắt buộc. Kinh độ và vĩ độ mà API tìm kiếm toà nhà gần nhất đã biết.
requiredQuality

enum (ImageryQuality)

Không bắt buộc. Mức chất lượng tối thiểu được phép xuất hiện trong kết quả. Không kết quả nào có chất lượng thấp hơn kết quả này sẽ được trả về. Việc không chỉ định điều này tương đương với việc chỉ hạn chế ở chất lượng CAO.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Tin nhắn phản hồi cho Solar.FindClosestBuildingInsights. Thông tin về vị trí, kích thước và tiềm năng điện mặt trời của một toà nhà.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "postalCode": string,
  "administrativeArea": string,
  "statisticalArea": string,
  "regionCode": string,
  "solarPotential": {
    object (SolarPotential)
  },
  "imageryQuality": enum (ImageryQuality)
}
Trường
name

string

Tên tài nguyên cho toà nhà, có định dạng building/<place ID>.
center

object (LatLng)

Một điểm gần trung tâm của toà nhà.
boundingBox

object (LatLngBox)

Hộp giới hạn của toà nhà.
imageryDate

object (Date)

Ngày thu thập hình ảnh cơ bản. Đây là con số gần đúng.
imageryProcessedDate

object (Date)

Khi quá trình xử lý hình ảnh này hoàn tất.
postalCode

string

Mã bưu chính (ví dụ: Hoa Kỳ) có của toà nhà này.
administrativeArea

string

Khu vực hành chính 1 (ví dụ: tại Hoa Kỳ, tiểu bang) có chứa toà nhà này. Ví dụ: tại Hoa Kỳ, từ viết tắt có thể là "MA" hoặc "CA".
statisticalArea

string

Khu vực thống kê (ví dụ: Đường điều tra dân số Hoa Kỳ) có toà nhà này.
regionCode

string

Mã vùng của quốc gia (hoặc khu vực) có toà nhà này.
solarPotential

object (SolarPotential)

Tiềm năng điện mặt trời của toà nhà.
imageryQuality

enum (ImageryQuality)

Chất lượng hình ảnh dùng để tính toán dữ liệu cho toà nhà này.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform

LatLngBox

Hộp giới hạn theo toạ độ vĩ độ/lng.

Biểu diễn dưới dạng JSON 
{
  "sw": {
    object (LatLng)
  },
  "ne": {
    object (LatLng)
  }
}
Trường
sw

object (LatLng)

Góc phía Tây Nam của hộp.
ne

object (LatLng)

Góc phía đông bắc của hộp.

SolarPotential

Thông tin về tiềm năng năng lượng mặt trời của một toà nhà. Một số trường trong mục này được xác định theo thuật ngữ "bảng điều khiển". Các trường panelCapacityWatts, panelHeightMeters và panelWidthMeters mô tả các tham số của mô hình bảng điều khiển được dùng trong các phép tính này.

Biểu diễn dưới dạng JSON 
{
  "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)
    }
  ]
}
Trường
maxArrayPanelsCount

integer

Kích thước của mảng tối đa – tức là số lượng tấm pin tối đa có thể đặt trên mái nhà.
panelCapacityWatts

number

Công suất, tính bằng watt, của bảng điều khiển dùng trong các phép tính.
panelHeightMeters

number

Chiều cao, tính bằng mét theo hướng dọc, của bảng điều khiển được sử dụng trong các phép tính.
panelWidthMeters

number

Chiều rộng, tính bằng mét theo hướng dọc, của bảng điều khiển được sử dụng trong các tính toán.
panelLifetimeYears

integer

Tuổi thọ dự kiến của tấm pin mặt trời, tính bằng năm. Giá trị này được sử dụng trong các tính toán tài chính.
maxArrayAreaMeters2

number

Kích thước của mảng tối đa, tính bằng mét vuông.
maxSunshineHoursPerYear

number

Số giờ nắng tối đa nhận được mỗi năm tại bất kỳ điểm nào trên mái nhà. Số giờ nắng là đơn vị đo tổng lượng cách ly (năng lượng) nhận được mỗi năm. 1 giờ nắng = 1 kWh mỗi kW (trong đó kW là kW công suất trong Điều kiện thử nghiệm tiêu chuẩn).
carbonOffsetFactorKgPerMwh

number

Lượng khí CO2 tương đương sản xuất trên mỗi MWh điện lưới. Đây là thước đo cường độ cacbon của điện lưới được thay thế bằng điện mặt trời.
wholeRoofStats

object (SizeAndSunshineStats)

Tổng kích thước và số phân vị ánh sáng mặt trời cho phần mái được chỉ định cho một số phần mái. Mặc dù có tên như vậy, nhưng có thể không bao gồm toàn bộ toà nhà. Vui lòng xem buildingStats.
buildingStats

object (SizeAndSunshineStats)

Số lượng tử ánh sáng mặt trời và kích thước cho toàn bộ toà nhà, bao gồm cả các phần của mái chưa được gán cho một số phần mái. Vì hướng của các phần này không được thể hiện rõ đặc điểm, nên ước tính diện tích mái không đáng tin cậy, nhưng ước tính diện tích mặt đất là đáng tin cậy. Trường hợp này có thể thu được diện tích mái của toàn bộ toà nhà ổn định hơn bằng cách chia tỷ lệ diện tích mái từ wholeRoofStats theo tỷ lệ diện tích mặt đất là buildingStats và wholeRoofStats.
roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

Số phân vị ánh sáng mặt trời và kích thước cho mỗi khu vực mái.
solarPanels[]

object (SolarPanel)

Mỗi SolarPanel mô tả một tấm pin mặt trời duy nhất. Các bố cục này được liệt kê theo thứ tự mà thuật toán bố cục bảng điều khiển đặt ở vị trí này. Sự thay đổi này thường xảy ra theo thứ tự giảm dần mức sản xuất năng lượng hằng năm, nhưng không phải lúc nào cũng vậy.
solarPanelConfigs[]

object (SolarPanelConfig)

Mỗi SolarPanelConfig mô tả cách sắp xếp riêng các tấm pin năng lượng mặt trời trên mái. Các bảng này được sắp xếp theo thứ tự tăng dần số lượng bảng điều khiển. SolarPanelConfig có panelsCount=N dựa trên N bảng điều khiển đầu tiên trong danh sách solarPanels. Trường này chỉ được điền sẵn nếu có ít nhất 4 bảng điều khiển trên một mái nhà.
financialAnalyses[]

object (FinancialAnalysis)

FinancialAnalysis giúp tiết kiệm chi phí từ năng lượng mặt trời với giả sử một hoá đơn hằng tháng và một nhà cung cấp điện nhất định. Số tiền này được sắp xếp theo thứ tự tăng dần số tiền trên hoá đơn hằng tháng. Trường này sẽ trống đối với các toà nhà ở những khu vực mà API năng lượng mặt trời không có đủ thông tin để thực hiện các phép tính tài chính.

SizeAndSunshineStats

Số phân vị kích thước và số lượng nắng của mái nhà hoặc một phần của mái nhà.

Biểu diễn dưới dạng JSON 
{
  "areaMeters2": number,
  "sunshineQuantiles": [
    number
  ],
  "groundAreaMeters2": number
}
Trường
areaMeters2

number

Diện tích mái hoặc phần mái, tính bằng m^2. Đây là diện tích mái (tính theo độ nghiêng), không phải diện tích đất xây dựng.
sunshineQuantiles[]

number

Các lượng tử của độ nắng theo điểm trên khu vực. Nếu có N giá trị ở đây, thì giá trị này đại diện cho các liên kết (N-1). Ví dụ: nếu có 5 giá trị, thì đó sẽ là các tứ phân vị (tối thiểu, 25%, 50%, 75%, tối đa). Các giá trị được tính bằng kWh/kW hằng năm như maxSunshineHoursPerYear.
groundAreaMeters2

number

Diện tích mặt đất bao phủ phần mái hoặc phần mái, tính bằng m^2.

RoofSegmentSizeAndSunshineStats

Thông tin về kích thước và số lượng phần tử chứa nắng của một phần mái.

Biểu diễn dưới dạng JSON 
{
  "stats": {
    object (SizeAndSunshineStats)
  },
  "center": {
    object (LatLng)
  },
  "boundingBox": {
    object (LatLngBox)
  },
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "planeHeightAtCenterMeters": number
}
Trường
stats

object (SizeAndSunshineStats)

Tổng kích thước và số phân vị ánh sáng mặt trời cho phần mái nhà.
center

object (LatLng)

Một điểm gần tâm của phần mái nhà.
boundingBox

object (LatLngBox)

Hộp giới hạn của đoạn mái.
pitchDegrees

number

Góc của phần mái so với mặt phẳng mặt đất lý thuyết. 0 = song song với mặt đất, 90 = vuông góc với mặt đất.
azimuthDegrees

number

Hướng la bàn mà phần mái nhà đang trỏ vào. 0 = Bắc, 90 = Đông, 180 = Nam. Đối với đoạn mái "bằng phẳng" (pitchDegrees rất gần 0), góc phương vị không được xác định rõ, vì vậy để đảm bảo tính nhất quán, chúng tôi tuỳ ý xác định góc phương vị là 0 (Bắc).
planeHeightAtCenterMeters

number

Chiều cao của mặt phẳng phần mái, tính bằng mét trên mực nước biển, tại điểm do center chỉ định. Cùng với độ cao, góc phương vị và vị trí trung tâm, thông tin này xác định đầy đủ mặt phẳng của phần mái.

SolarPanel

Solar Panel cho biết vị trí, hướng và cách sản xuất một tấm pin năng lượng mặt trời. Xem các trường panelHeightMeters, panelWidthMeters và panelCapacityWatts trong SolarPotential để biết thông tin về các thông số của bảng.

Biểu diễn dưới dạng JSON 
{
  "center": {
    object (LatLng)
  },
  "orientation": enum (SolarPanelOrientation),
  "yearlyEnergyDcKwh": number,
  "segmentIndex": integer
}
Trường
center

object (LatLng)

Giữa bảng điều khiển.
orientation

enum (SolarPanelOrientation)

Hướng bảng điều khiển.
yearlyEnergyDcKwh

number

Lượng năng lượng ánh sáng mặt trời mà bố cục này thu được trong một năm, tính bằng kWh.
segmentIndex

integer

Chỉ mục trong roofSegmentStats của RoofSegmentSizeAndSunshineStats tương ứng với phần mái nhà mà bảng điều khiển này được đặt.

SolarPanelOrientation

Hướng của tấm pin mặt trời. Giá trị này phải được diễn giải tương ứng với góc phương vị của phần mái mà bạn đặt bảng điều khiển.

Enum
SOLAR_PANEL_ORIENTATION_UNSPECIFIED Chưa xác định hướng bảng điều khiển nào.
LANDSCAPE Bảng điều khiển LANDSCAPE có cạnh dài vuông góc với hướng góc phương vị của phần mái nhà được đặt trên đó.
PORTRAIT Bảng điều khiển PORTRAIT có cạnh dài song song với hướng góc phương vị của phần mái nhà mà nó được đặt lên.

SolarPanelConfig

solar PanelConfig mô tả một vị trí cụ thể của các tấm pin năng lượng mặt trời trên mái nhà.

Biểu diễn dưới dạng JSON 
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "roofSegmentSummaries": [
    {
      object (RoofSegmentSummary)
    }
  ]
}
Trường
panelsCount

integer

Tổng số bảng điều khiển. Lưu ý rằng giá trị này thừa cho (tổng của các trường tương ứng trong roofSegmentSummaries).
yearlyEnergyDcKwh

number

Mức năng lượng ánh sáng mặt trời mà bố cục này thu được trong một năm, tính bằng kWh, giả sử các bảng được mô tả ở trên.
roofSegmentSummaries[]

object (RoofSegmentSummary)

Thông tin về việc sản xuất mỗi phần mái có ít nhất một bảng điều khiển trong bố cục này. roofSegmentSummaries[i] mô tả cấu trúc của mái nhà thứ i, bao gồm cả kích thước, quy trình sản xuất và hướng dự kiến.

RoofSegmentSummary

Thông tin về một đoạn mái của toà nhà, với một số bảng điều khiển được đặt trên đó.

Biểu diễn dưới dạng JSON 
{
  "panelsCount": integer,
  "yearlyEnergyDcKwh": number,
  "pitchDegrees": number,
  "azimuthDegrees": number,
  "segmentIndex": integer
}
Trường
panelsCount

integer

Tổng số bảng điều khiển trên phân khúc này.
yearlyEnergyDcKwh

number

Năng lượng ánh sáng mặt trời mà phần này của bố cục thu được trong suốt một năm, tính bằng kWh, giả sử các bảng được mô tả ở trên.
pitchDegrees

number

Góc của phần mái so với mặt phẳng mặt đất lý thuyết. 0 = song song với mặt đất, 90 = vuông góc với mặt đất.
azimuthDegrees

number

Hướng la bàn mà phần mái nhà đang trỏ vào. 0 = Bắc, 90 = Đông, 180 = Nam. Đối với đoạn mái "bằng phẳng" (pitchDegrees rất gần 0), góc phương vị không được xác định rõ, vì vậy để đảm bảo tính nhất quán, chúng tôi tuỳ ý xác định góc phương vị là 0 (Bắc).
segmentIndex

integer

Chỉ mục trong roofSegmentStats của RoofSegmentSizeAndSunshineStats tương ứng.

FinancialAnalysis

Phân tích chi phí và lợi ích của cách bố trí hệ thống năng lượng mặt trời tối ưu cho một hoá đơn tiền điện cụ thể.

Biểu diễn dưới dạng JSON 
{
  "monthlyBill": {
    object (Money)
  },
  "defaultBill": boolean,
  "averageKwhPerMonth": number,
  "financialDetails": {
    object (FinancialDetails)
  },
  "leasingSavings": {
    object (LeasingSavings)
  },
  "cashPurchaseSavings": {
    object (CashPurchaseSavings)
  },
  "financedPurchaseSavings": {
    object (FinancedPurchaseSavings)
  },
  "panelConfigIndex": integer
}
Trường
monthlyBill

object (Money)

Hoá đơn tiền điện hằng tháng mà bản phân tích này giả định.
defaultBill

boolean

Liệu đây có phải là kích thước hoá đơn được chọn làm hoá đơn mặc định cho khu vực của toà nhà này hay không. Chính xác một FinancialAnalysis trong BuildingSolarPotential phải có defaultBill được đặt.
averageKwhPerMonth

number

Lượng điện mà ngôi nhà sử dụng trong một tháng trung bình, dựa trên quy mô hoá đơn và mức điện tại địa phương.
financialDetails

object (FinancialDetails)

Thông tin tài chính được áp dụng bất kể phương thức tài chính được sử dụng.
leasingSavings

object (LeasingSavings)

Chi phí và lợi ích khi thuê tấm pin năng lượng mặt trời.
cashPurchaseSavings

object (CashPurchaseSavings)

Chi phí và lợi ích khi mua tấm pin mặt trời bằng tiền mặt.
financedPurchaseSavings

object (FinancedPurchaseSavings)

Chi phí và lợi ích khi mua tấm pin mặt trời bằng cách hỗ trợ tài chính cho việc mua.
panelConfigIndex

integer

Chỉ số trong solarPanelConfigs của bố cục năng lượng mặt trời tối ưu cho kích thước hoá đơn này. Giá trị này có thể là -1 cho biết không có bố cục. Trong trường hợp này, các tin nhắn phụ còn lại sẽ bị bỏ qua.

Tiền

Thể hiện số tiền kèm theo loại đơn vị tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Trường
currencyCode

string

Mã đơn vị tiền tệ gồm ba chữ cái được xác định trong ISO 4217.
units

string (int64 format)

Toàn bộ đơn vị của số tiền. Ví dụ: nếu currencyCode là "USD", thì 1 đơn vị là một đô la Mỹ.
nanos

integer

Số đơn vị nano (10^-9) của lượng. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999. Nếu units là số dương, thì nanos phải là số dương hoặc bằng 0. Nếu units bằng 0, nanos có thể là số dương, 0 hoặc âm. Nếu units là số âm, thì nanos phải là số âm hoặc 0. Ví dụ: $-1,75 được biểu diễn dưới dạng units=-1 và nanos=-750.000.000.

FinancialDetails

Thông tin chi tiết về bản phân tích tài chính. Một số thông tin trong số này đã được lưu trữ ở cấp cao hơn (ví dụ: chi phí thực tế). Tổng số tiền nằm trong khoảng thời gian hoạt động trong suốt thời gian hoạt động được xác định bằng trường panelLifetimeYears trong SolarPotential. Lưu ý: Chi phí tự trả khi mua bảng điều khiển được nêu trong trường outOfPocketCost tại CashPurchaseSavings.

Biểu diễn dưới dạng JSON 
{
  "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
}
Trường
initialAcKwhPerYear

number

Chúng tôi dự kiến các tấm pin mặt trời sẽ tạo ra bao nhiêu kWh AC trong năm đầu tiên.
remainingLifetimeUtilityBill

object (Money)

Hoá đơn dịch vụ tiện ích cho điện không phải do năng lượng mặt trời sản xuất trong suốt vòng đời của tấm pin.
federalIncentive

object (Money)

Số tiền có được từ các chương trình khuyến khích của liên bang; áp dụng nếu người dùng mua (dù có hay không có khoản vay) các bảng thông tin.
stateIncentive

object (Money)

Số tiền từ các chương trình ưu đãi của chính phủ; áp dụng nếu người dùng mua (dù có hay không vay) các bảng thông tin.
utilityIncentive

object (Money)

Số tiền có được từ các chương trình ưu đãi dịch vụ tiện ích; điều này áp dụng nếu người dùng mua (dù có hay không vay) bảng thông tin.
lifetimeSrecTotal

object (Money)

Số tiền mà người dùng sẽ nhận được từ Tín dụng năng lượng tái tạo mặt trời trong suốt vòng đời của bảng điều khiển; điều này áp dụng nếu người dùng mua tấm pin (dù có hay không vay).
costOfElectricityWithoutSolar

object (Money)

Tổng chi phí điện năng mà người dùng sẽ phải trả trong suốt thời gian hoạt động nếu họ không lắp đặt năng lượng mặt trời.
netMeteringAllowed

boolean

Liệu có cho phép định mức ròng hay không.
solarPercentage

number

Phần trăm (0-100) năng lượng mặt trời mà người dùng cung cấp. Có hiệu lực trong năm đầu tiên nhưng tương đối chính xác cho các năm tiếp theo.
percentageExportedToGrid

number

Tỷ lệ phần trăm (0-100) sản lượng điện mặt trời mà chúng tôi giả định được xuất ra lưới, dựa trên quý sản xuất đầu tiên. Điều này ảnh hưởng đến cách tính toán nếu không cho phép định mức ròng.

LeasingSavings

Chi phí và lợi ích của việc thuê một cấu hình cụ thể của các tấm pin năng lượng mặt trời với mức sử dụng điện cụ thể.

Biểu diễn dưới dạng JSON 
{
  "leasesAllowed": boolean,
  "leasesSupported": boolean,
  "annualLeasingCost": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  }
}
Trường
leasesAllowed

boolean

Việc cho thuê có được phép trong khu vực tài phán này hay không (không cho phép cho thuê ở một số tiểu bang). Nếu trường này là false thì có lẽ bạn nên bỏ qua các giá trị trong thông báo này.
leasesSupported

boolean

Liệu công cụ tính toán tài chính có hỗ trợ các giao dịch cho thuê trong phạm vi này hay không. Nếu trường này là false thì có lẽ bạn nên bỏ qua các giá trị trong thông báo này. Điều này độc lập với leasesAllowed: cho phép cho thuê trong một số khu vực, nhưng trong những điều kiện không do mô hình tài chính xử lý.
annualLeasingCost

object (Money)

Chi phí thuê ước tính hằng năm.
savings

object (SavingsOverTime)

Số tiền tiết kiệm được (hoặc không tiết kiệm) trong suốt thời gian hoạt động.

SavingsOverTime

Thông tin tài chính được chia sẻ giữa các phương thức tài chính khác nhau.

Biểu diễn dưới dạng JSON 
{
  "savingsYear1": {
    object (Money)
  },
  "savingsYear20": {
    object (Money)
  },
  "presentValueOfSavingsYear20": {
    object (Money)
  },
  "savingsLifetime": {
    object (Money)
  },
  "presentValueOfSavingsLifetime": {
    object (Money)
  },
  "financiallyViable": boolean
}
Trường
savingsYear1

object (Money)

Tiết kiệm trong năm đầu tiên sau khi lắp đặt bảng điều khiển.
savingsYear20

object (Money)

Tiết kiệm trong 20 năm đầu tiên sau khi lắp đặt bảng điều khiển.
presentValueOfSavingsYear20

object (Money)

Với tỷ lệ chiết khấu giả định, giá trị hiện tại của khoản tiết kiệm tích luỹ trong 20 năm là bao nhiêu?
savingsLifetime

object (Money)

Mức tiết kiệm trong toàn bộ thời gian hoạt động của bảng điều khiển.
presentValueOfSavingsLifetime

object (Money)

Khi sử dụng tỷ lệ chiết khấu giả định, giá trị hiện tại của khoản tiết kiệm tích luỹ trong vòng đời là bao nhiêu?
financiallyViable

boolean

Cho biết liệu trường hợp này có khả thi về mặt tài chính hay không. Sẽ là giá trị sai cho các tình huống có khả năng tài chính không tốt (ví dụ: thua tiền).

CashPurchaseSavings

Chi phí và lợi ích của việc mua hoàn toàn một cấu hình cụ thể của các tấm pin năng lượng mặt trời trong đó mức sử dụng điện cụ thể.

Biểu diễn dưới dạng JSON 
{
  "outOfPocketCost": {
    object (Money)
  },
  "upfrontCost": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "savings": {
    object (SavingsOverTime)
  },
  "paybackYears": number
}
Trường
outOfPocketCost

object (Money)

Chi phí ban đầu trước khi ưu đãi thuế: số tiền phải tự chi trả. Trái ngược với upfrontCost, tức là sau ưu đãi thuế.
upfrontCost

object (Money)

Chi phí ban đầu sau khi trừ thuế được ưu đãi: đây là số tiền phải được thanh toán trong năm đầu tiên. Trái ngược với outOfPocketCost, trước đây là ưu đãi thuế.
rebateValue

object (Money)

Giá trị của tất cả các khoản hoàn thuế.
savings

object (SavingsOverTime)

Số tiền tiết kiệm được (hoặc không tiết kiệm) trong suốt thời gian hoạt động.
paybackYears

number

Số năm cho đến khi hoàn tiền. Giá trị âm có nghĩa là giá trị hoàn vốn không bao giờ xảy ra trong toàn bộ thời gian hoạt động.

FinancedPurchaseSavings

Chi phí và lợi ích của việc sử dụng khoản vay để mua một cấu hình cụ thể của các tấm pin năng lượng mặt trời với mức sử dụng điện cụ thể.

Biểu diễn dưới dạng JSON 
{
  "annualLoanPayment": {
    object (Money)
  },
  "rebateValue": {
    object (Money)
  },
  "loanInterestRate": number,
  "savings": {
    object (SavingsOverTime)
  }
}
Trường
annualLoanPayment

object (Money)

Thanh toán khoản vay hằng năm.
rebateValue

object (Money)

Giá trị của tất cả các khoản hoàn thuế (bao gồm cả Tín dụng thuế đầu tư liên bang (ITC)).
loanInterestRate

number

Lãi suất khoản vay được giả định trong tập hợp tính toán này.
savings

object (SavingsOverTime)

Số tiền tiết kiệm được (hoặc không tiết kiệm) trong suốt thời gian hoạt động.