Survey Topo

Levantamento e locação topográfica com GNSS RTK

Documentação do aplicativo
Versão do app: 0.3.13 · Android 6.0 ou superior
RPF Geomática
Documento gerado em 22/11/2026

Sumário

  1. Visão geral
  2. Instalação e primeiro uso
  3. Interface e navegação
  4. Aba Projeto
  5. Aba Dispositivo
  6. Aba Levantamento
  7. Aba Ferramentas
  8. Configurações do aplicativo
  9. Qualidade e critérios de coleta
  10. Formatos de arquivo
  11. Licenciamento
  12. Funções ainda não implementadas
  13. Solução de problemas

1. Visão geral

O Survey Topo é um aplicativo Android para coletar e locar pontos topográficos com receptores GNSS. Ele se conecta ao receptor por Bluetooth, lê a posição e a qualidade da solução (RTK Fixo, Float, PPP), registra pontos com critérios de qualidade e permite locar pontos, linhas, desenhos CAD e superfícies em campo.

Para quem

Topógrafos, agrimensores e equipes de campo que precisam coletar coordenadas UTM com controle de qualidade e exportar os dados para CAD e SIG.

O que resolve

Projeto organizado por referencial e zona UTM, coleta com regras de precisão, locação guiada por mapa, som e voz, correções NTRIP pelo celular e exportação em TXT, CSV, DXF, DWG, KML, SHP e HTML.

Principais recursos

Os projetos ficam salvos no próprio aparelho, no armazenamento do aplicativo. A coleta e a locação funcionam sem internet. A internet é usada para o mapa de fundo (OpenStreetMap), para correções NTRIP e para validar a licença online.

2. Instalação e primeiro uso

Requisitos

ItemRequisito
AparelhoAndroid 6.0 (API 23) ou superior, com Bluetooth.
ReceptorGNSS com saída NMEA por Bluetooth SPP. O app foi preparado para o perfil K803 (placa Unicore UM980), que também é a referência para os dados brutos.
InternetOpcional em campo. Necessária para ativar a licença online, para o NTRIP e para o mapa de fundo.

Instalação

  1. Copie o arquivo Survey_Topo_v0.3.13_licenca_online.apk para o celular.
  2. Abra o arquivo e permita a instalação de apps desta fonte, se o Android pedir.
  3. Versões novas instalam por cima das anteriores e preservam projetos e licença, desde que assinadas com a mesma chave.

Primeiro uso

  1. Abertura: o logotipo aparece por cerca de 2,5 segundos.
  2. Licença: em Dispositivo › Registrar (ou na tela de bloqueio), digite a chave recebida (ex.: ST-XXXX-XXXX-XXXX-XXXX) e toque em Ativar online.
  3. Projeto: o app começa na Área demonstrativa, com 5 pontos de exemplo. Crie um projeto real em Projeto › Projeto.
  4. Referencial: em Projeto › Datum, escolha o datum e a zona UTM.
  5. Receptor: pareie o receptor no Android e conecte em Dispositivo › Conexão.
  6. Coleta: em Levantamento › Topo Survey, colete os pontos.
Licençachave online ou código
Projetonovo ou existente
Datumreferencial + zona UTM
ConexãoBluetooth + NTRIP
Coletapontos com qualidade
ExportaçãoTXT, DXF, DWG, SHP…

3. Interface e navegação

Cabeçalho

Abas principais

A barra inferior tem quatro abas: Projeto, Dispositivo, Levantamento e Ferramentas. Cada aba mostra atalhos em blocos; o bloco Mais abre funções adicionais.

Deslize entre abas

Nas telas principais das abas, deslize o dedo para a esquerda para ir à próxima aba e para a direita para voltar. A tela acompanha o dedo; gestos curtos voltam ao lugar. O deslize não age sobre mapas, desenhos, campos de texto e listas com rolagem lateral, nem dentro das telas internas.

Telas internas

Ao abrir um atalho, o título da tela aparece no topo com o link ‹ voltar para a aba de origem.

4. Aba Projeto

