Manual do ContestMap

Mostre ao vivo, num mapa, os contatos que você está fazendo no contest.

1. O que é o ContestMap

O ContestMap recebe os contatos (QSOs) que você registra no N1MM Logger+ e os mostra, em tempo real, num mapa e numa lista, lado a lado. Os dados de cada estação contatada (nome, cidade, país, foto e localização) são buscados automaticamente no QRZ.com.

O Agente é um pequeno programa que roda no mesmo PC do N1MM. Ele recebe cada contato assim que você o registra e o envia para o site. Você pode compartilhar o endereço do seu mapa com quem quiser acompanhar a sua operação.

2. Primeiros passos

Resumo do que é preciso fazer uma única vez:

1. Crie sua conta em contestmap.ike.net.br, com o seu indicativo, e aguarde a aprovação (seção 3).
2. Marque a posição da sua estação no mapa (seção 4).
3. Gere a chave de API e copie-a (seção 5).
4. Baixe e configure o Agente no PC do N1MM (seção 6).
5. Ative o envio de dados no N1MM (seção 7).

Pronto: faça um contato de teste no N1MM e ele aparecerá no seu mapa em poucos segundos.

3. Conta e login

Na página inicial, clique em Criar conta e informe:

• Indicativo: é o seu login. Use o indicativo base, sem /P, /M etc. Maiúsculas e minúsculas tanto faz: py3xxx e PY3XXX são a mesma conta.
• Nome e Email.
• Senha, com no mínimo 6 caracteres.

Para trocar o nome, o email ou a senha depois, vá em Config → Dados pessoais.

4. Posição da sua estação

A sua estação aparece no mapa com o ícone 📡. As linhas até os contatos também partem dela. Em Config → Posição da minha estação você pode informar a posição de três jeitos:

• Clicando no mapa. Dá para arrastar o marcador para ajustar.
• Digitando o grid locator, por exemplo GG40 ou GG40ab. O quadrado é desenhado no mapa.
• Digitando latitude e longitude em graus decimais, por exemplo -29.68 e -51.13.

Os três campos se completam sozinhos: ao clicar no mapa, o grid e a lat/lon são preenchidos. O botão 📍 Minha localização usa o GPS do celular ou a localização do navegador. Termine clicando em Salvar posição.

5. Chave de API

A chave de API é a "senha" que o Agente usa para enviar os seus contatos. Em Config → Chave de API e Agente, clique em Gerar chave de API.

Nessa mesma seção aparecem o endereço do servidor que vai no Agente e a lista de agentes conectados, com a última conexão de cada PC e quantos contatos estão na fila.

6. Agente ContestMap (Windows)

Baixar e abrir

1. Em Config → Chave de API e Agente, clique em ⬇️ Baixar Agente (Windows).
2. Salve o arquivo ContestMapAgent.exe numa pasta de sua preferência. Não precisa instalar.
3. Dê dois cliques para abrir.

Configurar

Na aba Configuração, preencha:

Clique em Testar conexão. Se aparecer "Conexão OK", clique em Salvar.

Acompanhar o funcionamento

• N1MM: escutando UDP 12060 em verde significa que o Agente está pronto para receber os contatos.
• Servidor: conectado em verde significa que os contatos estão chegando ao site.
• Recebidos / Enviados / Na fila: contadores desde que o Agente foi aberto.
• Mapa: Público / Com atraso / Privado muda na hora quem pode ver o seu mapa (seção 9).
• Abrir meu mapa abre o seu mapa no navegador.
• Registro: cada contato recebido e cada envio, com a hora.

Internet caiu?

Sem problema. Os contatos ficam guardados numa fila no próprio PC, e o contador Na fila mostra quantos são. Eles são enviados automaticamente quando a conexão voltar, mesmo que você feche e abra o Agente nesse meio tempo.

7. Configurar o N1MM Logger+

O N1MM precisa ser avisado para enviar os contatos ao Agente:

1. No N1MM, abra Config → Configure Ports, Mode Control, Winkey, etc.
2. Vá até a aba Broadcast Data.
3. Marque a opção Contacts.
4. No campo de endereço dessa linha, informe 127.0.0.1:12060. Se você mudou a porta no Agente, use a mesma aqui.
5. Clique em OK.

Não é preciso marcar Radio, Score e as outras opções: o Agente usa apenas os contatos. Edições e exclusões feitas no N1MM também são enviadas e atualizam o mapa.

8. Usando o mapa

O endereço do seu mapa é https://contestmap.ike.net.br/m/SEUINDICATIVO, por exemplo https://contestmap.ike.net.br/m/PY3IKE. Com o mapa aberto, cada novo contato aparece na hora, sem recarregar a página. No canto superior direito, ao vivo indica que a atualização em tempo real está ativa.

Cores e marcadores

