REST Resource: dataLayers

資源:資料層

特定區域太陽能發電潛力的相關資訊。實際資料包含在涵蓋所要求區域的多個 GeoTIFF 檔案中,且此訊息含有網址:DataLayers 訊息中的每個字串都包含網址,用來擷取對應的 GeoTIFF。這些網址在產生後的幾小時內有效。多數 GeoTIFF 檔案的解析度為 0.1m/pixel,但每月 flux 檔案大小為 0.5m/pixel,每小時的陰影檔案則為 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 Geoid (例如海平面)) 以上。無效位置 (我們沒有資料的位置) 會以 -9999 的形式儲存。

rgbUrl

string

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

maskUrl

string

建築物遮罩圖片的網址:每像素一個位元,指出該像素是否屬於屋頂的一部分。

annualFluxUrl

string

該區域的年度流動地圖 (屋頂的每年日照) 網址。值為每年的 kWh/kW/年。這是未遮蓋的液體:系統會針對每個地點計算流動,而非只計算屋頂。無效的地區會以 -9999 的格式儲存:位於服務涵蓋範圍之外的位置無效,而涵蓋範圍內有幾個位置無法計算浮動值的情況也會失效。

monthlyFluxUrl

string

該區域每月流感地圖的網址 (屋頂的陽光,按月份細分) 的網址。值為每年的 kWh/kW/年。此網址所指向的 GeoTIFF 將包含十二個樂團,對應於 1 月... 12 月,順序為 12 月。

hourlyShadeUrls[]

string

12 個每小時分用的網址,對應於 1 月... 12 月,依序對應。每個 GeoTIFF 都會包含 24 個頻帶,對應為一天中的 24 小時。每個像素都是 32 位元整數,對應至當月的 31 天 (最多);1 位元代表對應位置在該月份中該時段可查看太陽。無效位置的儲存格式為 -9999 (因為這是負數,所以已設定位元 31,而任何有效值都不得將 Bit 31 設為當月第 32 天)。

舉例來說,範例可能很有用。如果想要知道某個點 (x, y) 點 (在像素位置 (x, y)) 是否在 6 月 22 日下午 4 點偵測到太陽,請按照下列步驟操作:

  1. 擷取清單中第六個網址 (對應 6 月)。
  2. 查詢第 17 個頻道 (對應下午 4 點)。
  3. 讀取 32 位元的值 (x, y)。
  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第一個網址 (從零建立索引),[hour] 將索引建立至管道,最終非零結果則代表「晴天」。沒有閏日,也沒有 DST (每天皆持續 24 小時,中午一律為「標準時間」)。

imageryQuality

enum (ImageryQuality)

結果圖像的品質。

日期

代表完整或部分的日曆日期,例如生日。您可以指明時段和時區,或者在其他地方指定時間或時區。日期以公曆為基準。可能代表下列其中一項:

  • 完整日期,具有非零的年、月和日值。
  • 日期為 0 的月份和日期,例如週年紀念日。
  • 有 1 年,第 0 個月卻為 0 天。
  • 年和月,但數字為零 (例如信用卡到期日)。

相關類型:

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 底層圖像和 DSM 資料以 0.1 公尺/像素處理。
MEDIUM 處理基礎圖像和 DSM 資料的時間為 0.25 公尺/像素。
LOW 底層圖像和 DSM 資料在 0.5 公尺/像素的處理完成。

方法

get

取得特定位置附近地區的太陽能資訊。