REST Resource: dataLayers

Tài nguyên: Lớp dữ liệu

Thông tin về tiềm năng điện mặt trời của một khu vực. Dữ liệu thực tế có trong một số tệp GeoTIFF bao gồm khu vực được yêu cầu, trong đó thông báo này chứa URL: Mỗi chuỗi trong thông báo DataLayers chứa một URL mà từ đó có thể tìm nạp GeoTIFF tương ứng. Các URL này chỉ có hiệu lực trong vài giờ sau khi được tạo. Hầu hết các tệp GeoTIFF đều có độ phân giải 0,1m/pixel, nhưng tệp thông lượng hàng tháng ở mức 0,5m/pixel và các tệp bóng hàng giờ ở mức 1m/pixel. Nếu giá trị pixelSizeMeters được chỉ định trong GetDataLayersRequest, thì độ phân giải tối thiểu trong các tệp GeoTIFF sẽ là giá trị đó.

Biểu diễn dưới dạng JSON 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
Trường
imageryDate

object (Date)

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

object (Date)

Thời điểm xử lý xong hình ảnh này.
dsmUrl

string

URL cho hình ảnh DSM (Mô hình bề mặt kỹ thuật số) của khu vực. Các giá trị được tính bằng mét trên EGM96 geoid (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.
rgbUrl

string

URL cho hình ảnh dữ liệu RGB (ảnh chụp từ trên cao) của khu vực.
maskUrl

string

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

string

URL cho bản đồ thông lượng hàng năm (ánh nắng 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 công nhận: thông lượng được tính cho mọi vị trí, không chỉ cho mỗi 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, nơi chúng tôi không thể tính toán thông lượng, cũng sẽ không hợp lệ.
monthlyFluxUrl

string

URL cho 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. GeoTIFF được chỉ ra trong URL này sẽ bao gồm 12 ban nhạc, tương ứng với tháng 1...tháng 12, theo thứ tự.
hourlyShadeUrls[]

string

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

Ví dụ có thể 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ứ 6 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 bit đó là 1, thì vị trí đó đã nhìn thấy mặt trời lúc 4 giờ chiều ngày 22 tháng 6.

Chính thức hơn: Với 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 cho tháng/ngày/giờ đó tại vị trí (x, y) là giá trị 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] dùng để tìm nạp URL thứ month - 1 (lập chỉ mục từ 0), [hour] đang lập chỉ mục đến các kênh và kết quả cuối cùng khác 0 nghĩa là "trời nắng". Không có ngày nhuận và DST không tồn tại (tất cả các ngày đều kéo dài 24 giờ; buổi trưa luôn là "giờ chuẩn").
imageryQuality

enum (ImageryQuality)

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

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không đáng kể. Ngày này có liên quan đến Dương lịch. Điều này có thể đại diện cho một trong những điều sau:

  • Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, với năm 0 (ví dụ: ngày kỷ niệm).
  • Chỉ có một năm, có một tháng không có ngày nào.
  • Năm và tháng, không có ngày (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại có liên quan:

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày tháng. Phải từ 1 đến 9999 hoặc 0 để chỉ định ngày không có năm.
month

integer

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

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc 0 để chỉ định một năm hoặc một năm và tháng không có ngày quan trọng.

ImageryQuality

Chất lượng hình ảnh dùng để tính toán một số kết quả API.

Lưu ý: Bất kể mức chất lượng hình ảnh, đầu ra DSM luôn có độ phân giải 0,1 m/pixel, thông lượng đầu ra hàng tháng luôn có độ phân giải 0,5 m/pixel và đầu ra bóng hàng giờ luôn có độ phân giải 1 m/pixel.

Enum
IMAGERY_QUALITY_UNSPECIFIED Chưa xác định chất lượng.
HIGH Hình ảnh cơ bản và dữ liệu DSM được xử lý ở tốc độ 0,1 m/pixel.
MEDIUM Hình ảnh bên dưới và dữ liệu DSM được xử lý ở tốc độ 0,25 m/pixel.
LOW Hình ảnh bên dưới và dữ liệu DSM được xử lý ở tốc độ 0,5 m/pixel.

Phương thức

get

 Nhận thông tin về năng lượng mặt trời cho một khu vực xung quanh một vị trí.