Listas de locais¶

Esta página explica como criar, alterar e excluir uma lista de locais.

Uma lista contém um ou mais locais, por exemplo fazendas ou parcelas. O aplicativo analisa cada local de uma lista. Para ler os resultados, consulte 03-analysis-and-results.md.

Nesta página, um controle ou um rótulo do aplicativo está em negrito. Uma mensagem do aplicativo está entre "aspas duplas".

A página de listas¶

A página de listas tem o título Listas de locais. Ela mostra uma tabela com uma linha para cada lista.

A tabela tem estas colunas:

Nome: o nome da lista. Selecione o nome para abrir a lista.
Locais: o número de locais na lista.
Produto básico: o produto básico que você informou para a lista. Se você não informou um produto básico, a célula mostra "—".
Análises: as análises que o aplicativo fez para a lista.
Último processamento: a data da última análise.
Criado: a data em que você criou a lista.
Ações: o menu da lista (⋯).

Para ordenar a tabela, pressione o título de uma coluna. Pressione o mesmo título novamente para alterar a direção da ordenação.

Para encontrar uma lista, digite uma parte do nome ou do produto básico dela na caixa de pesquisa (Pesquisar listas por nome ou produto básico…). Se nenhuma lista corresponder ao seu texto, a tabela mostra "Nenhuma lista corresponde a "…"". Se você não tiver listas, a página mostra "Nenhuma lista encontrada".

Rótulos na tabela¶

Incompleta: a análise não terminou para todos os locais da lista. Coloque o ponteiro sobre o rótulo para ver o número de locais que o aplicativo analisou.
Dados mais recentes disponíveis: um conjunto de dados que a lista usou mudou depois da última análise. Consulte "Atualizar uma lista" abaixo.
Atualizando: uma atualização da lista está em andamento. A tabela mostra os resultados da análise anterior até que a atualização esteja concluída.

Envios que não estão concluídos¶

Se um envio não estiver concluído, um aviso aparece na parte de cima da página de listas. Pressione Retomar para voltar ao envio. Se o envio estiver aguardando a sua revisão, pressione Revisar.

Criar uma nova lista¶

Para começar, pressione + Nova lista na página de listas. A página Criar uma nova lista aparece.

A página pergunta Como você quer adicionar locais?. Selecione um destes dois métodos:

Enviar um conjunto de locais: envie um arquivo que contém um ou mais locais. Este é o método padrão.
Adicionar um local manualmente: digite as coordenadas de um local.

NOTA: Mude de um método para o outro somente antes de começar. Quando você muda o método, o aplicativo limpa os valores que você digitou para o outro método.

NOTA: Se o aplicativo mostrar "Os envios estão desativados", a configuração do servidor bloqueia todos os envios. Uma nova instalação Docker permite enviar arquivos. Uma instalação que você atualizou mantém o arquivo de configuração antigo. Consulte 01-install-and-start.md.

Tipos de arquivo aceitos¶

O aplicativo aceita estes tipos de arquivo:

Tipo de arquivo	Extensão do nome do arquivo
CSV	.csv
Pasta de trabalho do Excel	.xlsx
GeoJSON	.geojson ou .json
KML	.kml
Shapefile compactado	.zip

O aplicativo não aceita outros tipos de arquivo. Por exemplo, ele não aceita arquivos KMZ (.kmz) nem arquivos antigos do Excel (.xls). Se você enviar um tipo de arquivo diferente, o aplicativo mostra "Tipo de arquivo não compatível". Para usar um arquivo KMZ, extraia o arquivo KML do arquivo KMZ. Depois, envie o arquivo KML.

Arquivos CSV e Excel¶

Um arquivo CSV ou Excel contém um local em cada linha. A primeira linha deve conter os títulos das colunas. Em uma pasta de trabalho do Excel, o aplicativo lê somente a primeira planilha.

Cada linha deve ter uma latitude e uma longitude em graus decimais. A latitude deve estar entre -90 e 90. A longitude deve estar entre -180 e 180.

O aplicativo encontra as colunas pelos títulos delas. Ele reconhece estes títulos. Ele ignora maiúsculas, minúsculas, espaços, hifens e sublinhados:

Latitude: latitude, lat, y, ycoord, ylat.
Longitude: longitude, lon, lng, long, x, xcoord, xlon.
Nome do local: name, id, plotid, locationid, locationname, plot.

A coluna de nome é opcional. Um arquivo CSV ou Excel com colunas de latitude e longitude contém pontos. Por isso, você deve informar um tamanho para cada ponto. Consulte "Tamanho para locais em ponto" abaixo.

