Method: buildingInsights.findClosest

Xác định toà nhà có tâm 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 sử dụng để tì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 cho phép trong kết quả. Hệ thống sẽ không trả về kết quả nào có chất lượng thấp hơn mức này. Nếu bạn không chỉ định thì điều này tương đương với việc chỉ hạn chế ở chất lượng CAO.
exactQualityRequired

boolean

Không bắt buộc. Có yêu cầu chất lượng chính xác của hình ảnh hay không. Nếu bạn đặt thành false, trường requiredQuality sẽ được hiểu là chất lượng tối thiểu bắt buộc, sao cho hình ảnh chất lượng CAO có thể được trả về khi requiredQuality được đặt thành TRUNG BÌNH. Nếu được đặt thành true, requiredQuality sẽ được hiểu là chất lượng chính xác bắt buộc và chỉ hình ảnh có chất lượng MEDIUM mới được trả về nếu requiredQuality được đặt thành MEDIUM.
experiments[]

enum (Experiment)

Không bắt buộc. Chỉ định các thử nghiệm ở giai đoạn trước khi phát hành rộng rãi cần bật. Các yêu cầu sử dụng trường này được phân loại là sản phẩm trước giai đoạn phát hành rộng rãi theo Điều khoản dành riêng cho dịch vụ của Google Maps Platform. Hãy xem mô tả về giai đoạn phát hành để biết thêm thông tin chi tiết.
additionalInsights[]

enum (AdditionalInsights)

Không bắt buộc. Danh sách additionalInsights cần đưa vào phản hồi.

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 năng lượng 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),
  "detectedArrays": {
    object (DetectedArrays)
  }
}
Trường
name

string

Tên tài nguyên của toà nhà, có định dạng buildings/{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ố ước chừng.
imageryProcessedDate

object (Date)

Thời điểm hoàn tất quá trình xử lý hình ảnh này.
postalCode

string

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

string

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

string

Khu vực thống kê (ví dụ: khu điều tra dân số ở Hoa Kỳ) nơi toà nhà này toạ lạc.
regionCode

string

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

object (SolarPotential)

Tiềm năng tạo năng lượng mặt trời của toà nhà.
imageryQuality

enum (ImageryQuality)

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

object (DetectedArrays)

Đã phát hiện thấy mảng năng lượng mặt trời trên toà nhà. Trường này chỉ được điền sẵn nếu DETECTED_ARRAYS có trong FindClosestBuildingInsightsRequest.additional_insights của yêu cầu.

Phạm vi uỷ quyền

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

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

AdditionalInsights

Thông tin bổ sung về toà nhà, chẳng hạn như hình dạng mái nhà và mảng tấm năng lượng mặt trời, có thể được trả về trong BuildingInsights.

Enum
ADDITIONAL_INSIGHTS_UNSPECIFIED Giá trị mặc định. BuildingInsights mặc định sẽ được trả về.
DETECTED_ARRAYS

Xác định xem phản hồi có bao gồm các mảng được phát hiện hay không.

Nếu được chỉ định, trường detectedArrays sẽ được điền sẵn trong phản hồi.

LatLngBox

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

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

object (LatLng)

Góc tây nam của hộp.
ne

object (LatLng)

Góc đô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 này được xác định theo "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 tấm pin đượ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ể lắp trên mái nhà.
panelCapacityWatts

number

Công suất (tính bằng watt) của tấm pin được 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 tấm pin được 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 tấm pin được dùng trong các phép tính.
panelLifetimeYears

integer

Thời gian sử dụng dự kiến (tính theo năm) của tấm năng lượng mặt trời. Giá trị này được dùng trong các phép tính tài chính.
maxArrayAreaMeters2

number

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

number

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

number

Lượng CO2 tương đương được tạo ra trên mỗi MWh điện lưới. Đây là thước đo nồng độ phát thải carbon 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à phân vị ánh sáng mặt trời cho phần mái nhà được chỉ định cho một số phân đoạn mái nhà. 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)

