Đ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 tệp 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 mà bạn có thể sử dụng để 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 ban đầu. Tệp GeoTIFF có thể được lưu trữ tối đa 30 ngày.
Ngoại trừ lớp RGB, các tệp GeoTIFF không hiển thị chính xác bằng trình xem hình ảnh, vì nội dung là dữ liệu được mã hoá thay vì hình ảnh RGB. Bạn cũng không thể sử dụng trực tiếp các tệp GeoTIFF làm hình ảnh lớp phủ bằng API JavaScript của Maps.
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 của bề mặt Trái Đất, bao gồm cả các đặc điểm tự nhiên và nhân tạo. Các giá trị được tính bằng mét trên 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 sẽ được lưu trữ dưới dạng -9999. |
| RGB | 8 bit | 0,1 m/pixel 0,25 m/pixel 0,5 m/pixel 1 m/pixel |
Hình ảnh chụp từ trên cao về khu vực. Tệp hình ảnh GeoTIFF chứa 3 dải tương ứng với các giá trị màu đỏ, xanh lục và xanh dương để 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. |
| Tạo mặt nạ | 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. |
| Lượng khí thải hằng năm | Số thực 32 bit | 0,1 m/pixel | Bản đồ cường độ bức xạ hằng năm hoặc lượng á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. Lượng khí thải được tính toán 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 thể tính toán được dòng chảy sẽ được lưu trữ dưới dạng -9999. Các địa điểm nằm ngoài khu vực hoạt động của chúng tôi là không hợp lệ. Lưu ý: Đây là luồng không bị che khuất. |
| Lưu lượng hằng tháng | Số thực 32 bit | 0,5 m/pixel | Bản đồ cường độ bức xạ hằng tháng (ánh sáng mặt trời chiếu vào mái nhà, được phân tích theo tháng) của khu vực. Giá trị là kWh/kW/năm. Tệp hình ảnh GeoTIFF chứa 12 băng tương ứng với tháng 1 – tháng 12 theo thứ tự. |
| Độ bóng theo giờ | Số nguyên 32 bit | 1 m/pixel | 12 URL cho bản đồ bóng đổ theo giờ tương ứng với tháng 1 – 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 trong 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 đó, vào giờ đó, trong tháng đó. Các vị trí không hợp lệ được lưu trữ dưới dạng -9999 và đặt bit 31, vì giá trị này tương ứng với ngày thứ 32 của tháng và do đó không hợp lệ. |
Giải mã các đường quét bóng hằng giờ
Dữ liệu bóng theo giờ được mã hoá trong các điểm ảnh đa băng. Để tìm hiểu thêm về các khái niệm cơ bản về ảnh quét, hãy xem phần Khái niệm về API năng lượng mặt trời.
Khi yêu cầu dữ liệu bóng mỗi giờ, bạn có thể nhận được tối đa 12 ảnh quét, mỗi ảnh cho một tháng trong năm dương lịch (từ tháng 1 đến tháng 12). Mỗi ảnh quét được tạo thành từ 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 các ô hoặc pixel. Mỗi pixel có độ sâu 32 bit, tương ứng với 31 ngày (tối đa) trong 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 bit, băng tần và đường quét 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 lúc 4 giờ chiều ngày 22 tháng 6 hay không, hãy làm như sau:
- Tạo yêu cầu 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ứ sáu trong năm, nên hãy tìm nạp URL thứ sáu trong danh sách
hourlyShadeUrls. - Các dải giờ được cung cấp theo giờ 24 giờ. Để lấy dữ liệu cho 4 giờ chiều (16:00), hãy tra cứu kênh thứ 17.
- Chỉ mục bit (ngày) 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 này là 0, thì vị trí đó đã có bóng râm.
Mã sau đây tóm tắt các bước ở trên:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))