AtalhoO que faz
ProjetoLista, cria, abre, renomeia e exclui projetos. Cada projeto guarda seus pontos, referencial, zona UTM, códigos, perfis e ajustes de coleta.
DatumDefine o referencial (SIRGAS 2000, SAD69 ou SAD69 IBGE) e a zona UTM do projeto. As coordenadas UTM e a conversão para latitude e longitude usam esse referencial.
ElementosLista de pontos do projeto, com busca, detalhes (nome, código, coordenadas, origem da medição, solução, horário UTC, antena e base vinculada), edição e exclusão.
Calibração localTransformação de similaridade 2D a partir de pares de controle (veja abaixo).
ImportarImporta pontos de arquivos TXT, CSV e DAT em 14 formatos prontos ou em configuração livre.
ExportarExporta os pontos em formatos de pontos (TXT, CSV, DAT) e em outros formatos: DWG, DXF, KML, SHP, HTML e dados brutos.
CódigoCadastro de códigos de ponto (ex.: DIVISA, EIXO) usados na coleta e na exportação.
ConfiguraçõesConfigurações do projeto, incluindo unidades e precisão (comprimento, área, volume, ângulos e casas decimais).
SuperfícieImporta superfícies TIN em LandXML (.xml) para consulta de cota e locação de superfície.
MaisAssistente (sequência guiada: projeto, datum, conexão, base, rover, levantar, locar) e Exportar resultados.

Calibração local

Informe pelo menos três pares de pontos, um por linha, no formato E medido; N medido; h medido; E conhecido; N conhecido; h conhecido. O app calcula escala, rotação e translação horizontal e um deslocamento vertical médio, e mostra os resíduos máximos horizontal e vertical antes de aplicar.

Importação

Escolha o formato, indique se o arquivo tem cabeçalho e o que fazer quando o nome de um ponto já existir. A configuração livre aceita outras ordens de colunas e delimitadores. Veja a lista completa em Formatos de arquivo.

5. Aba Dispositivo

AtalhoO que faz
ConexãoConecta o receptor por Bluetooth serial (SPP). Botões Parear no Android, Listar pareados, Conectar e Desconectar. Modo Serial autenticado (padrão) ou Serial compatível para receptores que recusam a conexão autenticada. Mostra solução, qualidade e satélites por constelação. Em projetos reais, peça a confirmação de que a saída do receptor usa o referencial do projeto.
RoverRedes NTRIP do aparelho: adicionar, editar, selecionar, excluir e Conectar NTRIP. As correções recebidas são encaminhadas ao receptor pela conexão Bluetooth ativa, com contadores de dados.
BasePerfis de base: correção por rádio interno, GSM do receptor ou internet/NTRIP; frequência, servidor, porta, mountpoint; posição Auto Base ou fixa (E, N, Z). Os perfis ficam salvos no projeto e não são enviados ao receptor.
Info. dispositivoPerfil do receptor, tipo de entrada e estado da conexão.
Info. posiçãoCoordenadas atuais, solução e altura de antena.
RegistrarTela de licença do aplicativo (veja Licenciamento).
MaisSatélites (tabela e gráfico do céu por constelação: GPS, GLONASS, Galileo, BeiDou, SBAS, QZSS), Antena, Navegar até a base, Configuração rápida, H-Terminal, Dados de diagnóstico e Simulação.

NTRIP

CampoUso
Servidor e portaEndereço do caster (porta padrão 2101).
MountpointFonte de correções RTCM3.
Usuário e senhaCredenciais do caster. A senha fica guardada de forma protegida no aparelho.
ProtocoloNTRIP v1, NTRIP v2 ou automático. No automático, o app alterna versões e o envio de GGA a cada falha até achar a combinação aceita.
TLSConexão criptografada com o caster.
VRSEnvia a posição GGA ao caster (a cada 10 s). Exige posição válida antes de conectar.

O app valida a resposta do caster, rejeita lista de fontes, credenciais recusadas e conteúdo em texto, e só repassa ao receptor quadros RTCM3 com CRC válido. Depois de 3 falhas seguidas, a conexão é encerrada com a causa.

Diagnóstico

6. Aba Levantamento