Cada banda tem uma cor, e a legenda fica no canto inferior esquerdo do mapa:

A banda e o modo contam separadamente: o mesmo indicativo em 20 m CW e em 20 m SSB são dois contatos. Na lista, ao lado do indicativo, aparecem etiquetas com todas as combinações já feitas, por exemplo 40·SSB20·CW.

Onde cada estação aparece

A posição vem do cadastro da estação no QRZ.com, nesta ordem de preferência:

Um contato novo aparece primeiro na lista. O marcador surge no mapa segundos depois, quando a consulta ao QRZ termina. Estações que não existem no QRZ e não informaram grid ficam só na lista.

Lista de contatos

• O contato mais recente fica no topo. Contatos novos piscam em amarelo por alguns segundos.
• Clique numa linha para centralizar o mapa na estação e abrir o balão com foto, nome, QTH, link para o QRZ.com e todos os contatos feitos com ela.
• Buscar indicativo filtra a lista e o mapa.
• Todos os modos filtra por modo (SSB, CW, FT8…).
• Botões de banda: o primeiro clique mostra só aquela banda, e os cliques seguintes somam ou tiram outras bandas.
• Passe o mouse sobre a hora para ver a data completa. A frequência mostra a de recepção; se você operou em split, passe o mouse para ver a de transmissão.

Camadas do mapa

No botão de camadas, no canto superior direito do mapa, você escolhe o fundo (Claro, Escuro, OpenStreetMap ou Satélite) e liga ou desliga:

• Estações: os marcadores.
• Quadrados de grid: os quadrados das estações posicionadas por grid.
• Linhas até as estações: linhas de círculo máximo (o caminho mais curto sobre a Terra) da sua estação até cada contato.

O navegador lembra as suas escolhas.

9. Quem pode ver o seu mapa

Você escolhe com um clique, em Config → Visibilidade do mapa ou na aba Status do Agente:

Quem já está com o mapa aberto vê a mudança na hora. Você, logado, sempre vê o seu mapa completo e ao vivo. Mapas públicos e com atraso aparecem na lista Mapas ao vivo da página inicial.

Link privado em tempo real

Para mostrar o mapa ao vivo só para algumas pessoas (sua equipe, o clube), crie um link privado em Config → Link privado em tempo real. Quem tiver o link vê o mapa completo e ao vivo mesmo com o mapa privado ou com atraso.

• Gerar novo link invalida o anterior. Use se o link vazou.
• Desativar link faz o link parar de funcionar.

10. O que o mapa exibe

O ContestMap guarda todos os seus contatos, separados por contest. Cada edição é identificada pelo nome do contest no N1MM e pela data, por exemplo "CQWWSSB – out/2026". Um novo contest com o mesmo nome, depois de mais de 3 dias sem contatos, vira uma nova edição.

Em Config → O que o mapa exibe, ou no seletor do topo do seu mapa, escolha:

• Contest mais recente (automático): o padrão. Quando você começa outro contest, o mapa passa a mostrá-lo sozinho.
• Um contest específico, para rever uma edição antiga.
• Intervalo de datas, em UTC.
• Todos os contatos.

A escolha vale para todos que olham o seu mapa, inclusive pelo link privado.

11. Cores e logotipo

Em Config → Aparência do mapa você personaliza o seu mapa. As escolhas valem também para quem visita o mapa, e mudam na hora para quem já está com ele aberto.

• Tema de cores: 8 opções (Azul, Verde, Vermelho, Laranja, Roxo, Petróleo, Dourado e Grafite). O tema muda a cor do cabeçalho, dos botões e das linhas selecionadas. As cores das bandas não mudam.
• Modo: Automático segue o aparelho de quem está vendo (claro de dia, escuro à noite, se o aparelho estiver assim configurado); Claro e Escuro fixam o modo.
• Logotipo da estação: envie uma imagem PNG, JPG, WebP ou GIF de até 3 MB. Ela é reduzida automaticamente e aparece no topo do seu mapa, na lista Mapas ao vivo da página inicial e, no lugar do ícone 📡, no marcador da sua estação. Imagens com fundo branco ou transparente ficam melhores.

12. Multi-op: vários PCs

Em operações com vários computadores (por exemplo, run e mult com o N1MM em rede):

1. Rode o Agente em cada PC, com o mesmo indicativo e a mesma chave de API.
2. Dê um nome diferente para cada PC no campo "Nome da estação/PC".
3. Configure o Broadcast Data do N1MM em cada PC, como na seção 7.

Mesmo que o mesmo contato chegue por mais de um PC, ele aparece uma vez só, porque o N1MM dá um código único a cada contato. A coluna Origem da lista mostra de qual PC ele veio, e Config → Agentes conectados mostra se cada PC está online.

13. Problemas comuns