Phân vị về kích thước và ánh sáng mặt trời cho toàn bộ toà nhà, bao gồm cả những phần mái không được chỉ định cho một số phân đoạn mái. Vì hướng của các phần này không được xác định rõ ràng, nên thông tin ước tính về diện tích mái không đáng tin cậy, nhưng thông tin ước tính về diện tích mặt đất thì đáng tin cậy. Có thể thu được diện tích mái nhà đáng tin cậy hơn cho toàn bộ toà nhà bằng cách điều chỉnh diện tích mái nhà từ wholeRoofStats theo tỷ lệ diện tích mặt đất của buildingStats và wholeRoofStats.
roofSegmentStats[]

object (RoofSegmentSizeAndSunshineStats)

Phân vị về kích thước và ánh nắng mặt trời cho từng phân đoạn mái nhà.
solarPanels[]

object (SolarPanel)

Mỗi SolarPanel mô tả một tấm năng lượng mặt trời. Các bảng điều khiển được liệt kê theo thứ tự mà thuật toán bố cục bảng điều khiển đặt. Thứ tự này thường là thứ tự giảm dần của sản lượng 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ả một cách sắp xếp khác nhau của các tấm năng lượng mặt trời trên mái nhà. Các lựa chọn này được sắp xếp theo thứ tự tăng dần về số lượng tấm pin. 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 tấm pin có thể lắp vừa trên mái nhà.
financialAnalyses[]

object (FinancialAnalysis)

FinancialAnalysis cho biết mức tiết kiệm khi sử dụng năng lượng mặt trời, giả sử hoá đơn hằng tháng và nhà cung cấp điện là cố định. Các gói này được sắp xếp theo thứ tự tăng dần của 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à Solar API không có đủ thông tin để thực hiện tính toán tài chính.

SizeAndSunshineStats

Phân vị về kích thước và độ nắng của mái nhà hoặc một phần 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 của mái hoặc đoạn mái, tính bằng m^2. Đây là diện tích mái (có tính đến độ nghiêng), không phải diện tích mặt đất.
sunshineQuantiles[]

number

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

number

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

RoofSegmentSizeAndSunshineStats

Thông tin về kích thước và phân vị độ nắng của một đoạn mái nhà.

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à phân vị ánh sáng mặt trời cho phân đoạn mái nhà.
center

object (LatLng)

Một điểm gần tâm của đoạn mái.
boundingBox

object (LatLngBox)

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

number

Góc của đoạn mái nhà so với mặt phẳng đấ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à đoạn mái đang hướng tới. 0 = Bắc, 90 = Đông, 180 = Nam. Đối với phân đ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 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 đoạn mái, tính bằng mét so với mực nước biển, tại điểm được chỉ định bởi center. Cùng với độ dốc, 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 đoạn mái.

SolarPanel

SolarPanel mô tả vị trí, hướng và sản lượng của một tấm năng lượng mặt trời. Hãy xem các trường panelHeightMeters, panelWidthMeters và panelCapacityWatts trong SolarPotential để biết thông tin về các tham số của bảng điều khiển.

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

object (LatLng)

Tâm của bảng điều khiển.
orientation

enum (SolarPanelOrientation)

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

number

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

integer

Chỉ mục trong roofSegmentStats của RoofSegmentSizeAndSunshineStats tương ứng với phân đoạn mái nhà mà tấm pin này được đặt trên đó.

SolarPanelOrientation

Hướng của tấm năng lượng 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 đoạn mái mà tấm pin được đặt trên đó.

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

SolarPanelConfig

SolarPanelConfig mô tả một vị trí cụ thể của các tấm 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ố tấm pin. Xin lưu ý rằng thông tin này thừa so với (tổng của) các trường tương ứng trong roofSegmentSummaries.
yearlyEnergyDcKwh

number

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

object (RoofSegmentSummary)

Thông tin về hoạt động sản xuất của từng phân đoạn mái nhà có ít nhất một tấm pin trong bố cục này. roofSegmentSummaries[i] mô tả phân đoạn mái nhà thứ i, bao gồm kích thước, sản lượng dự kiến và hướng.

RoofSegmentSummary

Thông tin về một phân đoạn mái nhà trên toà nhà, trong đó có một số tấm pin đượ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 đoạn này.
yearlyEnergyDcKwh

