關於 GeoTIFF 檔案

算繪 4 個堆疊的光柵。

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 公尺/pixel
區域的空拍圖片。GeoTIFF 圖像檔案包含三帶對應的紅色、綠色和藍色值,藉此組成每個像素的 24 位元 RGB 值。

根據預設,像素解析度為 0.1 m/pixel。
建築物遮罩 1 位元 0.1 公尺/像素 每個像素一個位元,指出像素是否屬於屋頂的一部分。
年度變動 32 位元浮點值 0.1 公尺/像素 該區域每年的流感地圖或每年屋頂日光的日光。值為每年 kWh/kW。

系統會針對各個地點計算流感,而不只是建構屋頂。無效的位置或無法計算流動區域的區域,則會儲存為 -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:00 是否看到太陽,請執行下列步驟:

  1. 請求所有位置圖層 (x, y) 的資料層要求。
  2. 由於 6 月是一年中的第六個月,因此擷取 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))