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 các 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 yêu cầu buildingInsights
.
Các loại toà nhà
API năng lượng mặt trời hỗ trợ các toà nhà thuộc loại
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 phổ biến.
Các loại khác (chẳng hạn như subpremise
hoặc tổ hợp – ví dụ: toà nhà riêng biệt nằm trên một tài sản duy nhất, trừ phi được đăng ký dưới dạng premise
) sẽ không được hỗ trợ.
Mái nhà
năng lượng mặt trời API xác định vị trí tối ưu của tấm pin năng lượng mặt trời trên mái nhà dựa trên hình ảnh vệ tinh. Các toà nhà để ở, đặc biệt là mái nghiêng hoặc nghiêng, được xác định với độ chính xác cao, trong khi các toà nhà có mái bằng (ví dụ: toà nhà chung cư hoặc toà nhà thương mại) có thể thay đổi về độ chính xác.
Tìm kiếm từ địa chỉ
Bạn có thể chuyển đổi một địa chỉ thành toạ độ theo 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.Sử dụng toạ độ theo vĩ độ và kinh độ của địa điểm trong yêu cầu của API năng lượng mặt trời
buildingInsights
.- Nếu Sun API tìm thấy một toà nhà phù hợp, hãy kiểm tra để đảm bảo rằng
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ả cho các địa điểm thuộc loại
premise
, hãy thêm bộ lọc loại địa điểm vào API mã hoá địa lý hoặc phản hồi của 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 để đảm bảo rằng
Bạn có thể dùng ứng dụng mẫu nguồn mở hoặc thực hiện một yêu cầu buildingInsights
để kiểm tra place_id
cho các toà nhà được bảo vệ bằng API năng lượng mặt trời.
Chọn một vị trí trên bản đồ
Bạn cũng có thể cung cấp một 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 cách sử dụ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
.