number

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

number

Góc của đoạn mái nhà so với mặt phẳng đấ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à đoạn mái đang hướng tới. 0 = Bắc, 90 = Đông, 180 = Nam. Đối với phân đ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 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 bố cục năng lượng mặt trời tối ưu cho một mức 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à mức hoá đơn được chọn làm hoá đơn mặc định cho khu vực có toà nhà này hay không. Chỉ một FinancialAnalysis trong BuildingSolarPotential được đặt defaultBill.
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 số tiền trên hoá đơn và giá điện tại địa phương.
financialDetails

object (FinancialDetails)

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

object (LeasingSavings)

Chi phí và lợi ích của việc thuê tấm năng lượng mặt trời.
cashPurchaseSavings

object (CashPurchaseSavings)

Chi phí và lợi ích của việc mua tấm năng lượng mặt trời bằng tiền mặt.
financedPurchaseSavings

object (FinancedPurchaseSavings)

Chi phí và lợi ích của việc mua tấm năng lượng mặt trời bằng cách tài trợ cho giao dịch mua.
panelConfigIndex

integer

Chỉ mục trong solarPanelConfigs của bố cục năng lượng mặt trời tối ưu cho quy mô 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 thông báo phụ còn lại sẽ bị bỏ qua.

Tiền

Biểu thị 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ã tiền tệ gồm 3 chữ cái được xác định trong ISO 4217.
units

string (int64 format)

Đơn vị nguyên 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 số tiền. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999 (bao gồm cả hai giá trị này). 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, thì nanos có thể là số dương, số 0 hoặc số âm. Nếu units là số âm, thì nanos phải là số âm hoặc bằng 0. Ví dụ: -1,75 USD được biểu thị là units=-1 và nanos=-750.000.000.

FinancialDetails

Thông tin chi tiết về một bản phân tích tài chính. Một số thông tin chi tiết này đã được lưu trữ ở các cấp cao hơn (ví dụ: chi phí tự chi trả). Tổng số tiền là trong khoảng thời gian trọn đời được xác định bằng trường panelLifetimeYears trong SolarPotential. Lưu ý: Chi phí tự chi trả để mua các tấm pin được cung cấp trong trường outOfPocketCost bằng 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

Số kWh AC mà chúng tôi cho rằng các tấm pin năng lượng mặt trời sẽ tạo ra trong năm đầu tiên.
remainingLifetimeUtilityBill

object (Money)

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

object (Money)

Số tiền được hưởng từ các ưu đãi của liên bang; số tiền này áp dụng nếu người dùng mua (có hoặc không có khoản vay) các tấm pin.
stateIncentive

object (Money)

Số tiền được hưởng từ các ưu đãi của tiểu bang; số tiền này áp dụng nếu người dùng mua (có hoặc không có khoản vay) các tấm pin.
utilityIncentive

object (Money)

Số tiền có được từ các ưu đãi của công ty điện lực; số tiền này áp dụng nếu người dùng mua (có hoặc không có khoản vay) các tấm pin.
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 từ mặt trời trong suốt thời gian sử dụng của tấm pin; thông tin này áp dụng nếu người dùng mua (có hoặc không có khoản vay) tấm pin.
costOfElectricityWithoutSolar

object (Money)

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

boolean

Có cho phép sử dụng cơ chế bù trừ điện năng hay không.
solarPercentage

number

Tỷ lệ phần trăm (0-100) điện năng của người dùng được cung cấp bằng năng lượng mặt trời. Có hiệu lực trong năm đầu tiên nhưng gần đúng cho các năm sau.
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 là được xuất vào lưới điện, dựa trên quý sản xuất đầu tiên. Điều này ảnh hưởng đến kết quả tính toán nếu không được phép sử dụng cơ chế bù trừ điện năng.

LeasingSavings

Chi phí và lợi ích của việc thuê một cấu hình cụ thể của tấm 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

