Điểm cuối dataLayers trả về dữ liệu được mã hoá dưới dạng tệp GeoTIFF. Bạn có thể 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ế các hệ thống năng lượng mặt trời.
Mỗi chuỗi trong phản hồi 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 được tạo từ yêu cầu lớp dữ liệu ban đầu. Các tệp GeoTIFF có thể đượ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. Bạn cũng không thể sử dụng trực tiếp các tệp GeoTIFF 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 | Nội dung 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 biểu thị địa hình bề mặt Trái Đất, bao gồm các đối tượng tự nhiên và đối tượng địa lý hình thành. Giá trị được tính theo mét trên mực nước biển. Các vị trí không hợp lệ hoặc những 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 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ị 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. |
| 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à 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 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 địa điểm, không chỉ là các mái nhà của toà nhà. Các vị trí không hợp lệ hoặc những khu vực mà chúng tôi không thể tính toán thông lượng sẽ được lưu trữ dưới dạng -9999. Các vị trí nằm 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 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 khu vực. Giá trị là kWh/kW/năm. Tệp hình ảnh GeoTIFF theo thứ tự chứa 12 dải tương ứng 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 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 31 ngày (tối đa) 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 đó, 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, 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ề kiến thức cơ bản về đường quét, hãy xem nội dung Khái niệm cơ bản về raster.
Khi yêu cầu dữ liệu bóng hằng giờ, bạn có thể nhận được tối đa 12 đường quét, một đường quét 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 (hoặc băng tần), 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 31 ngày (tối đa) trong tháng. Do đó, việc giải mã dữ liệu ngày, giờ và tháng của bóng đổ yêu cầu phải 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í cụ thể 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ứ 6 của năm, 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 giờ chiều (16 giờ), hãy 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.
- Các 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ờ nhất định hay không. Nếu bit là 1, vị trí đã nhìn thấy mặt trời. Nếu bit là 0, thì vị trí đã thấy bóng.
Mã sau đây tóm tắt các bước ở trên:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))