Partilhar via


Ingerir dados de previsão meteorológica no Azure Data Manager for Agriculture

O clima é um serviço altamente democratizado no setor agrícola. O Azure Data Manager for Agriculture oferece aos clientes a capacidade de trabalhar com o provedor de meteorologia de sua escolha.

O Azure Data Manager for Agriculture fornece dados meteorológicos atuais e de previsão por meio de uma abordagem baseada em extensão e independente do provedor. Você pode trabalhar com um provedor de sua escolha seguindo as etapas para escrever uma extensão meteorológica.

Descrição geral do Design

Como o Azure Data Manager for Agriculture fornece dados meteorológicos por meio de uma abordagem independente do provedor, você não precisa estar familiarizado com as APIs de um provedor. Em vez disso, você pode usar as mesmas APIs do Azure Data Manager for Agriculture independentemente do provedor.

Aqui estão algumas notas sobre o comportamento de APIs agnósticas do provedor:

  • Você pode solicitar dados meteorológicos para até 50 locais em uma única chamada.
  • Os dados de previsão não têm mais de 15 minutos. Os dados para as condições atuais não têm mais de 10 minutos.
  • Depois que a chamada inicial é feita para um local, os dados são armazenados em cache para o tempo de vida definido (TTL).

As seções a seguir fornecem os comandos para buscar dados meteorológicos e ingeri-los no Azure Data Manager for Agriculture.

Passo 1: Instale a extensão meteorológica

Para instalar a extensão, execute o seguinte comando usando a ferramenta ARMClient do Azure Resource Manager.

Substitua todos os valores entre colchetes angulares (<>) pelos respetivos valores de ambiente. O ID da extensão suportado atualmente é 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 '{}'

Aqui está a saída de exemplo para o comando de instalação:

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

Depois de concluir a instalação da extensão, você pode ingerir dados meteorológicos.

Passo 2: Obter dados meteorológicos

Depois de obter as credenciais necessárias para acessar as APIs, você precisa chamar a API de dados meteorológicos para buscar dados meteorológicos.