Trabalhando com atividades do 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 do 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, deteta e sincroniza todas as alterações diariamente. Em alguns casos, o trabalho também puxará as informações do farm e do campo associadas à conta fornecida para o grupo.
Nota
Antes de criar o trabalho Atividades do Farm, é obrigatório integrar com êxito com o fluxo de Auth do provedor de dados do Farm Activities
Criar trabalho FarmOperations
Crie um trabalho de operações de farm para ingerir dados de Atividade do Farm com uma ID de sua escolha. Esse ID de trabalho é usado para monitorar o status do trabalho usando o trabalho GET Farm Operations.
Documentação da API:FarmOperations_CreateDataIngestionJob
Nota
shapeType e shapeResolution são atributos específicos do provedor. Se não forem aplicáveis ao seu fornecedor, defina o valor como "Nenhum".
Com base na lista e operations fornecida, o startYear Azure Data Manager for Agriculture obtém os dados desde o ano de início até à data atual.
Juntamente com dados específicos (geometria), o provedor de dados Atividades da Fazenda também nos fornece o arquivo DAT para a atividade realizada em seu farm ou campo. O arquivo DAT, 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 Agrícolas
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 levar em conta o alto grau de alteração encontrado nas definições de campo, o Azure Data Manager for Agriculture dá suporte a um recurso de pesquisa por interseção que permite organizar dados por espaço e tempo entre as partes, sem a necessidade de conhecer primeiro 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 como 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, mostra dados para a mesma geometria em diferentes partes.
Método 2: Listar dados por tipo
Os dados recuperados são classificados por tipo de atividade sob a parte. 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óximos passos
- Entenda nossas APIs aqui.