Trabalhando com atividades de farm e dados de atividade no Azure Data Manager for Agriculture
Os usuários podem criar um trabalho de ingestão de dados de operação de farm para extrair dados de atividade de Atividades de Farm associados de um provedor de dados especificado para sua instância do Azure Data Manager for Agriculture, associada a uma parte específica. O trabalho lida com qualquer atualização de autenticação necessária e, por padrão, detecta e sincroniza todas as alterações diariamente. Em alguns casos, o trabalho também puxará as informações de fazenda e campo associadas à conta fornecida para a parte.
Observação
Antes de criar o trabalho de Atividades do Farm, é obrigatório integrar com êxito o fluxo oAuth do provedor de dados de Atividades do Farm
Criar trabalho de FarmOperations
Crie um trabalho de operações de farm para ingerir dados de Atividade do Farm com uma ID de sua escolha. Essa ID de trabalho é usada para monitorar o status do trabalho usando o trabalho de Operações de Farm GET.
Documentação da API:FarmOperations_CreateDataIngestionJob
Observação
shapeType e shapeResolution são atributos específicos do provedor. Se eles não forem aplicáveis ao seu provedor, defina o valor como "Nenhum".
Com base na lista e operations fornecida, o startYear Azure Data Manager for Agriculture busca os dados do ano inicial até a data atual.
Juntamente com dados específicos (geometria), o provedor de dados de Atividades da Fazenda também nos fornece o arquivo DAT para a atividade executada em seu farm ou campo. O arquivo DAT, o arquivo de forma etc. contêm uma geometria que reflete onde a atividade foi executada.
O status e os detalhes do trabalho podem ser recuperados com: FarmOperations_GetDataIngestionJobDetails
Localizando e recuperando dados de atividades do farm
Agora que os dados são ingeridos no Azure Data Manager for Agriculture, eles podem ser consultados ou listados com os seguintes métodos:
Método 1: pesquisar dados de atividades do farm usando a interseção de geometria
Para dar conta do alto grau de alteração encontrado nas definições de campo, o Azure Data Manager for Agriculture oferece suporte a um recurso de pesquisa por interseção que permite organizar dados por espaço e tempo entre partes, sem precisar primeiro conhecer a hierarquia ou associação de farm/campo. Se você tiver o partyId, poderá usá-lo na entrada e ele fornecerá a lista de itens de dados de atividade do farm para a parte especificada.
Você também pode usar o ID like plantingId para buscar os dados acima na mesma API. Se você remover a ID, poderá ver quaisquer outros dados que se cruzem com a mesma geometria entre as partes. Assim, ele mostra dados para a mesma geometria em diferentes partidos.
Método 2: Listar dados por tipo
Os dados recuperados são classificados por tipo de atividade no grupo. Estes podem ser listados, com filtros padrão aplicados. Itens de dados individuais podem ser recuperados para exibir as propriedades e metadados, incluindo o sourceActivityId, providerFieldId e Geometry.
Listar e baixar anexos
O atributo message na resposta da FarmOperations_GetDataIngestionJobDetails API mostra quantos dados foram processados e quantos anexos foram criados. Para verificar os anexos associados ao partyId, vá para API de anexo. A resposta fornece todos os anexos criados sob o partyId.
Documentação da API: Anexos
Próximas etapas
- Entenda nossas APIs aqui.