關於 GeoTIFF 檔案

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/年。 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 點看到太陽，請執行下列操作：

1. 針對所有位置 (x、y) 資料層，提出資料層要求。
2. 由於六月是今年的第六個月，請擷取 hourlyShadeUrls 清單中的第六個網址。
3. 每小時頻帶以 24 小時制表示。如要取得下午 4 點 (16:00) 的資料，請查詢第 17 個管道。
4. 位元 (天數) 索引從 0 開始。如要取得 6 月 22 日的資料，請讀取位元 21。
5. 位元會提供二進位資料，指出該位置在指定日期和時間是否有日出。如果位元為 1，表示該位置有日照。如果位元為 0，表示該位置有遮蔽物。

以下程式碼總結上述步驟：

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))