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/year。這是未遮蓋的通量：系統會計算每個位置的通量，而不僅限於建築物屋頂。無效位置會儲存為 -9999：涵蓋範圍外的地點無效，涵蓋範圍內無法計算流量的地點也無效。
monthlyFluxUrl

string

該區域每月通量地圖的網址 (屋頂上的日照量，按月細分)。值為 kWh/kW/year。這個網址指向的 GeoTIFF 檔案會包含十二個波段，依序對應到一月到十二月。
hourlyShadeUrls[]

string

十二個網址，分別對應一月到十二月的每小時陰影。每個 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 點有陽光。

更正式地說：在位置 (x, y)，該月/日/時的陰影/陽光是位元，其中 month (1-12)、day (1...月最大值；2 月有 28 天) 和 hour (0-23)

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

其中 (x, y) 是空間索引，[month - 1] 是指擷取第 month - 1 個 URL (從零開始索引)，[hour] 是索引至管道，而最終非零結果表示「晴朗」。沒有閏日，也沒有日光節約時間 (所有日子都是 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 公尺/像素的解析度處理。
BASE 太陽能資料是從經過處理的強化衛星圖像 (0.25 公尺/像素) 衍生而來。

方法

get

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