Điểm cuối dataLayers trả về dữ liệu được mã hoá dưới dạng tệp GeoTIFF, có thể được sử dụng ở bất kỳ ứng dụng hệ thống thông tin (GIS) để thiết kế hệ thống năng lượng mặt trời.
Mỗi chuỗi trong thông tin phản hồi của dataLayer 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 trong tối đa một giờ sau khi chúng được tạo từ yêu cầu lớp dữ liệu ban đầu. Các tệp GeoTIFF có thể là được lưu trữ trong 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 với trình xem hình ảnh, vì nội dung được mã hoá dữ liệu chứ không phải hình ảnh RGB. GeoTIFF cũng không thể sử dụng trực tiếp tệp dưới dạng hình ảnh lớp phủ với API JavaScript của Maps.
Bảng sau đây mô tả chi tiết về 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. Giá trị tính theo mét so với mặt biển cấp độ. Vị trí không hợp lệ hoặc những khu vực nơi 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 0,5 m/pixel 1 m/pixel |
Hình ảnh khu vực từ trên không. Tệp hình ảnh GeoTIFF chứa 3 dải tương ứng với các giá trị đỏ, 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. |
| Mặt nạ toà nhà | 1 bit | 0,1 m/pixel | Một bit trên mỗi pixel cho biết liệu pixel đó có được coi là của mái nhà. |
| 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 nắng 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 toán cho mọi vị trí, chứ không phải chỉ xây dựng những mái nhà. Vị trí không hợp lệ hoặc những khu vực chúng tôi không thể tính thông lượng, được lưu trữ dưới dạng -9999. Vị trí bên ngoài khu vực bao phủ không hợp lệ. Lưu ý: Đây là thông lượng không được che giấu. |
| 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 nắng trên mái nhà, được chia nhỏ theo tháng) của . Giá trị là kWh/kW/năm. Tệp hình ảnh GeoTIFF chứa 12 theo thứ tự từ tháng 1 đến tháng 12. |
| Màu sắc theo giờ | Số nguyên 32 bit | 1 m/pixel | 12 URL cho bản đồ bóng đổ theo giờ tương ứng từ tháng 1 đến tháng 12, theo
đơn đặt hàng. 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 đó. Vị trí không hợp lệ được lưu trữ dưới dạng -9999 và có bit 31 được đặt, dưới dạng tương ứng với ngày thứ 32 của tháng nên không hợp lệ. |
Giải mã đường quét bóng theo giờ
Dữ liệu bóng hằng giờ được mã hoá trong đường quét nhiều băng tần. Để tìm hiểu thêm về đường quét kiến thức cơ bản, hãy xem Khái niệm về API năng lượng mặt trời.
Khi yêu cầu dữ liệu bóng theo giờ, bạn có thể nhận được tối đa 12 đường quét, một chiến dịch cho mỗi tháng trong năm dương lịch (từ tháng 1 đến tháng 12). Mỗi đường quét bao gồm 24 lớp (hay còn gọi là các dải), tương ứng với 24 giờ của ngày.
Mỗi dải được biểu thị bằng một ma trận ô hoặc pixel. Mỗi pixel có một chiều sâu 32 bit, tương ứng với 31 ngày (tối đa) trong tháng. Do đó, cần phải giải mã ngày, giờ và tháng của dữ liệu bóng hiểu bit, dải 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, hãy làm những việc 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ứ 6 trong năm, nên hãy tìm nạp URL thứ 6 trong danh sách
hourlyShadeUrls. - Dây đeo theo giờ được chọn theo khung giờ 24 giờ. Để nhận dữ liệu cho 4:00 chiều (16:00), tra cứu kênh thứ 17.
- Chỉ mục bit (ngày) từ 0. Để nhận 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 ở ngày và giờ nhất định. Nếu bit là 1, vị trí đã nhìn thấy mặt trời. Nếu bit là 0, 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))