Como usar Global FieldID (GFID) e base de dados pública SICAR em Conjunto

A API FieldID™ permite que os desenvolvedores, de vários segmentos da agroindústria, implementem três cenários principais.

 

Cenário 1: Obtenha todos os GFIDs dos talhões dentro dos limites disponíveis na base do SICAR

Se você já possui uma cópia do banco de dados SICAR e a utiliza em seus processos de negócios, talvez já tenha acesso aos polígonos do SICAR. Você pode utilizar este polígono para realizar uma pesquisa simples no banco de dados GFID, para obter uma lista de IDs existentes dentro da propriedade, importando para seu sistema todas as glebas dentro de uma propriedade em uma única etapa. Para fazer isso, envie as coordenadas do polígono CAR para a API no formato GeoJSON, conforme descrito em nosso guia do desenvolvedor.

Você receberá uma lista de dados correspondentes às coordenadas inseridas, bem como métricas indicando a qualidade desses dados correspondentes e o GFID do talhão. Este limite nunca se sobreporá a outro campo ao mesmo tempo, portanto você pode usá-los para colocar glebas no mapa.

Observe que os limites podem, até certo ponto, mudar ao longo do tempo e podem até ser substituídos por novos GFIDs– o sistema permite rastrear essas alterações, mas isso está além do escopo deste artigo.

 

Cenário 2: Obtendo GFIDs dos talhões e limites usando o COD_IMOVEL

Se você não tiver uma cópia dos polígonos CAR, mas souber o COD_IMOVEL (fornecido pelo produtor, por exemplo), você poderá usá-lo como uma ‘chave’ para encontrar limites de talhões relacionados que se sobrepõem ao polígono CAR de interesse. Isso funciona porque pré-carregamos os perímetros da base SICAR e o sistema calcula as relações entre todos os outros limites. Nossa solução também pode ser usado para encontrar sobreposições espaciais com qualquer outro limite existente dentro do sistema, incluindo outros limites do SICAR, mas por enquanto nos concentramos em encontrar limites de campo oficiais.

 

Existem duas etapas:

• Use: GET /boundary-references?source_name=SICAR&user_provided_key=<COD_IMOVEL> para buscar o ID do contorno (“Boundary ID) do CAR, por exemplo. GET /boundary-references?source_name=SICAR&user_provided_key=DF-5300108-9C5F2B5FF1E44CF4AFAA3FA9735C29F4 para obter o ID do contorno (“Boundary ID”) doCAR com COD_IMOVEL=DF-5300108-9C5F2B5FF1E44CF4AFAA3FA9735C29F4
• Use: GET /boundaries? boundary_relationships.boundary_id=<boundary ID>& field_relationships.type=delineates

O resultado é um GeoJSON FeatureCollection contendo todos os recursos de limite que se sobrepõem ao limite do SICAR, filtrados para aqueles que são atualmente o perímetro ativo de um campo (em outras palavras, polígono). Os limites do campo contêm uma propriedade que indica os GFIDs, bem como a geometria do limite e outras informações espaciais, como área e perímetro.

 

Cenário 3: Acesse dados do SICAR

Embora a base de dados SICAR esteja disponível ao público, não é possível pesquisá-la diretamente através de consultas estruturadas. É necessário que a pessoa que utilize o SICAR baixe uma série de arquivos e os carregue em um banco de dados.. Para facilitar o trabalho conjunto com SICAR e GFID, pré-registramos os polígonos CAR no sistema FieldID™ e, portanto, você pode usar a API FieldID™ para consultar e baixar limites e metadados do SICAR.

 

Consultando o polígono CARatravés do GFID.

Se você quiser saber em qual limite da propriedade (fazenda) um determinado GFID está, duas etapas serão necessárias:

• Use: GET /fields/{id} para buscar o ID do do talhão (FieldID) conhecido (presumindo que você ainda não conheça o FieldID).
• Use: GET /boundaries?boundary_relationships.boundary_id=<boundary ID> para obter os perímetros que se sobrepõem ao polígono do talhão fornecido.

 

O resultado é um GeoJSON FeatureCollection contendo todos os recursos de limite que se sobrepõem ao limite do talhão. Entre todos os recursos, você pode selecionar aquele para o qual source_name=SICAR obtém o limite SICAR com o qual o perímetro do talhão se sobrepõe. Observe que pode haver casos em que a coleção contém vários polígonos CAR, ou seja, o limite da gleba está dentro de vários limites do SICAR, e isso se deve ao fato de que os limites da fazenda SICAR podem se sobrepor entre si (por exemplo, por motivos de falta de atualização da base pública)

 

Consultando polígonos CAR por bbox

Se você deseja obter todos os limites da propriedaderegistrada na base SICAR dentro de um determinado bbox:

• Use: GET /boundaries?bbox=<bbox> para obter os limites que se sobrepõem ao bbox.

Dado que a saída GeoJSON FeatureCollection contém todos os recursos de limite que se sobrepõem ao bbox, você pode selecionar aquele para o qual source_name=SICAR para obter apenas os limites SICAR dentro do bbox fornecido.