AtalhoO que faz
Topo SurveyCaderno de campo: mapa com a posição atual e os pontos, botão de coleta, nome e código do próximo ponto, observação com tempo de ocupação e verificação de qualidade antes de salvar.
Locar pontoEscolha o ponto e siga as indicações de distância e direção (ΔE, ΔN, distância horizontal e diferença de cota), com agulha no mapa, bússola, alarme visual de aproximação e dica de voz.
CADAbre desenhos DXF e DWG e loca elementos do desenho. O desenho deve usar X = Este e Y = Norte, na mesma zona UTM e referencial do projeto.
Locar linhaSelecione os pontos na ordem da linha. Mostra distâncias acumuladas, cotas interpoladas entre vértices e estacas em intervalo fixo.
Locar superfícieUsa a superfície TIN importada: mostra a cota da superfície na posição atual e o corte ou aterro em relação ao terreno medido.
Área do levantamentoCalcula área e perímetro a partir dos pontos selecionados.
MaisLevantamento automático, Antena e Ajustes do levantamento. Estático e PPK aparecem mas ainda não estão implementados.

Levantamento automático

Escolha o critério (tempo em segundos ou distância em metros), o intervalo e o código. O app grava pontos automaticamente, cada um passando pela verificação de qualidade. A sessão continua ao navegar entre telas e para ao trocar de projeto ou fechar o app.

Desenho de linhas

No mapa, toque para marcar vértices ou use a agulha para posicionar cada vértice com precisão. As cotas dos desenhos são indefinidas; a locação de desenhos é horizontal.

7. Aba Ferramentas

AtalhoO que faz
Grid ShiftAltera a referência da base: calcula a translação entre a base atual e a base de destino e aplica a todos os pontos, com prévia, histórico e desfazer.
Cálculo de áreaÁrea e perímetro de polígonos formados por pontos do projeto.
COGOCálculos de geometria de coordenadas (lista abaixo).
MaisTransformação angular. Terraplenagem e Alcance do laser aparecem mas ainda não estão implementados.

Cálculos COGO

CálculoDescrição
Dois pontos (inverso)Distância, azimute e diferenças de coordenadas entre dois pontos.
Grade para o soloConverte distâncias de quadrícula UTM para o solo e vice-versa.
Ponto para linhaProjeção de um ponto sobre uma linha (estaca e afastamento).
Ponto offsetNovo ponto a partir de distância e afastamento em relação a uma linha.
Ângulo de deflexãoDeflexão entre alinhamentos.
Ponto de interseçãoInterseção de duas linhas.
Ponto de bissecçãoPonto na bissetriz de um ângulo.
Pontos de linhaPontos intermediários ao longo de uma linha.
Ponto médio / médiaMédia de vários pontos.
Dois círculos se cruzamInterseção de dois círculos (distâncias a partir de dois pontos).
Cálculo de ânguloÂngulo formado por três pontos.
Transformação angularConverte ângulos entre graus decimais, graus-minutos-segundos, radianos e grados (gon).

8. Configurações do aplicativo

GrupoOpções
GeralConexão automática ao receptor; dica de voz (com volume).
ExibiçãoCoordenadas na tela principal; zoom do mapa; orientação (do dispositivo, retrato, paisagem); tema claro, escuro ou do dispositivo; ordem das coordenadas (E, N ou N, E); ícone de localização (ponto ou mira) e bolha de inclinação.
SistemaLicença do aplicativo; idioma (Português do Brasil); unidade de exibição e precisão; faixa de trabalho (raio); atalho de coleta por tecla física (F8, F9 ou F10).
Modo desenvolvedorExibe H-Terminal e Dados de diagnóstico.
LevantamentoAjustes do levantamento: antena e critérios RTK.

9. Qualidade e critérios de coleta

O botão Configuração nas telas de coleta e locação abre os critérios do projeto. Os valores ficam salvos só no projeto atual.

CritérioEfeitoFaixa
Fixo · exigir RTK FIXSó aceita pontos com solução RTK Fixa. Desligado, aceita outras soluções válidas (inclusive PPP).liga/desliga
H.RMS / V.RMSLimites de incerteza horizontal e vertical informados pelo receptor.0,001 a 100 m
Verificar PDOP / PDOP máximoRejeita a coleta acima do PDOP definido (exige mensagem GSA recente).0,1 a 100
Tempo de ocupaçãoDuração da observação de cada ponto.1 a 3600 s
Raio de deslocamentoMovimento máximo do receptor durante a ocupação.0,001 a 1000 m
Salvar automaticamenteGrava o ponto ao fim da ocupação quando todos os critérios são atendidos.liga/desliga
Permitir nome duplicadoAceita dois pontos com o mesmo nome.liga/desliga
Incremento do nomePasso da numeração automática dos pontos.1 a 10000
Altura vertical da antenaReduz a coordenada da antena ao ponto no chão.0 a 100 m
Alarme visual de locaçãoDistância em que a locação avisa que o ponto está próximo.0,001 a 100 m
Nenhum critério altera o referencial nem configura o receptor. A frequência de saída do receptor (1 Hz no perfil K803) não muda com o tempo de ocupação.

