REST Resource: dataLayers

資源：DataLayers

某個地區的太陽能發電潛力相關資訊。實際資料包含在涵蓋要求區域的多個 GeoTIFF 檔案中，此訊息包含這些檔案的網址：DataLayers 訊息中的每個字串都包含一個網址，可用來擷取對應的 GeoTIFF。這些網址在產生後的幾小時內有效。大多數的 GeoTIFF 檔案解析度為 0.1 公尺/像素，但月度通量檔案的解析度為 0.5 公尺/像素，每小時陰影檔案的解析度則為 1 公尺/像素。如果在 GetDataLayersRequest 中指定 pixelSizeMeters 值，則 GeoTIFF 檔案中的最低解析度會是該值。

JSON 表示法 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
欄位
imageryDate

object (Date)

這個區域的來源圖像 (所有其他資料皆源自此) 拍攝時間。由於圖片可能在多天內拍攝，因此這項資訊僅供參考。
imageryProcessedDate

object (Date)

這張圖像的處理作業完成時間。
dsmUrl

string

該區域的 DSM (數位地形模型) 圖片網址。值以 EGM96 地理編碼 (即海平面) 為單位。無效位置 (我們沒有資料的地區) 會儲存為 -9999。
rgbUrl

string

該區域 RGB 資料 (航空照相) 圖片的網址。
maskUrl

string

建築物遮罩圖片的網址：每個像素一個位元，指出該像素是否屬於屋頂。
annualFluxUrl

string

該地區的年度動態地圖 (屋頂年度日照) 網址。值為 kWh/kW/年。這是未遮蔽的流量：系統會為每個位置計算流量，而非僅限於建築物屋頂。無效位置會以 -9999 儲存：涵蓋範圍外的地點會視為無效，而涵蓋範圍內無法計算流量的部分地點也會視為無效。
monthlyFluxUrl

string

該地區每月流量地圖 (屋頂日照，按月份細分) 的網址。值為 kWh/kW/年。這個網址所指向的 GeoTIFF 會包含十二個頻帶，依序對應至 1 月至 12 月。
hourlyShadeUrls[]

string

十二個小時陰影網址，依序對應至 1 月至 12 月。每個 GeoTIFF 都會包含 24 個頻帶，對應一天的 24 小時。每個像素都是 32 位元整數，對應到該月份 (最多) 31 天的時間點；1 位元代表對應位置在該月份的某一天、某個小時可見太陽。無效的位置會儲存為 -9999 (因為這個值為負值，因此會設為位元 31，且沒有有效值會設為位元 31，因為這會對應到該月的 32 日)。

舉例來說，如要知道某個點 (位於像素位置 (x, y)) 是否在 6 月 22 日下午 4 點看到太陽，請執行下列操作：

  1. 擷取清單中的第六個網址 (對應月份為六月)。
  2. 查看第 17 個頻道 (對應於下午 4 點)。
  3. 讀取 (x, y) 處的 32 位元值。
  4. 讀取值的位元 21 (對應於當月的 22 日)。
  5. 如果該位元是 1，表示該地點在 6 月 22 日下午 4 點看到太陽。

更正式的說法：假設 month (1-12)、day (1...月最大值；2 月有 28 天) 和 hour (0-23)，則該月/日/小時在 (x, y) 位置的陰影/太陽為位元

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

其中 (x, y) 是空間索引，[month - 1] 是指擷取 month - 1 個網址 (從 0 開始索引)，[hour] 是指在管道中建立索引，而最後的非零結果則代表「sunny」。沒有閏日，也沒有夏令時間 (所有日子都是 24 小時；中午一律是「標準時間」中午)。
imageryQuality

enum (ImageryQuality)

結果圖像的品質。

日期

表示完整或部分的日曆日期，例如生日。您可以視重要性決定是否要在別處指定時段和時區。日期以公曆為主，可代表下列任一項目：

  • 完整日期，具有非零的年、月和日值。
  • 月和日值，年值為零 (例如週年紀念日)。
  • 只有年，月和日值為零。
  • 年和月，日值為零 (例如信用卡到期日)。

相關類型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
欄位
year

integer

日期的年份。必須為 1 到 9999；如要指定不含年份的日期，請輸入 0。
month

integer

月份。必須為 1 到 12；如要指定不含日期的年份，請輸入 0。
day

integer

月中的日期。必須為 1 到 31，並屬於有效的年和月；如果只指定年份，或只指定年份和月份，而不指定當月第幾日的話，請輸入 0。

ImageryQuality

用於計算部分 API 結果的影像品質。

注意：無論圖像品質等級為何，DSM 輸出結果一律為 0.1 公尺/像素，月流量輸出結果一律為 0.5 公尺/像素，每小時陰影輸出結果一律為 1 公尺/像素。

列舉
IMAGERY_QUALITY_UNSPECIFIED 品質不明。
HIGH 太陽能資料是從低空拍攝的空拍圖像中擷取，並以 0.1 公尺/像素的解析度處理。
MEDIUM 太陽能資料是從高空拍攝的強化空拍圖像擷取，並以 0.25 公尺/像素的解析度處理。
LOW 太陽能資料是從經過強化處理的衛星圖像中擷取，每個像素的解析度為 0.25 公尺。

方法

get

 取得某個位置周圍區域的太陽能資訊。