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 是否看到太陽,請執行下列步驟:
- 請求所有位置圖層 (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))