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ế nằm 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 tin về luồng ánh sáng hằng tháng có độ phân giải 0,5 m/pixel và tệp thông tin về bóng râm 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ất cả dữ liệu khác được lấy) ở khu vực này. Thông tin này có thể chỉ mang tính tương đối vì hình ảnh có thể được chụp trong nhiều ngày.
imageryProcessedDate

object (Date)

Thời điểm hoàn tất quá trình xử lý 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 trên geoid EGM96 (tức là mực nước biển). Các 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 trên không) của khu vực.
maskUrl

string

URL của 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.
annualFluxUrl

string

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

string

URL của bản đồ cường độ bức xạ mặt trời hằng tháng (ánh sáng mặt trời chiếu vào mái nhà, được phân tích theo tháng) của khu vực. Giá trị là kWh/kW/năm. GeoTIFF được trỏ đến bằng URL này sẽ chứa 12 dải, tương ứng với tháng 1...tháng 12 theo thứ tự.
hourlyShadeUrls[]

string

12 URL cho màu sắc 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ươ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, giờ và tháng đó. Các vị trí không hợp lệ được lưu trữ dưới dạng -9999 (vì giá trị này là âm, nên 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).

Sau đây là một ví dụ có thể hữu ích. Nếu muốn biết liệu một điểm (ở 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 trong 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 (1...tháng tối đa; tháng 2 có 28 ngày) và hour (0-23), bóng râm/mặt trời cho tháng/ngày/giờ đó ở 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 month - 1st (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à "có nắng". Không có ngày nhuận và không có giờ mùa hè (mọi ngày đều dài 24 giờ; buổi trưa luôn là buổi trưa theo "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 Lịch Gregorian. Giá trị này có thể biểu thị 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 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 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 bằng 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 giá trị 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 dùng để tính toán một số kết quả API.

Lưu ý: Bất kể cấp chất lượng hình ảnh, đầu ra DSM luôn có độ phân giải là 0,1 m/pixel, đầu ra dòng chảy hằng tháng luôn có độ phân giải là 0,5 m/pixel và đầu ra bóng râm hằng giờ luôn có độ phân giải là 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 cao ở độ cao thấp và được xử lý ở tỷ lệ 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 cao được nâng cao, chụp ở độ cao lớn và được xử lý ở tỷ lệ 0,25 m/pixel.
LOW 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ý ở tỷ lệ 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í.