共用方式為

在用於農業的 Azure 資料管理員中，內嵌天氣預報資料

  • 發行項

天氣是農業界極為普及的服務。 用於農業的 Azure 資料管理員能讓客戶與其選擇的氣象提供者合作。

用於農業的 Azure 資料管理員透過以延伸模組為基礎且不受提供者限制的方法，提供目前與預測的天氣資料。 您可以遵循天氣延伸模組撰寫步驟 (部分機器翻譯)，與您選擇的提供者合作。

設計概觀

由於用於農業的 Azure 資料管理員透過不受提供者限制的方法提供天氣資料，因此您不必熟知提供者的 API。 相反地，不論提供者為何，您都可以使用相同的用於農業的 Azure 資料管理員 API。

以下是有關不受提供者限制之 API 行為的一些注意事項：

  • 您可以在單一呼叫中要求多達 50 個位置的天氣資料。
  • 趨勢預測資料皆為 15 分鐘以內的資料。 現況資料皆為 10 分鐘以內的資料。
  • 針對位置進行初始呼叫之後，系統就會為定義的存留時間 (TTL) 快取資料。

下列各節提供的命令可用來擷取天氣資料，並將其內嵌至用於農業的 Azure 資料管理員。

步驟 1：安裝天氣延伸模組

若要安裝延伸模組，請使用 Azure Resource Manager ARMClient 工具來執行下列命令。

將角括弧 (<>) 內的所有值取代為各自的環境值。 目前支援的延伸模組識別碼為 IBM.TWC。

armclient PUT /subscriptions/<subscriptionid>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-resource-name>/extensions/<extensionid>?api-version=2020-05-12-preview '{}'

以下是安裝命令的範例輸出：

{
      "id": "/subscriptions/<subscriptionid>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-resource-name>/extensions/<extensionid>",
      "type": "Microsoft.AgFoodPlatform/farmBeats/extensions",
      "systemData": {
        "createdBy": "testuser@abc.com",
        "createdByType": "User",`        
        "createdAt": "2021-03-17T12:36:51Z",
        "lastModifiedBy": "testuser@abc.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-03-17T12:36:51Z"
      },
      "properties": {
        "category": "Weather",
        "installedExtensionVersion": "1.0",
        "extensionAuthLink": "https://www.<provider.com/integration/",
        "extensionApiDocsLink": "https://docs.<provider>.com/documentation/Weather_Data/Historical_and_Climatological_Weather/latest#_daily_historical_ag_weather_v1_0"
      },
      "eTag": "92003c91-0000-0700-0000-804752e00000",
      "name": "<provider>"
}

安裝延伸模組之後，您就可以內嵌天氣資料。

步驟 2：擷取天氣資料

取得存取 API 所需的認證之後，您必須呼叫天氣資料 API 以擷取天氣資料。