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 地理編號 (即海平面)。無效的位置 (我們沒有資料的位置) 會儲存為 -9999。
rgbUrl

string

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

string

建築物遮罩圖片的網址：每個像素有 1 個位元表示該像素是否屬於屋頂的一部分。
annualFluxUrl

string

該地區的年度流感地圖網址 (屋頂日照)。值為每年 kWh/kW 數。這裡採用未遮蓋的流水量：計算的是所有地點的流水量，而非只計算建築物屋頂。無效的地點會儲存為 -9999：在服務涵蓋範圍之外的地點將無效，在服務涵蓋範圍內無法計算流暢度的地點也屬於無效範圍。
monthlyFluxUrl

string

該區域每月日光地圖 (屋頂上的陽光，按月份細分) 的網址。值為每年 kWh/kW 數。這個網址指向的 GeoTIFF 將包含 12 個錶帶，分別對應至 1 月... 12 月。
hourlyShadeUrls[]

string

12 個每小時陰影網址，對應 1 月... 12 月，並按順序排列。每個 GeoTIFF 都會包含 24 個錶帶，分別對應至一天 24 小時。每個像素都是 32 位元的整數，與當月 (最多) 31 天對應；1 位元表示對應的位置在該月的該小時內可以看到太陽。無效的位置會儲存為 -9999 (因為此為負數，已設定位元 31；沒有有效的值可以設定為位元 31，因為對應至當月 32 日)。

範例可能很實用。如果想知道某個點 (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 的第 1 個網址 (索引從零開始)、[hour] 會將索引編入管道，而最終非零結果則代表「晴朗」。沒有休息日，也沒有日光節約日 (每天都有 24 小時，中午一律為「標準時間」)。
imageryQuality

enum (ImageryQuality)

搜尋結果的圖像品質。

日期

代表完整或部分日曆的日期，例如生日。您可在其他位置指定日期和時間，或沒有其他選擇。日期以公曆為相對於公曆。可能代表下列其中一種：

  • 完整日期，具有非零的年、月和日值。
  • 月和日，出現零年 (例如週年紀念日)。
  • 一個自己的年，分別為 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 結果的圖像品質。

注意：無論圖像品質等級為何，DDSM 輸出的解析度一律為 0.1 公尺/像素，每月流感輸出的解析度一律為 0.5 公尺/像素，每小時陰影輸出的解析度一律為 1 公尺/像素。

列舉
IMAGERY_QUALITY_UNSPECIFIED 無法確定品質。
HIGH 基本圖像和 DSM 資料處理量為 0.1 公尺/像素。
MEDIUM 基本圖像和 DSM 資料處理量為 0.25 公尺/像素。
LOW 基本圖像和 DSM 資料處理量為 0.5 公尺/像素。

方法

get

 取得某位置週邊區域的太陽能資訊。