REST Resource: dataLayers

Tài nguyên: DataLayers

Thông tin về tiềm năng năng lượng 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 phủ khu vực được yêu cầu, trong đó thông báo này chứa các 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. Những URL này 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,1 m/pixel, nhưng tệp thông lượng hằng tháng có độ phân giải 0,5 m/pixel và tệp bóng đổ hằng giờ có độ phân giải 1 m/pixel. Nếu bạn chỉ định giá trị pixelSizeMeters trong GetDataLayersRequest, thì độ phân giải tối thiểu trong 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 chụp ảnh nguồn (tất cả dữ liệu khác đều được lấy từ ảnh này) ở khu vực này. Đây chỉ là thông tin tương đối, vì hình ảnh có thể được chụp trong nhiều ngày.
imageryProcessedDate

object (Date)

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

string

URL của 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 so với hình cầu giả định 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.
rgbUrl

string

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

string

URL cho hình ảnh mặt nạ của 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.
annualFluxUrl

string

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

string

URL cho bản đồ bức xạ mặt trời hằng tháng (ánh sáng mặt trời 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 tần, tương ứng với tháng 1 đến tháng 12 theo thứ tự.
hourlyShadeUrls[]

string

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

Ví dụ có thể sẽ hữu ích. Nếu muốn biết 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 có thể:

  1. tìm nạp URL thứ sáu trong danh sách này (tương ứng với tháng 6).
  2. tìm 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í đó có ánh nắng mặt trời lúc 4 giờ chiều ngày 22 tháng 6.

Cụ thể hơn: Cho trước month (1-12), day (1...tối đa số ngày trong tháng; tháng 2 có 28 ngày) và hour (0-23), bóng râm/ánh nắng cho 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] đề cập đến việc tìm nạp URL thứ month - 1 (lập chỉ mục từ 0), [hour] là 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à "trời nắng". Không có ngày nhuận và không có giờ tiết kiệm ánh sáng ban ngày (tất cả các ngày đều dài 24 giờ; buổi trưa luôn là buổi trưa "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 nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không quan trọng. Ngày này có liên quan đến Dương lịch. Nội dung đặc tả này có thể xuất hiện dưới dạng một trong những nội dung sau:

  • Một 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 giá trị năm bằng 0 (ví dụ: ngày kỷ niệm).
  • Chỉ riêng giá trị năm, với giá trị tháng và ngày bằng 0.
  • Năm và tháng, với giá trị ngày bằng 0 (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. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Giá trị 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 bằng 0 để chỉ định một năm hoặc một năm và tháng, trong đó ngày là không quan trọng.

ImageryQuality

Chất lượng của hình ảnh được 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, đầu ra thông lượng 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 Không xác định được chất lượng.
HIGH Dữ liệu về năng lượng mặt trời được lấy từ hình ảnh chụp từ trên không ở độ cao thấp và được xử lý ở độ phân giải 0,1 m/pixel.
MEDIUM Dữ liệu về năng lượng mặt trời được lấy từ hình ảnh chụp từ trên không có độ phân giải cao và được xử lý ở mức 0,25 m/pixel.
BASE Dữ liệu về năng lượng mặt trời được lấy từ hình ảnh vệ tinh nâng cao được xử lý ở mức 0,25 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í.