Điểm cuối dataLayers trả về dữ liệu được mã hoá dưới dạng tệp GeoTIFF. Bạn có thể sử dụng dữ liệu này trong mọi ứng dụng hệ thống thông tin địa lý (GIS) để thiết kế hệ thống năng lượng mặt trời.
Mỗi chuỗi trong phản hồi dataLayers chứa một URL. Bạn có thể sử dụng URL này để tìm nạp GeoTIFF tương ứng. URL có hiệu lực tối đa một giờ sau khi được tạo từ yêu cầu lớp dữ liệu gốc. Bạn có thể lưu trữ tệp GeoTIFF tối đa 30 ngày.
Ngoại trừ lớp RGB, tệp GeoTIFF không hiển thị chính xác với trình xem hình ảnh vì nội dung là dữ liệu được mã hoá chứ không phải hình ảnh RGB. Bạn cũng không thể sử dụng trực tiếp tệp GeoTIFF làm hình ảnh lớp phủ với Maps Javascript API.
Bảng sau đây mô tả chi tiết từng lớp.
| Lớp | Độ sâu pixel | Độ phân giải | Mô tả |
|---|---|---|---|
| Mô hình bề mặt kỹ thuật số (DSM) | Số thực 32 bit | 0,1 m/pixel | Dữ liệu độ cao thể hiện địa hình bề mặt Trái Đất, bao gồm cả các đặc điểm tự nhiên và nhân tạo. Giá trị tính bằng mét so với mực nước biển. Các vị trí không hợp lệ hoặc khu vực mà chúng tôi không có dữ liệu được lưu trữ dưới dạng -9999. |
| RGB | 8 bit | 0,1 m/pixel 0,25 m/pixel |
Hình ảnh vệ tinh hoặc hình ảnh từ trên không của khu vực. Tệp hình ảnh GeoTIFF chứa
ba dải tương ứng với các giá trị màu đỏ, xanh lục và xanh lam để tạo thành
giá trị RGB 24 bit cho mỗi pixel. Theo mặc định, độ phân giải pixel là 0,1 m/pixel. |
| Mặt nạ toà nhà | 1 bit | 0,1 m/pixel | Một bit cho mỗi pixel cho biết liệu pixel đó có được coi là một phần của mái nhà hay không. |
| Thông lượng hằng năm | Số thực 32 bit | 0,1 m/pixel | Bản đồ thông lượng hằng năm hoặc ánh sáng mặt trời hằng năm trên mái nhà của khu vực.
Giá trị là kWh/kW/năm. Thông lượng được tính cho mọi vị trí, không chỉ mái nhà. Các vị trí không hợp lệ hoặc khu vực mà chúng tôi không tính được thông lượng được lưu trữ dưới dạng -9999. Các vị trí bên ngoài khu vực phủ sóng của chúng tôi là không hợp lệ. Lưu ý: Đây là thông lượng không được che phủ. |
| Thông lượng hằng tháng | Số thực 32 bit | 0,5 m/pixel | Bản đồ thông lượng hằng tháng (ánh sáng mặt trời trên mái nhà, chia theo tháng) của khu vực. Giá trị là kWh/kW/năm. Tệp hình ảnh GeoTIFF chứa 12 dải tương ứng với tháng 1 đến tháng 12 theo thứ tự. |
| Bóng râm hằng giờ | Số nguyên 32 bit | 1 m/pixel | 12 URL cho bản đồ bóng râm hằng giờ tương ứng với tháng 1 đến tháng 12 theo thứ tự. Mỗi tệp GeoTIFF chứa 24 dải, tương ứng với 24 giờ trong ngày. Mỗi pixel là một số nguyên 32 bit, tương ứng với tối đa 31 ngày của tháng đó. 1 bit có nghĩa là vị trí tương ứng có thể nhìn thấy mặt trời vào ngày đó, giờ đó, tháng đó. Các vị trí không hợp lệ được lưu trữ dưới dạng -9999 và có bit 31 được đặt, vì bit đó tương ứng với ngày thứ 32 của tháng và do đó không hợp lệ. |
Giải mã raster bóng râm hằng giờ
Dữ liệu bóng râm hằng giờ được mã hoá trong raster nhiều dải. Để tìm hiểu thêm về các khái niệm cơ bản về raster, hãy xem bài viết Các khái niệm về Solar API.
Khi đưa ra yêu cầu về dữ liệu bóng râm hằng giờ, bạn có thể nhận được tối đa 12 raster, một cho mỗi tháng trong năm dương lịch (từ tháng 1 đến tháng 12). Mỗi raster bao gồm 24 lớp hoặc dải, tương ứng với 24 giờ trong ngày.
Mỗi dải được biểu thị bằng một ma trận ô hoặc pixel. Mỗi pixel có độ sâu 32 bit, tương ứng với tối đa 31 ngày của tháng. Do đó, để giải mã ngày, giờ và tháng của dữ liệu bóng râm, bạn cần hiểu rõ về bit, dải và raster mà bạn đang phân tích.
Ví dụ: để xác định xem một vị trí nhất định tại toạ độ (x, y) có nhìn thấy mặt trời vào lúc 4:00 chiều ngày 22 tháng 6 hay không, hãy làm như sau:
- Đưa ra yêu cầu về lớp dữ liệu cho tất cả các lớp cho vị trí (x, y).
- Vì tháng 6 là tháng thứ 6 trong năm, hãy tìm nạp URL thứ 6 trong danh sách
hourlyShadeUrls. - Dải hằng giờ được cung cấp theo thời gian 24 giờ. Để lấy dữ liệu cho 4:00 chiều (16:00), hãy tra cứu kênh thứ 17.
- Chỉ mục bit (ngày) bắt đầu từ 0. Để lấy dữ liệu cho ngày 22 tháng 6, hãy đọc bit 21.
- Bit cung cấp dữ liệu nhị phân cho biết liệu vị trí đó có nhìn thấy mặt trời vào ngày và giờ đã cho hay không. Nếu bit là 1, thì vị trí đó nhìn thấy mặt trời. Nếu bit là 0, thì vị trí đó nhìn thấy bóng râm.
Đoạn mã sau đây tóm tắt các bước ở trên:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))