10. Formatos de arquivo

Importação e exportação de pontos

FormatoExtensãoSeparadorCoordenadas
Nome N E Z RMS.txtespaçoUTM
Nome,B,L,H.txtvírgulageográficas
Nome,N,E,Z.txt / .csvvírgulaUTM
Nome,E,N,Z.txtvírgulaUTM
Nome E N Z.txtespaçoUTM
CASS (Nome, Código, E, N, Z).datvírgulaUTM
Nome,Códigos,N,E,Z.csvvírgulaUTM
Nome Códigos N E Z.txtespaçoUTM
Nome N E Z.txtespaçoUTM
Nome B L H.txtespaçogeográficas
B L H Nome.txtespaçogeográficas
Nome,Códigos,B,L,H.csvvírgulageográficas
B,L,H,Nome,Códigos.csvvírgulageográficas
Configuração livre—escolhidoescolhida

Outros formatos de exportação

FormatoConteúdo
DWGDesenho com os pontos do projeto em coordenadas UTM.
DXFDesenho com os pontos e seus nomes em coordenadas UTM.
KMLPontos em latitude e longitude para visualização em mapas (Google Earth).
SHPShapefile PointZ em ZIP com SHP, SHX, DBF, PRJ e CPG.
HTMLRelatório com os pontos do projeto.
BrutosArquivo original do levantamento estático do K803 ou UM980.

Superfícies

LandXML TIN (.xml), com coordenadas na ordem Norte, Este e cota.

11. Licenciamento

Cada licença fica vinculada ao identificador do aparelho (ST- seguido de 32 caracteres), mostrado na tela de licença com o botão Copiar identificador.

Tipos de licença

TipoComportamento
30 dias (com vencimento)Vale até a data de vencimento definida no painel (padrão: 30 dias após a criação). Com internet, o app renova o código interno sozinho. Depois do vencimento, o servidor recusa e o app trava; o administrador renova com +30 dias.
VitalíciaSem vencimento. Funciona sem internet indefinidamente. Pode ser retirada de um aparelho com Desvincular, que trava o app quando ele se conectar.

Formas de ativação

Regras de validação

12. Funções ainda não implementadas

Estes atalhos aparecem nos menus, mas mostram um aviso em vez de executar:

FunçãoSituação
EstáticoO app lê NMEA e ainda não grava observações GNSS brutas.
PPKExige observações brutas sincronizadas de base e rover; integração não implementada.
Saída NMEA 0183Configurar porta, velocidade e mensagens exige enviar comandos ao receptor; ainda não aplicado.
Locar arcoAinda não implementada.
TerraplenagemCálculo ainda não implementado.
Alcance do laserDepende de equipamento e protocolo compatíveis; não integrado.
Acesso remotoNão integrado.
Perfis de Base e Rover são salvos no projeto, mas não são enviados ao receptor: a configuração do equipamento continua sendo feita no próprio receptor.

13. Solução de problemas

SintomaO que fazer
"Sem conexão com o servidor de licenças"Confira a internet do celular e tente novamente. Versões anteriores à 0.3.1 bloqueavam essa conexão: atualize o app.
App travado com "Licença bloqueada"A licença foi bloqueada, desvinculada ou venceu. Peça ao administrador para reativar, reautorizar ou renovar; com internet, o app libera em até 1 minuto.
"Validação pendente"A licença de 30 dias está há mais de 7 dias sem confirmação, ou a data do aparelho está errada. Conecte à internet e corrija data e hora.
Receptor não conectaPareie o receptor nas configurações do Android, use Listar pareados e tente o modo Serial compatível.
NTRIP sem FIXVeja em Rover o estado e os contadores. Confira mountpoint, usuário e senha; para VRS, aguarde uma posição válida antes de conectar.
Coleta recusadaA solução não atende aos critérios (FIX, H.RMS, V.RMS, PDOP ou movimento). Veja a mensagem e ajuste em Configuração, se adequado.
Ícone antigo após atualizarReinicie o celular ou recoloque o atalho na tela inicial.