O aplicativo também pode ler um polígono de uma coluna com o título geometry, geom, wkt, thegeom ou shape. Essa coluna deve conter a forma como texto WKT, por exemplo POLYGON((...)).

Arquivos GeoJSON, KML e shapefile¶

Estes tipos de arquivo contêm a forma de cada local no arquivo. A página mostra "A geometria será lida do próprio arquivo." Você não define as colunas de coordenadas para estes arquivos.

Um shapefile compactado é um arquivo .zip que contém as partes do shapefile (.shp, .shx, .dbf e, se você tiver, .prj). O arquivo .zip deve conter um arquivo .shp. Ele não pode conter mais de 256 arquivos.

Pontos e polígonos¶

Um local pode ser um polígono ou um ponto.

Um polígono mostra o limite do local. O aplicativo analisa a área dentro do limite.
Um ponto é uma posição de GPS. Para analisar uma área ao redor de um ponto, o aplicativo deve saber o tamanho da área. Depois, o aplicativo cria um círculo ao redor do ponto.

Um arquivo pode conter pontos e polígonos juntos. Um tamanho tem efeito somente nos pontos.

Enviar um arquivo¶

Pressione Escolher arquivo.
Selecione o arquivo no seu computador.
Verifique se a página mostra o nome correto depois de Arquivo selecionado.
Opcional: digite um nome em Nome da lista. Se você não digitar um nome, o aplicativo usa o nome do arquivo.
Opcional: digite um produto básico em Produto básico, por exemplo "cacau".
Examine a seção Confira o mapeamento de campos. Consulte "Relacionar as colunas" abaixo.
Se o arquivo contiver pontos, informe um tamanho. Consulte "Tamanho para locais em ponto" abaixo.
Pressione Enviar e analisar.

NOTA: O botão Enviar e analisar não fica disponível até que a página tenha todos os dados necessários. Leia as mensagens na página para saber o que é necessário.

Relacionar as colunas¶

Depois que você seleciona um arquivo, o aplicativo relaciona as colunas do seu arquivo com os dados de que ele precisa. Se o aplicativo tiver certeza de todas as relações, ele mostra "Relacionamos as colunas do seu arquivo com os campos de que precisamos. Confira antes de analisar."

Para ver ou alterar as relações, pressione Alterar o mapeamento de campos. A tabela tem estas colunas:

Precisamos de: os dados de que o aplicativo precisa, por exemplo Latitude (norte–sul) e Longitude (leste–oeste).
Coluna do seu arquivo: a coluna que contém esses dados. Se a relação não estiver correta, selecione uma coluna diferente.
Valores de exemplo: valores do seu arquivo.
Como foi relacionada: por exemplo Relacionada pelo nome, Relacionada a um apelido conhecido ou Você escolheu esta.

Se o aplicativo não tiver certeza de uma relação, o rótulo verifique este campo aparece ao lado dela. Examine essa relação antes de continuar.

Se alguns exemplos de latitude ou longitude estiverem fora da faixa, o aplicativo mostra um aviso. Por exemplo: "Alguns exemplos de latitude estão fora de −90 a 90. Verifique este mapeamento." Isso geralmente significa que as colunas de latitude e longitude estão nas posições erradas. Selecione as colunas corretas.

Se um campo necessário não tiver coluna, o aplicativo mostra "Mapeie os campos obrigatórios antes de continuar:" e os nomes dos campos. Selecione uma coluna para cada campo.

Quando todos os campos necessários tiverem uma coluna, o aplicativo mostra "Todos os campos obrigatórios foram mapeados".

Se o aplicativo não conseguir ler as colunas, ele mostra "Não foi possível carregar o mapeamento de campos para este arquivo." Pressione Tentar novamente. Você também pode pressionar Enviar e analisar sem uma verificação das colunas.

Tamanho para locais em ponto¶

Se o arquivo contiver colunas de latitude e longitude, o aplicativo mostra Qual é o tamanho de cada local?. Você deve informar um tamanho antes de poder enviar.

Para um arquivo GeoJSON, KML ou shapefile, o tamanho é opcional. Pressione Mostrar opções de tamanho para informar um tamanho. Se o arquivo contiver pontos e você não informar um tamanho, o aplicativo não cria círculos. Cada local continua sendo um ponto.

CUIDADO: Verifique se você selecionou Área ou Raio corretamente. Se você selecionar a opção errada, o círculo tem o tamanho errado e os resultados não estão corretos.

