dataLayers 端點會傳回以 GeoTIFF 檔案編碼的資料,可用於任何地理資訊系統 (GIS) 應用程式,設計太陽能系統。
dataLayers 回應中的每個字串都包含一個網址,可用於擷取對應的 GeoTIFF。從原始資料層要求產生網址後,網址最多可使用一小時。GeoTIFF 檔案最多可儲存 30 天。
除了 RGB 圖層外,GeoTIFF 檔案無法在圖片檢視器中正確顯示,因為內容是編碼資料,而非 RGB 圖片。GeoTIFF 檔案也無法直接做為疊加圖片,與 Maps JavaScript API 搭配使用。
下表詳細說明每個層。
圖層 | 像素深度 | 解析度 | 說明 |
---|---|---|---|
數位地表模型 (DSM) | 32 位元浮點數 | 0.1 公尺/像素 | 代表地球表面地形的海拔高度資料,包括自然和人造特徵。值以高於海平面的公尺數為單位。無效位置或沒有資料的區域會儲存為 -9999。 |
RGB | 8 位元 | 0.1 公尺/像素 0.25 公尺/像素 0.5 公尺/像素 1 公尺/像素 |
該區域的空照圖。GeoTIFF 影像檔案包含三個頻帶,分別對應紅色、綠色和藍色值,可為每個像素形成 24 位元 RGB 值。 根據預設,像素解析度為 0.1 公尺/像素。 |
建築物遮罩 | 1 位元 | 0.1 公尺/像素 | 每個像素各占一個位元,表示該像素是否屬於屋頂。 |
年通量 | 32 位元浮點數 | 0.1 公尺/像素 | 該區域的年度通量地圖,或屋頂年度日照量。
值為 kWh/kW/year。 系統會為每個位置計算通量,而不只是建築物屋頂。無效位置或無法計算通量的區域會儲存為 -9999。如果位置超出我們的涵蓋範圍,則無效。 注意:這是未遮蓋的通量。 |
每月流量 | 32 位元浮點數 | 0.5 公尺/像素 | 該區域的每月通量地圖 (屋頂上的日照量,按月細分)。值為 kWh/kW/year。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 點是否能看到太陽,請執行下列操作:
- 針對位置 (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))