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 ( |
Trường | |
---|---|
imageryDate |
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 |
Thời điểm xử lý xong hình ảnh này. |
dsmUrl |
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 |
URL cho hình ảnh dữ liệu RGB (ảnh chụp từ trên cao) của khu vực. |
maskUrl |
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 |
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 |
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[] |
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ẽ:
Chính thức hơn: Với
trong đó |
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:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Biểu diễn dưới dạng JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Trường | |
---|---|
year |
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 |
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 |
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 |
|
---|---|
|
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í. |