Em Como é definido o tamanho de cada local?, selecione um destes dois valores:
O mesmo para todas as linhas: um valor para todos os pontos.
A partir de uma coluna do arquivo: cada linha tem o seu próprio valor em uma coluna.
Em Trata-se de uma área ou de um raio?, selecione Área ou Raio.
Se você selecionou O mesmo para todas as linhas, digite o valor em Valor.
Se você selecionou A partir de uma coluna do arquivo, selecione a coluna em Coluna.
Opcional: para analisar um anel ao redor de cada local, selecione Adicionar um anel de proteção ao redor de cada local.
Se você selecionou o anel de proteção, digite a largura do anel em Proteção.

As unidades são:

Tamanho	Unidade	Limites
Área	hectares (ha)	Mais que zero.
Raio	quilômetros (km)	No mínimo 0.001 km (1 m). No máximo 500 km.
Proteção	metros (m)	Um número inteiro, no mínimo 1 m. No máximo 500,000 m.

O aplicativo informa o resultado do tamanho. Por exemplo: "círculo 1.00 ha → raio ≈ 56.4 m". O aplicativo não adivinha a unidade nem o tipo de tamanho a partir do nome de uma coluna.

NOTA: O anel de proteção não inclui o próprio local. O aplicativo analisa somente o anel ao redor do local. Um anel de proteção tem efeito em polígonos e em pontos.

Projeção cartográfica¶

O aplicativo precisa de coordenadas em latitude e longitude WGS 84. Se as coordenadas parecerem de um mapa projetado, o aplicativo mostra Qual projeção cartográfica?. Depois, faça estas etapas:

Em Qual projeção este arquivo usa?, selecione a projeção do seu arquivo. O aplicativo pode mostrar uma projeção com o texto sugerida (combina com suas coordenadas).
Pressione Enviar e analisar novamente.

O aplicativo usa a sua seleção somente para este envio. Você pode selecionar uma destas projeções: EPSG:4326, OGC:CRS84, EPSG:3857 e EPSG:24818.

Análise e revisão¶

Depois que você envia o arquivo, o aplicativo analisa cada local. A página mostra "Analisando envio…" e o número de locais que o aplicativo analisou.

Enquanto a análise está em andamento, você pode fazer uma destas ações:

Pressione Cancelar para parar o envio. O aplicativo não guarda a lista.
Pressione Parar e confirmar para parar a análise. O aplicativo guarda somente os locais que ele analisou. Se o aplicativo não analisou todos os locais, a lista tem o rótulo Incompleta.

Quando a análise está concluída, a página Revisar registros analisados aparece. Ela mostra o número de Locais, Analisado com sucesso e Erros. A tabela mostra cada local com a sua Situação. Para um local com a situação Erro, a coluna Explicação informa a causa.

Examine a tabela.
Para guardar a lista, pressione Confirmar lista.
Para não guardar a lista, pressione Descartar.

Quando o aplicativo salva a lista, a página Lista criada aparece. Pressione Ver lista para abrir a lista, ou pressione ← Voltar para listas.

Adicionar um local manualmente¶

Selecione Adicionar um local manualmente.
Digite um nome em Nome. O aplicativo usa este nome para a lista e para o local.
Em Como você vai definir o local?, selecione Ponto GPS único ou Limite poligonal (3 ou mais pontos).
Digite as coordenadas. Consulte as etapas abaixo.
Pressione Criar local.

Para um ponto, faça estas etapas:

Digite a Latitude e a Longitude em graus decimais (WGS 84).
Em Trata-se de uma área ou de um raio?, selecione Área ou Raio.
Digite o valor do tamanho.

Para um polígono, faça estas etapas:

Digite a latitude e a longitude de cada ponto do limite. A página começa com três pontos.
Para adicionar mais um ponto, pressione Adicionar ponto.
Para remover um ponto, pressione Remover ponto desse ponto. Um polígono deve manter no mínimo três pontos.

Você não digita o primeiro ponto novamente no final. O aplicativo fecha o limite automaticamente.

Depois, o aplicativo analisa o local da mesma forma que um arquivo enviado.

Mensagens de erro¶

Se o envio falhar, a página mostra um título de erro, uma causa e uma ação. Para ver os dados técnicos, pressione Detalhes técnicos.

