在適用於農業的 Azure 數據管理員中內嵌衛星影像
衛星圖像是農業數據的基礎支柱。 為了支援可調整的幾何裁剪影像擷取，Microsoft與 Sinergise Sentinel Hub 合作，為 Azure Data Manager for Agriculture 提供順暢的自備授權 （BYOL） 體驗。 您可以使用此 BYOL 體驗來管理您自己的成本。 這項功能可協助您將欄位裁剪的歷程記錄和最新影像儲存在相關欄位的連結內容中。
必要條件
- 若要搜尋並擷取影像，您需要具有 Sentinel Hub 適當訂用帳戶權利的用戶帳戶。
- 閱讀 Sinergise Sentinel Hub 服務條款和隱私策略。
- 準備好您的
providerClientId和providerClientSecret值。
擷取幾何裁剪的影像
在 Azure Data Manager for Agriculture 中使用附屬數據牽涉到下列步驟：
注意
用於農業的 Microsoft Azure 資料管理員目前處於預覽狀態。 如需適用於搶鮮版 (Beta) 功能、預覽版功能，或尚未正式發行功能的法律條款，請參閱 Microsoft Azure 預覽版增補使用規定。
用於農業的 Microsoft Azure 資料管理員需要註冊，而且在預覽期間只會提供給獲得核准的客戶與合作夥伴使用。 若要在預覽期間要求存取用於農業的 Microsoft 資料管理員，請使用此表單。
使用量可見度和記錄
由於所有擷取的數據都在 BYOL 模型中，因此作業的成本是透明的。 適用於農業的 Azure 數據管理員提供內建記錄，以提供對上游合作夥伴 Sentinel Hub 呼叫的處理單位（PU）耗用量透明度。 信息會出現在SatelliteLogs標準 Azure Data Manager 記錄的類別之下。
可用影像的 STAC 搜尋
適用於農業的 Azure 數據管理員支援業界標準的 SpatioTemporal 資產目錄 （STAC） 搜尋介面，以在 Sentinel Hub 集合中尋找影像上的元數據，然後再認可下載圖元。 若要這樣做，搜尋端點會接受以點、多邊形或多多邊形的形式，加上開始和結束日期/時間的位置。 或者，如果您已經有唯一的專案標識符，則可以將其作為最多五個陣列來直接擷取這些特定專案。
重要
為了與 STAC 語法一致， 功能標識符 會從 2023-11-01-preview API 版本重新命名為 專案 標識碼。
如果您提供專案識別碼，則會忽略要求中的任何位置和時間參數。
單一磚原始檔控制
已發佈的圖格會與地球上空間重疊，以確保完整的空間涵蓋範圍。 如果查詢的幾何位於在合理的時間範圍內符合多個圖格的空間中，提供者會自動使用從候選圖格範圍選取的像素為傳回的影像打馬賽克。 提供者會產生最佳結果影像。
在某些情況下，不建議使用多個磚，而且偏好使用單一磚來源的可追蹤性。 為了支援此嚴格的原始檔控制，Azure Data Manager for Agriculture 支援在內嵌作業中指定單一專案標識符。
注意
此功能僅適用於 2023-11-01-preview API 版本。
如果所提供專案標識碼的幾何具有部分涵蓋範圍（例如幾何跨越多個磚），則傳回的影像只會反映指定專案磚中存在的圖元，併產生部分影像。
重新投影
重要
重現功能已從 2023-11-01-preview API 版本變更，但立即適用於所有版本。 舊版使用在赤道上設定的 10 m * 10 m 的靜態轉換。 在此版本之前擷取的影像大小可能與在此版本之後擷取的影像有差異。
適用於農業的 Azure 數據管理員使用 WGS84 （EPSG：4326），這是一個平面座標系統。 Sentinel-2 影像在 UTM 中呈現，這是一個近似圓形地球的地面投影系統。
平面影像與圓形地球之間的轉譯涉及近似值轉譯。 此轉譯的精確度設定為在赤道相等 (10 m^2)，並隨著問題點從赤道移至極點增加誤差範圍。
為了保持一致性，適用於農業的 Azure Data Manager 會針對所有 Sentinel-2 呼叫使用下列公式 10 m^2 基底：
$$ Latitude = \frac{10 m}{111320} $$
$$ Longitude = \frac{10 m}{\frac{111320}{cos(lat)}} $$
$$ \ Where\ lat = The\ centroid's\ latitude\ from\ the\ provided\ geometry $$
快取功能
重要
快取功能僅適用於 2023-11-01-preview API 版本。 專案快取僅適用於根據專案標識碼進行擷取。 對於一般幾何和時間搜尋，不會快取傳回的專案。
適用於農業的 Azure 資料管理員可優化對相同專案進行高度重複呼叫的效能和成本。 它會快取客戶實例中項目標識符擷取最近 STAC 專案五天，並啟用本機擷取。
對於搜尋端點的第一次呼叫，適用於農業的 Azure Data Manager 會代理要求，並觸發上游提供者的要求，以擷取相符或交集數據項。 要求會產生任何提供者費用。
任何後續搜尋會先導向至快取，以尋找相符項目。 如果有相符專案，則會直接從快取提供數據。 此程式不會產生對上游提供者的呼叫，因此不會產生更多提供者費用。 如果沒有相符專案，或如果五天的保留期間經過，則後續對數據的呼叫會傳遞至上游提供者。 該呼叫會被視為另一個第一次呼叫，因此會快取結果。
如果擷取作業適用於相同的幾何，由相同的資源標識符參考，且與已擷取場景的時間重疊，Azure Data Manager for Agriculture 會使用本機儲存的影像。 映像不會再次從上游提供者下載。 此像素層級快取沒有到期日。
Azure Data Manager for Agriculture 支援的衛星來源
雖然適用於農業的 Azure 數據管理員處於預覽狀態，但它支援從 Sentinel-2 星座擷取數據。
Sentinel-2
Sentinel-2 是歐洲航太局（ESA）在科伯尼號任務下發射的衛星星座。 這顆星座有一對衛星，攜帶一個多光譜儀器（MSI）承載，取樣13個光譜帶：10米的4個波段，20米的6個波段，60米空間解析度的三個波段。
Sentinel-2 有兩個產品：
- 大氣頂端的第 1 層數據。
- 大氣底部的第 2 層數據。 此變體會以大氣方式修正。
適用於農業的 Azure 數據管理員支援從 Sentinel 2 擷取和擷取Sentinel_2_L2A和Sentinel_2_L1C數據。
影像名稱和解析度
您用來擷取和讀取 Azure Data Manager for Agriculture 中的衛星資料（適用於 Sentinel-2）的 API 支援下列影像名稱和解析度：
| 類別 | 映像名稱 | 描述 | 原生解析度 |
|---|---|---|---|
| 原始波段 | B01 | 海岸氣膠 | 60 公尺 |
| 原始波段 | B02 | 藍色 | 10 公尺 |
| 原始波段 | B03 | 綠 | 10 公尺 |
| 原始波段 | B04 | 紅 | 10 公尺 |
| 原始波段 | B05 | 植被紅色邊緣 | 20 公尺 |
| 原始波段 | B06 | 植被紅色邊緣 | 20 公尺 |
| 原始波段 | B07 | 植被紅色邊緣 | 20 公尺 |
| 原始波段 | B08 | 近紅外 （NIR） | 10 公尺 |
| 原始波段 | B8A | 窄 NIR | 20 公尺 |
| 原始波段 | B09 | 水氣 | 60 公尺 |
| 原始波段 | B11 | 短波紅外 （SWIR） | 20 公尺 |
| 原始波段 | B12 | SWIR | 20 公尺 |
| Sen2Cor 處理器輸出 | AOT | 氣膠光學厚度地圖 | 10 公尺 |
| Sen2Cor 處理器輸出 | SCL | 場景分類資料 | 20 公尺 |
| Sen2Cor 處理器輸出 | SNW | 降雪機率 | 20 公尺 |
| Sen2Cor 處理器輸出 | CLD | 成雲機率 | 20 公尺 |
| 衍生索引 | NDVI | 常態化差異植被指數 | 10 公尺/20 公尺/60 公尺 (使用者定義) |
| 衍生索引 | NDWI | 常態化差異水量指數 | 10 公尺/20 公尺/60 公尺 (使用者定義) |
| 衍生索引 | EVI | 增強的植被指數 | 10 公尺/20 公尺/60 公尺 (使用者定義) |
| 衍生索引 | LAI | 分葉區域索引 | 10 公尺/20 公尺/60 公尺 (使用者定義) |
| 衍生索引 | LAIMask | 分葉區域索引遮罩 | 10 公尺/20 公尺/60 公尺 (使用者定義) |
| CLP | 以 s2cloudless 為基礎的 雲端機率 | 值的範圍從 0 （無雲） 到 255 （雲）。 |
10 公尺/20 公尺/60 公尺 (使用者定義) |
| CLM | 雲遮罩，根據 s2cloudless | 的值 1 代表雲端、 0 不代表任何雲端，也不 255 代表任何數據。 |
10 公尺/20 公尺/60 公尺 (使用者定義) |
| dataMask | 二元遮罩表示資料的可用性 | 0的值表示數據或像素在感興趣的區域外無法使用。 |
不適用，視像素值而定 |
注意事項
適用於農業的 Azure 數據管理員使用 CRS EPSG：4326 for Sentinel-2 數據。 API 中引用的解析度位於赤道。
針對預覽：
- 每個租使用者最多可以同時執行五個附屬作業。
- 衛星作業可以在單一 API 呼叫中擷取最多一年的資料。
- 僅支援 TIF。
- 僅支援 10 m、20 m 和 60 m 影像。