Compartilhar via

Ingerir dados de previsão meteorológica no Gerenciador de Dados do Microsoft Azure para Agricultura

  • Artigo

O clima é um serviço altamente democratizado na indústria agrícola. O Gerenciador de Dados do Microsoft Azure para Agricultura oferece aos clientes a capacidade de trabalhar com o fornecedor meteorológico da sua escolha.

O Gerenciador de Dados do Microsoft Azure para Agricultura fornece dados meteorológicos atuais e previstos através de uma abordagem baseada em extensões e independente de fornecedor. Você pode trabalhar com um provedor de sua escolha seguindo as etapas para escrever uma extensão climática.

Visão geral do design

Como o Gerenciador de Dados do Microsoft Azure para Agricultura fornece dados meteorológicos através de uma abordagem independente do fornecedor, não é necessário estar familiarizado com as APIs de um fornecedor. Em vez disso, pode utilizar as mesmas APIs do Gerenciador de Dados do Microsoft Azure para Agricultura, independentemente do fornecedor.

Aqui estão algumas notas sobre o comportamento de APIs independentes de provedor:

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

As secções seguintes fornecem os comandos para obter dados meteorológicos e ingeri-los no Gerenciador de Dados do Microsoft Azure para Agricultura.

Etapa 1: instale a extensão climática

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

Substitua todos os valores entre colchetes angulares (<>) pelos respectivos valores de ambiente. O ID da extensão atualmente compatível é 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á um exemplo de saída 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 terminar de instalar a extensão, você poderá ingerir dados meteorológicos.

Etapa 2: buscar 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.