dataLayers 端點會傳回以 GeoTIFF 檔案編碼的資料,可用於任何地理資訊系統 (GIS) 應用程式來設計太陽能系統。
dataLayers 回應中的每個字串都包含一個網址,您可以使用該網址擷取對應的 GeoTIFF。從原始資料層要求產生的網址有效時間最多為 1 小時。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/年。 Flux 會針對每個位置計算,而非只計算建築物屋頂。無效的位置或無法計算流量的區域,會儲存為 -9999。位於服務範圍外的地區無效。 注意:這是未遮蔽的資料流。 |
每月變化 | 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 點看到太陽,請執行下列操作:
- 針對所有位置 (x、y) 資料層,提出資料層要求。
- 由於六月是今年的第六個月,請擷取
hourlyShadeUrls
清單中的第六個網址。 - 每小時頻帶以 24 小時制表示。如要取得下午 4 點 (16:00) 的資料,請查詢第 17 個管道。
- 位元 (天) 索引從 0 開始。如要取得 6 月 22 日的資料,請讀取位元 21。
- 位元會提供二進位資料,指出該位置在指定日期和時間是否有日出。如果位元為 1,表示該位置有日照。如果位元為 0,表示該位置有陰影。
以下程式碼總結上述步驟:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))