REST Resource: dataLayers

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

object (Date)

Thời điểm hình ảnh nguồn (mà tất cả các dữ liệu khác được lấy) trong khu vực này được chụp. Số liệu này nhất thiết phải là gần đúng vì bạn có thể đã chụp các hình ảnh này nhiều hơn một ngày.

object (Date)

Hình ảnh này đã được xử lý xong.

string

URL của hình ảnh DSM (Mô hình nền tảng kỹ thuật số) của khu vực. Giá trị được tính bằng mét trên độ địa lý của EGM96 (tức là mực nước biển). Vị trí không hợp lệ (nơi chúng tôi không có dữ liệu) được lưu trữ dưới dạng -9999.

string

URL của hình ảnh dữ liệu RGB (ảnh trên không) của khu vực.

string

URL cho hình ảnh mặt nạ toà nhà: 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.

string

URL cho bản đồ thông lượng hằng năm (nắ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. Đây là thông lượng không được che giấu: thông lượng được tính toán cho mọi vị trí, không chỉ riêng các mái nhà của toà nhà. Các vị trí không hợp lệ được lưu trữ dưới dạng -9999: các vị trí bên ngoài vùng phủ sóng của chúng tôi sẽ không hợp lệ và một vài vị trí bên trong vùng phủ sóng mà chúng tôi không thể tính được thông lượng, cũng sẽ không hợp lệ.

string

URL cho bản đồ thông lượng hằng tháng (ánh nắng trên mái nhà, chia theo tháng) của khu vực. Giá trị là kWh/kW/năm. GeoTIFF mà URL này trỏ đến sẽ chứa 12 dải, theo thứ tự từ tháng 1 đến tháng 12.

string

12 URL cho khối theo giờ, tương ứng với tháng 1...tháng 12 theo thứ tự. Mỗi GeoTIFF sẽ chứa 24 băng tần, 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 (lên đến) 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ờ đó, trong tháng đó. Vị trí không hợp lệ được lưu trữ dưới dạng -9999 (vì giá trị này là số âm nên giá trị này có tập bit 31 và không có giá trị hợp lệ nào có thể có bit 31 được đặt vì giá trị đó tương ứng với ngày thứ 32 của tháng).

Bạn có thể thấy một ví dụ hữu ích. Nếu bạn muốn biết liệu một điểm (tại vị trí pixel (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, bạn sẽ:

1. tìm nạp URL thứ sáu trong danh sách này (tương ứng với tháng 6).
2. tra cứu kênh thứ 17 (tương ứng với 4 giờ chiều).
3. đọc giá trị 32 bit tại (x, y).
4. đọc bit 21 của giá trị (tương ứng với ngày 22 của tháng).
5. nếu đó là 1, thì điểm đó đã thấy mặt trời lúc 4 giờ chiều ngày 22 tháng 6.

Chính thức hơn: Cho trước month (1-12), day (tối đa 1...tháng; Tháng 2 có 28 ngày) và hour (0-23), bóng/mặt trời của tháng/ngày/giờ đó tại vị trí (x, y) là bit

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

trong đó (x, y) là lập chỉ mục không gian, [month - 1] là tìm nạp URL thứ month - 1 (lập chỉ mục từ 0), [hour] đang lập chỉ mục vào các kênh và kết quả cuối cùng khác 0 có nghĩa là "không hài lòng". Không có ngày nhuận và DST không tồn tại (tất cả các ngày đều dài 24 giờ; buổi trưa luôn là buổi trưa theo "giờ chuẩn").

enum (ImageryQuality)

Chất lượng hình ảnh của kết quả.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc bằng 0 để chỉ định một năm không có tháng và ngày.

integer

Ngày trong tháng. Phải có giá trị từ 1 đến 31 và có giá trị hợp lệ trong năm và tháng, hoặc bằng 0 để chỉ định một năm độc lập hoặc là một năm và tháng mà ngày không quan trọng.