API năng lượng mặt trời sử dụng dữ liệu địa điểm để xác định loại toà nhà và xác định
toà nhà dựa trên hình ảnh vệ tinh. Trang này mô tả cách xác định
thông tin về năng lượng mặt trời của toà nhà được trả về trong một
buildingInsights
yêu cầu.
Loại toà nhà
năng lượng mặt trời API hỗ trợ các loại toà nhà
premise
. Loại này cho biết một vị trí được đặt tên, thường là một toà nhà hoặc một tập hợp các toà nhà có tên chung.
Các loại khác, chẳng hạn như subpremise
hoặc các khu phức hợp (ví dụ: các toà nhà riêng biệt nằm trên một tài sản, trừ phi được đăng ký là premise
) sẽ không được hỗ trợ.
Mái nhà
API Năng lượng mặt trời xác định vị trí đặt tấm pin năng lượng mặt trời trên mái nhà tối ưu dựa trên hình ảnh vệ tinh. Toà nhà dân dụng, đặc biệt là toà nhà nghiêng hoặc dốc mái, được xác định với độ chính xác cao, trong khi đó những toà nhà có mái bằng mái nhà (ví dụ: toà nhà chung cư hoặc toà nhà thương mại) có thể khác nhau về độ chính xác.
Tìm kiếm từ một địa chỉ
Bạn có thể chuyển đổi địa chỉ thành toạ độ vĩ độ và kinh độ bằng cách sử dụng API Mã hoá địa lý hoặc API Tự động hoàn thành địa điểm.
Sử dụng
place_id
để tham chiếu đến địa điểm phù hợp.Dùng toạ độ theo vĩ độ và kinh độ của địa điểm trong API năng lượng mặt trời của bạn
buildingInsights
yêu cầu.- Nếu Sun API tìm thấy một toà nhà phù hợp, hãy kiểm tra xem
place_id
trong phản hồibuildingInsights
khớp vớiplace_id
từ API mã hoá địa lý hoặc API tự động hoàn thành địa điểm. - Để giới hạn kết quả ở những địa điểm có loại
premise
, hãy thêm bộ lọc loại địa điểm vào các phản hồi của API Địa chỉ và địa điểm hoặc API Địa điểm.{ "name": "buildings/ChIJh0CMPQW7j4ARLrRiVvmg6Vs", "center": { "latitude": 37.4449739, "longitude": -122.13914659999998 },... }
- Nếu Sun API tìm thấy một toà nhà phù hợp, hãy kiểm tra xem
Bạn có thể sử dụng ứng dụng mẫu nguồn mở hoặc tạo yêu cầu buildingInsights
để kiểm tra place_id
cho các toà nhà thuộc phạm vi của API Điện mặt trời.
Chọn một vị trí trên bản đồ
Bạn cũng có thể cung cấp trải nghiệm bổ sung bằng cách cho phép người dùng chọn
toà nhà trên bản đồ bằng API Maps JavaScript. Trích xuất vĩ độ và kinh độ của toà nhà từ sự kiện chuột, sau đó truyền các toạ độ đó vào yêu cầu buildingInsights
.