- Yêu cầu HTTP
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- LatLngBox
- SolarPotential
- SizeAndSunshineStats
- RoofSegmentSizeAndSunshineStats
- SolarPanel
- SolarPanelOrientation
- SolarPanelConfig
- RoofSegmentSummary
- FinancialAnalysis
- Tiền
- FinancialDetails (Thông tin tài chính)
- LeasingSavings
- SavingsOverTime
- CashPurchaseSavings
- FinancedPurchaseSavings
- Hãy làm thử!
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 |
Bắt buộc. Kinh độ và vĩ độ mà API tìm kiếm toà nhà gần nhất đã biết. |
requiredQuality |
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 ( |
Trường | |
---|---|
name |
Tên tài nguyên cho toà nhà, có định dạng |
center |
Một điểm gần trung tâm của toà nhà. |
boundingBox |
Hộp giới hạn của toà nhà. |
imageryDate |
Ngày thu thập hình ảnh cơ bản. Đây là con số gần đúng. |
imageryProcessedDate |
Khi quá trình xử lý hình ảnh này hoàn tất. |
postalCode |
Mã bưu chính (ví dụ: Hoa Kỳ) có của toà nhà này. |
administrativeArea |
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 |
Khu vực thống kê (ví dụ: Đường điều tra dân số Hoa Kỳ) có toà nhà này. |
regionCode |
Mã vùng của quốc gia (hoặc khu vực) có toà nhà này. |
solarPotential |
Tiềm năng điện mặt trời của toà nhà. |
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 ( |
Trường | |
---|---|
sw |
Góc phía Tây Nam của hộp. |
ne |
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 ( |
Trường | |
---|---|
maxArrayPanelsCount |
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 |
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 |
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 |
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 |
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 |
Kích thước của mảng tối đa, tính bằng mét vuông. |
maxSunshineHoursPerYear |
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 |
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 |
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 |
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ừ |
roofSegmentStats[] |
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[] |
Mỗi |
solarPanelConfigs[] |
Mỗi |
financialAnalyses[] |
|
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 |
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[] |
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ư |
groundAreaMeters2 |
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 ( |
Trường | |
---|---|
stats |
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 |
Một điểm gần tâm của phần mái nhà. |
boundingBox |
Hộp giới hạn của đoạn mái. |
pitchDegrees |
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 |
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" ( |
planeHeightAtCenterMeters |
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 |
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 ( |
Trường | |
---|---|
center |
Giữa bảng điều khiển. |
orientation |
Hướng bảng điều khiển. |
yearlyEnergyDcKwh |
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 |
Chỉ mục trong |
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 ( |
Trường | |
---|---|
panelsCount |
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 |
yearlyEnergyDcKwh |
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[] |
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. |
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 |
Tổng số bảng điều khiển trên phân khúc này. |
yearlyEnergyDcKwh |
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 |
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 |
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" ( |
segmentIndex |
Chỉ mục trong |
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 ( |
Trường | |
---|---|
monthlyBill |
Hoá đơn tiền điện hằng tháng mà bản phân tích này giả định. |
defaultBill |
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 |
averageKwhPerMonth |
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 |
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 |
Chi phí và lợi ích khi thuê tấm pin năng lượng mặt trời. |
cashPurchaseSavings |
Chi phí và lợi ích khi mua tấm pin mặt trời bằng tiền mặt. |
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 |
Chỉ số trong |
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 |
Mã đơn vị tiền tệ gồm ba chữ cái được xác định trong ISO 4217. |
units |
Toàn bộ đơn vị của số tiền. Ví dụ: nếu |
nanos |
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 |
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 ( |
Trường | |
---|---|
initialAcKwhPerYear |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Liệu có cho phép định mức ròng hay không. |
solarPercentage |
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 |
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 ( |
Trường | |
---|---|
leasesAllowed |
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 |
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 |
annualLeasingCost |
Chi phí thuê ước tính hằng năm. |
savings |
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 ( |
Trường | |
---|---|
savingsYear1 |
Tiết kiệm trong năm đầu tiên sau khi lắp đặt bảng điều khiển. |
savingsYear20 |
Tiết kiệm trong 20 năm đầu tiên sau khi lắp đặt bảng điều khiển. |
presentValueOfSavingsYear20 |
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 |
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 |
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 |
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 ( |
Trường | |
---|---|
outOfPocketCost |
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 |
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 |
rebateValue |
Giá trị của tất cả các khoản hoàn thuế. |
savings |
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 |
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 ( |
Trường | |
---|---|
annualLoanPayment |
Thanh toán khoản vay hằng năm. |
rebateValue |
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 |
Lãi suất khoản vay được giả định trong tập hợp tính toán này. |
savings |
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. |