Guia de uso do MapaSafra

O MapaSafra é uma ferramenta colaborativa para delimitar propriedades rurais, desenhar campos produtivos e anotar metadados agrícolas (cultura, safra, datas). Os dados gerados alimentam experimentos com imagens Sentinel-2, indexação H3 e classificação de culturas.

A aplicação é organizada em duas áreas: o workspace autenticado em /app, onde você produz dados, e as páginas públicas (home, docs), que explicam o projeto.

• Contornos de propriedade (opcional)
• Geometrias de campos produtivos (obrigatório)
• Metadados de cultura, safra e datas
• Exportações GeoJSON para revisão e pipeline

Siga este roteiro curto na primeira vez que usar o MapaSafra.

1. 1Entre na conta a partir da página inicial ou do botão Acessar projeto.
2. 2Aceite os Termos de Uso e Consentimento de Dados na primeira sessão de rotulagem.
3. 3Crie uma propriedade e posicione o mapa na região que você quer anotar.
4. 4Desenhe pelo menos um campo produtivo e preencha seus metadados.
5. 5Revise no painel de propriedades e baixe o GeoJSON quando estiver pronto.

A autenticação garante que propriedades e campos produtivos fiquem vinculados ao seu usuário. Sem login, o workspace redireciona para a tela de entrada.

• Use o botão Acessar projeto no topo da página inicial.
• Os provedores de login configurados pelo projeto aparecem na tela de autenticação.
• Após entrar, você é levado automaticamente para /app.

O workspace é a área autenticada. A navegação superior dá acesso às seções principais do MapaSafra.

• /app — visão inicial do workspace com atalhos para a rotulagem.
• /app/rotulagem/campos — editor de mapa onde acontece toda a coleta de dados.
• /app/profile — dados da sua conta e preferências.

• Use a barra superior para alternar entre páginas do workspace.
• O botão Docs sempre traz você de volta a este guia.
• O tema (claro/escuro) também está na barra superior.

Na primeira vez que você abre a rotulagem, a aplicação apresenta os Termos de Uso e Consentimento de Dados. É obrigatório aceitar para continuar.

Toda rotulagem começa por uma propriedade. Ela agrupa os campos produtivos e guarda o contexto do produtor.

1. 1Clique em Nova propriedade ou selecione uma propriedade existente na lista.
2. 2Dê um nome que ajude a reconhecer a propriedade depois (fazenda, cidade, produtor).
3. 3Opcionalmente, informe dados do produtor (nome, contato).
4. 4Busque no mapa a região da propriedade usando o campo de busca.

O contorno da propriedade é o polígono externo que engloba casas, estradas, áreas de vegetação e todos os talhões.

1. 1Ative a ferramenta de desenho de propriedade no editor.
2. 2Clique no mapa para adicionar vértices acompanhando o limite real.
3. 3Feche o polígono conectando ao primeiro ponto e salve.

Campos produtivos são os talhões efetivamente cultivados. Eles formam as geometrias principais do dataset.

1. 1Ative a ferramenta de desenho de campo produtivo.
2. 2Trace o polígono seguindo a borda real do talhão, um campo por vez.
3. 3Feche o polígono e avance para os metadados.

Os metadados dão significado agrícola à geometria e mantêm o dataset útil além do mapa.

• Categoria: cultura temporária, cultura permanente ou produção animal.
• Cultura: soja, milho, café, pastagem, etc.
• Safra: identifica o ciclo agrícola.
• Data de plantio e data de colheita (quando conhecidas).
• Variedade: opcional, mas útil quando disponível.

Após salvar, os campos produtivos aparecem na tabela inferior e no painel de propriedades. É lá que você valida o que foi coletado.

1. 1Abra a linha de uma propriedade para ver seus campos produtivos.
2. 2Clique em um campo para destacá-lo no mapa.
3. 3Confira geometria e metadados antes de exportar.

• Use Editar quando a geometria precisar de ajuste ou os metadados estiverem incompletos.
• Use Remover apenas quando o campo foi criado por engano.
• Revise polígonos antes de exportar para garantir GeoJSON limpo.

A exportação deixa os dados revisáveis fora da interface e compatíveis com o pipeline de pesquisa.

• Baixe apenas o contorno da propriedade quando precisar do limite externo.
• Baixe propriedade + campos quando preparar um pacote completo de revisão.
• Baixe apenas campos quando a propriedade não foi delimitada.

Em /app/profile você confere e atualiza as informações básicas da sua conta MapaSafra.

• Nome exibido na aplicação.
• E-mail associado ao login.
• Preferências salvas entre sessões.

O idioma pode ser alterado a qualquer momento pela barra superior. A preferência fica salva no navegador e é aplicada tanto ao workspace quanto a esta documentação.