Uredi

Deli putem

Ingest weather forecast data in Azure Data Manager for Agriculture

  • Članak

Weather is a highly democratized service in the agriculture industry. Azure Data Manager for Agriculture offers customers the ability to work with the weather provider of their choice.

Azure Data Manager for Agriculture provides current and forecast weather data through an extension-based and provider-agnostic approach. You can work with a provider of your choice by following the steps for writing a weather extension.

Design overview

Because Azure Data Manager for Agriculture provides weather data through a provider-agnostic approach, you don't have to be familiar with a provider's APIs. Instead, you can use the same Azure Data Manager for Agriculture APIs irrespective of the provider.

Here are some notes about the behavior of provider-agnostic APIs:

  • You can request weather data for up to 50 locations in a single call.
  • Forecast data isn't older than 15 minutes. Data for current conditions isn't older than 10 minutes.
  • After the initial call is made for a location, the data is cached for the defined time to live (TTL).

The following sections provide the commands to fetch weather data and ingest it into Azure Data Manager for Agriculture.

Step 1: Install the weather extension

To install the extension, run the following command by using the Azure Resource Manager ARMClient tool.

Replace all values within angle brackets (<>) with your respective environment values. The extension ID that's currently supported is 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 '{}'

Here's sample output for the installation command:

{
      "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>"
}

After you finish installing the extension, you can ingest weather data.

Step 2: Fetch weather data

After you get the credentials that are required to access the APIs, you need to call the Weather Data API to fetch weather data.