Título do erro	Causa	Ação
"Tipo de arquivo não compatível"	O aplicativo não aceita este tipo de arquivo.	Envie um arquivo CSV, .xlsx, GeoJSON, KML ou shapefile .zip.
"Arquivo muito grande"	O arquivo é maior que 10 MiB (10,485,760 bytes), ou o arquivo .zip contém mais de 256 arquivos.	Divida o arquivo em arquivos menores. Envie cada arquivo como uma lista.
"Planilha larga demais"	Uma linha do arquivo Excel tem mais de 512 colunas.	Remova as colunas de que você não precisa.
"Locais demais"	O arquivo tem mais de 5,000 locais.	Divida o arquivo em arquivos menores. Envie cada arquivo como uma lista.
"Nenhum local encontrado"	O arquivo não tem linhas de dados.	Verifique se o arquivo tem linhas.
"Não foi possível abrir o arquivo compactado"	O arquivo .zip está danificado, ou não tem arquivo .shp.	Exporte o arquivo novamente. Envie-o novamente.
"Não encontramos as colunas dos locais"	O aplicativo não consegue encontrar as colunas de coordenadas.	Defina as relações das colunas. Envie novamente.
"Essa coluna não está no seu arquivo"	As relações das colunas usam uma coluna que não está no arquivo.	Examine as relações das colunas.
"Nenhum local válido"	Nenhum local do arquivo tem coordenadas válidas.	Examine as coordenadas.
"Não foi possível ler o KML/KMZ"	O arquivo KML não é um arquivo KML válido.	Exporte o arquivo novamente. Envie-o novamente.
"Os locais precisam de um tamanho"	O arquivo tem somente pontos e nenhum tamanho.	Informe um tamanho para os pontos.
"Escolha uma unidade"	Um tamanho não tem unidade.	Selecione Área ou Raio.
"Coluna não encontrada"	A coluna de tamanho não está no arquivo.	Verifique se o título da coluna está correto.
"Valor de tamanho não utilizável"	Alguns valores de tamanho estão vazios, são zero ou são grandes demais.	Examine os valores de tamanho nessas linhas.
"Qual projeção cartográfica?"	As coordenadas não estão em latitude e longitude WGS 84.	Selecione a projeção do arquivo.
"Projeção não reconhecida"	O aplicativo não consegue usar a projeção para este arquivo.	Selecione uma projeção diferente.
"Envio expirado"	Você não confirmou o envio a tempo.	Envie o arquivo novamente.
"Envio interrompido"	O envio parou antes de estar concluído.	Envie o arquivo novamente.
"Não foi possível acessar o servidor"	O aplicativo não consegue se conectar ao servidor.	Verifique se o contêiner está em execução. Depois, tente novamente.

NOTA: Os limites de 10 MiB, 512 colunas e 5,000 locais são os valores padrão. A configuração do servidor pode alterá-los.

NOTA: Um erro em um local não para o envio. A tabela de revisão mostra os locais que têm um erro.

Para mais problemas e as ações corretivas, consulte 07-troubleshooting.md.

Renomear uma lista¶

Na página de listas, pressione ⋯ na linha da lista.
Selecione Renomear.
Digite o novo nome.
Pressione Enter para salvar o nome, ou pressione Esc para cancelar.

O nome pode ter no máximo 200 caracteres. Um nome vazio não altera a lista. Se o aplicativo não conseguir salvar o nome, ele mostra "Não foi possível renomear".

Excluir uma lista¶

AVISO: Verifique se você selecionou a lista correta. Você não pode restaurar uma lista depois de excluí-la.

Na página de listas, pressione ⋯ na linha da lista.
Selecione Excluir.
Na mensagem de confirmação, pressione OK.

Se o aplicativo não conseguir excluir a lista, ele mostra "Não foi possível excluir" e mantém a lista.

Atualizar uma lista¶

Você não pode adicionar locais a uma lista nem remover locais de uma lista. Para usar um grupo diferente de locais, crie uma nova lista.

Você pode analisar uma lista novamente com os conjuntos de dados atuais. Use esta ação quando a lista tiver o rótulo Dados mais recentes disponíveis.

AVISO: Leia o custo antes de pressionar Executar novamente. Se a caixa de diálogo mostrar "Lido do WRI online, cobrado na sua conta da AWS", a análise gera uma cobrança na sua conta da AWS. Você deve marcar Entendo que esta execução é cobrada na minha conta da AWS. antes de pressionar Executar novamente.

Na página de listas, pressione ⋯ na linha da lista.
Selecione Executar novamente com dados atuais.
Leia quais conjuntos de dados mudaram depois da última análise.
Em Como a nova execução deve ser aplicada?, selecione um destes dois valores:
Atualizar esta lista: o aplicativo substitui os resultados da lista. O nome, as notas e as datas da lista continuam os mesmos.
Criar uma nova cópia: o aplicativo cria uma nova lista com os mesmos locais. A lista inicial não muda.
Pressione Executar novamente.

Se a atualização falhar, o aplicativo mantém os resultados anteriores. Você também pode iniciar esta ação na página da lista. Para mais dados sobre custos, consulte 03-analysis-and-results.md.

O menu ⋯ também tem Exportar. Exportar baixa os resultados da lista como um arquivo CSV. Você pode pressionar Exportar somente quando a análise da lista estiver concluída. Para exportações, consulte 05-exports.md.