Liệu có được phép cho thuê ở khu vực tài phán này hay không (một số tiểu bang không cho phép cho thuê). Nếu trường này có giá trị false, thì có thể 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 hợp đồng thuê trong khu vực tài phán này hay không. Nếu trường này có giá trị false, thì có thể bạn nên bỏ qua các giá trị trong thông báo này. Điều này không phụ thuộc vào leasesAllowed: ở một số khu vực, việc cho thuê được cho phép, nhưng theo các điều kiện không được 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) trong suốt thời gian sử dụng.

SavingsOverTime

Thông tin tài chính được chia sẻ giữa các phương thức tài trợ 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)

Số tiền tiết kiệm được trong năm đầu tiên sau khi lắp đặt tấm pin.
savingsYear20

object (Money)

Số tiền tiết kiệm được trong 20 năm đầu tiên sau khi lắp đặt tấm pin.
presentValueOfSavingsYear20

object (Money)

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 20 năm là bao nhiêu?
savingsLifetime

object (Money)

Số tiền tiết kiệm được trong toàn bộ thời gian sử dụng tấm pin.
presentValueOfSavingsLifetime

object (Money)

Dựa trên 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 suốt thời gian sử dụng là bao nhiêu?
financiallyViable

boolean

Cho biết liệu kịch bản này có khả thi về mặt tài chính hay không. Sẽ là false đối với các trường hợp có khả năng tài chính kém (ví dụ: thua lỗ).

CashPurchaseSavings

Chi phí và lợi ích của việc mua trực tiếp một cấu hình cụ thể của tấm 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 
{
  "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 áp dụng ưu đãi thuế: số tiền phải tự chi trả. Trái ngược với upfrontCost, tức là sau khi áp dụng ưu đãi thuế.
upfrontCost

object (Money)

Chi phí ban đầu sau khi áp dụng ưu đãi thuế: đây là số tiền phải trả trong năm đầu tiên. Trái ngược với outOfPocketCost, tức là trước thuế ưu đãi.
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) trong suốt thời gian sử dụng.
paybackYears

number

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

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 tấm 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)

Khoản thanh toán hằng năm cho khoản vay.
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 của các khoản vay được giả định trong tập hợp các phép tính này.
savings

object (SavingsOverTime)

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

DetectedArrays

Thông tin về các mảng năng lượng mặt trời được phát hiện trên toà nhà.

Biểu diễn dưới dạng JSON 
{
  "detectionStatus": enum (DetectionStatus),
  "arrays": [
    {
      object (SolarArray)
    }
  ],
  "latestCaptureDate": {
    object (Date)
  }
}
Trường
detectionStatus

enum (DetectionStatus)

Cho biết trạng thái phát hiện mảng năng lượng mặt trời cho toà nhà này.
arrays[]

object (SolarArray)

Danh sách các mảng năng lượng mặt trời được phát hiện trên toà nhà.
latestCaptureDate

object (Date)

Ngày cho biết thời điểm thu thập dữ liệu mới nhất về mảng năng lượng mặt trời.

DetectionStatus

Cho biết trạng thái phát hiện mảng năng lượng mặt trời cho toà nhà này.

Enum
DETECTION_STATUS_UNSPECIFIED Trạng thái không xác định.
DETECTION_STATUS_DATA_UNAVAILABLE Không có dữ liệu về mảng năng lượng mặt trời được phát hiện cho toà nhà này.
DETECTION_STATUS_ARRAYS_DETECTED Đã phát hiện ít nhất một mảng năng lượng mặt trời cho toà nhà này.
DETECTION_STATUS_NO_ARRAYS_DETECTED Không phát hiện thấy mảng năng lượng mặt trời nào cho toà nhà này.

SolarArray

Thông tin chi tiết về một mảng năng lượng mặt trời được phát hiện.

Biểu diễn dưới dạng JSON 
{
  "polygonGeojson": {
    object
  }
}
Trường
polygonGeojson

object (Struct format)

Biểu diễn GeoJSON của khu vực toà nhà nơi phát hiện thấy tấm năng lượng mặt trời.

Dữ liệu GeoJSON phải ở định dạng RFC 7946 và đại diện cho một Đa giác cho một khu vực liền kề.

Đa giác sẽ được biểu thị bằng nhiều vòng lặp khi có lỗ.

Ví dụ:

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }