dataLayers 端點 傳回編碼成 GeoTIFF 檔案的資料,可用於任何地理區域 資訊系統 (GIS) 應用程式,設計出太陽能系統。
dataLayer 回應中的每個字串都包含網址,您可以 用於擷取對應的 GeoTIFF。網址效期最長為一小時 產生的結果。GeoTIFF 檔案 最長可儲存 30 天的資料
除了 RGB 圖層之外,GeoTIFF 檔案無法在 圖片檢視器,因為內容是編碼資料,而非 RGB 圖片。GeoTIFF 檔案也無法透過 Maps JavaScript API 直接用作重疊圖片。
下表將詳細說明各圖層。
圖層 | 像素深度 | 解析度 | 說明 |
---|---|---|---|
數位表面模型 (DSM) | 32 位元浮點值 | 0.1 公尺/像素 | 代表地球表面地形的海拔高度資料 包括自然和內建特徵測得的值以公尺為單位。 第二,自訂角色只能 套用至專案或機構無效的位置或我們沒有資料的區域,會儲存為 -9999。 |
RGB | 8 位元 | 0.1 公尺/像素 0.25 m/pixel 0.5 m/pixel 1 m/pixel |
區域空拍圖。GeoTIFF 圖像檔案包含
三個對應於紅色、綠色及藍色值的錶帶,以便構成
每個像素的 24 位元 RGB 值。 根據預設,像素解析度為 為 0.1 公尺/像素。 |
建築物遮罩 | 1 位元 | 0.1 公尺/像素 | 每像素 1 位元,表示該像素是否屬於 小部分 |
年度排量 | 32 位元浮點值 | 0.1 公尺/像素 | 該區域的年度日照量地圖,或屋頂的日照量。
值為每年的 kWh/kW/年。 Flux 會針對每個地點計算,而非 建構屋頂位置無效或我們無法的區域 計算浮動值以 -9999 儲存。Google 以外的地區 涵蓋範圍 的值無效。 注意:這是未遮蓋的液體。 |
每月流量變化 | 32 位元浮點值 | 0.5 公尺/像素 | 區域。值為每年的 kWh/kW/年。GeoTIFF 圖像檔案包含 12 個 1 月至 12 月的錶帶,依序排列。 |
每小時色調 | 32 位元整數 | 1 公尺/像素 | 12 個每小時層色地圖,對應 1 月至 12 月,
順序。 每個 GeoTIFF 檔案都包含 24 個色彩模式 (與 全天候 24 小時。每個像素都是 32 位元整數,與 (最多) 當月的 31 天。1 位元代表 地區能看到該月份當天該時段的太陽。 無效的位置會儲存為 -9999 並已設定位元 31,如下所示: 對應當月第 32 天,因此無效。 |
解碼每小時的鏡面光柵
每小時陰影資料會以多頻光柵編碼。進一步瞭解光柵 請參閱 Solar API 概念。
要求每小時支付陰影資料時,最多會接收 12 顆光柵、 當月 (1 月到 12 月) 各一個月。每個光柵 是由 24 個圖層 (亦即「頻帶」) 所組成,每層稱為 24 小時的 當天。
每個錶帶都是由儲存格的矩陣 (或稱「像素」) 表示。每個像素都有 32 位元的深度,相當於當月的 31 天 (上限)。 因此,解碼陰影資料的日期、時間和月份時,就需要 瞭解要分析的位元、頻帶和光柵。
舉例來說,如要識別座標 (x, y) 位置上的特定位置是否看到 6 月 22 日下午 4:00 的週日,請完成下列步驟:
- 提出位置 (x, y) 所有圖層的資料層要求。
- 由於 6 月的月份是一年中的第六個月,因此請擷取第六個
hourlyShadeUrls
清單中的網址。 - 每個小時的錶帶單位為 24 小時制。如要取得下午 4 點 (16:00) 的資料, 查詢第 17 個頻道
- 位元 (天) 索引值是 0。如要取得 6 月 22 日的資料,請參閱位元 21。
- 位元提供二進位資料,指出該位置是否在 特定日期和時間。如果位元是 1,表示地點偵測到太陽。如果位元是 0 位置的陰影。
以下程式碼概述上述步驟:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))