# Novo mapa

Use esta página quando você vai cadastrar um mapa novo no arquivo.

## Use esta ordem

1. Abra **Novo mapa** pelo Início ou **Meu arquivo**.
2. Preencha nome, data e local.
3. Defina horário local ou UTC e confira o fuso aplicado.
4. Revise a etapa **Salvar** e confirme.

## Regra rápida

- ative **Versão estendida** se o mapa é importante para atendimento ou arquivo técnico;
- registre qualidade de fonte antes de salvar um dado sensível;
- compare atlas e local manual para eventos fora da base;
- prefira **Hora não informada** do que inventar minutos aleatórios.

## Ir para

- [Editar depois de salvar](ajuda/editar-mapa) - Altere nome, data, local, fuso e demais campos quando revisar fonte.
- [Importar dados](ajuda/exportaimporta) - Traga dados externos e revise no fluxo de novo mapa.
- [Organizar no Meu arquivo](ajuda/meu-arquivo) - Acompanhe e organize o mapa dentro da sua estrutura.

![Novo mapa](/img/edchart/newchart.png)
_No cadastro novo, preencha dados básicos primeiro e deixe campos avançados para quando forem necessários._

Use **Novo mapa** quando você quer cadastrar uma pessoa, evento, organização, país, cidade ou outro registro no seu arquivo.

O mapa novo passa pelo mesmo editor usado em **Editar mapa**, mas com uma diferença importante: enquanto você não salva, ele ainda não existe no seu arquivo. O que aparece na tela é um rascunho de criação.

A janela abre por cima da tela em que você estava. A URL não muda: ao cancelar ou fechar, você volta para o **Início**, **Meu arquivo** ou qualquer tela que estava aberta por baixo.

## Onde criar

Você pode iniciar um mapa novo por mais de um lugar:

- no **Início**, pelo botão **mapa** ao lado da busca;
- em **Meu arquivo**, pelo botão **mapa** no topo da lista;
- quando o arquivo está vazio, pelo botão **novo mapa** da tela vazia;
- no fluxo de importação, criando um novo mapa para revisar dados vindos de outro sistema.

Se você quer abrir alguém que já está cadastrado, use a busca. Se quer colocar um registro novo no seu arquivo, use **mapa**.

## Antes de começar

Separe o que você sabe:

- nome ou identificação do mapa;
- data;
- hora, se existir;
- local;
- fonte da hora;
- pasta onde quer guardar;
- se deve aparecer em aniversários.

Se a hora é incerta, não invente. É melhor salvar um mapa sem hora do que salvar uma hora falsa que parece precisa.

## O mínimo para salvar

![Dados inválidos](/img/edchart/newinvalid.png)
_Quando o app marcar campos inválidos, corrija o bloco indicado antes de tentar salvar de novo._

O Astrologic precisa de:

- nome com pelo menos 3 caracteres;
- data;
- local com cidade, país, longitude e latitude;
- fuso conferido quando existe hora.

As etapas com problema ficam marcadas em vermelho. Se a etapa **Salvar** não libera o salvamento, volte para a etapa marcada e corrija.

## Fluxo recomendado

1. Preencha o **nome do mapa**.
2. Ative **Versão estendida** se precisa definir tipo, fonte, calendário ou observações.
3. Informe **data e hora**.
4. Escolha se a hora é **local** ou **UTC**.
5. Pesquise o **local no atlas**.
6. Confira o **fuso aplicado**.
7. Escolha onde **salvar**.
8. Revise tudo na etapa **Salvar**.

Para cadastro rápido, você pode ficar na versão simples. Para mapa importante, use a versão estendida já no primeiro cadastro.

## Versão simples e versão estendida

Na versão simples, a primeira etapa fica bem curta: você informa o **nome do mapa** e segue.

Na **Versão estendida**, o editor libera mais campos e opções:

- tipo do mapa;
- gênero, quando o tipo usa essa informação;
- nome original;
- breve descrição;
- qualidade da fonte da hora;
- nota sobre a origem dos dados;
- calendário e opções de hora;
- aniversário;
- falecimento/finalização.

Use a versão simples para cadastro rápido e sem dúvida. Use a versão estendida quando o mapa vai entrar no arquivo de trabalho, quando veio de importação, quando a hora precisa de contexto ou quando você quer evitar retrabalho depois.

Você pode ligar a versão estendida no meio do cadastro. Os dados já preenchidos continuam ali.

## Nome e tipo

O nome é o que aparece no arquivo, na busca, no Feed, na Lousa e nas exportações.

Use um nome que você reconheça depois. Em arquivo grande, nomes genéricos atrapalham:

- ruim: "Maria";
- melhor: "Maria Silva";
- melhor ainda, quando necessário: "Maria Silva - cliente 2026".

Na versão estendida, escolha o tipo:

- **Pessoa**: mapa pessoal comum.
- **Figura pública**: pessoas públicas, celebridades, políticos, artistas.
- **Anônimo**: quando a identidade não deve aparecer ou não é importante.
- **Acontecimento no mundo**: posse, acidente, lançamento, assinatura, eclipse, ingresso.
- **Nação/Estado/Cidade**: mapas coletivos de lugares.
- **Organização**: empresas, instituições, grupos.
- **Celeste**: mapas ligados a fenômenos celestes.
- **Indeterminado**: quando o tipo ainda não foi definido.

Não use **Pessoa** para tudo. O tipo certo ajuda a ler o arquivo e evita rótulos estranhos depois.

Por padrão, um mapa novo começa como **Pessoa**. Troque o tipo quando o registro não é uma pessoa: evento, organização, cidade, país, fenômeno celeste ou estudo sem identidade pública.

## Data e hora

![Seção data e hora do mapa](/img/edchart/sectdate.png)
_Confira data, hora e confiabilidade da hora antes de seguir; esses dados mudam casas, ângulos e técnicas._

A data é obrigatória. A hora é opcional, mas muda profundamente o que o mapa consegue mostrar.

Com hora, o Astrologic pode calcular:

- Ascendente;
- Meio do Céu;
- casas;
- partes;
- técnicas que dependem de eixos;
- trânsitos por casas;
- interpretações que usam hora.

Sem hora, o mapa continua útil, mas fica mais limitado. Em alguns casos, a Lua pode ficar menos precisa, porque ela se move rápido ao longo do dia.

Na tela, a data é preenchida em **dia / mês / ano** e a hora em **hora : minuto**. Se a hora não existe, use a opção **Hora não informada**. Não deixe o campo vazio por distração: faça disso uma escolha consciente.

### Quando deixar sem hora

Deixe sem hora quando:

- a fonte não informa horário;
- a hora é chute;
- só existe "manhã", "tarde" ou "noite";
- você sabe a data, mas não confia no horário;
- há versões conflitantes e nenhuma é melhor.

Não use 12:00 como solução automática. Use 12:00 só quando a fonte realmente informa meio-dia ou quando você está fazendo um mapa técnico com essa escolha consciente.

### Hora local ou UTC

Use **local** quando a fonte fala no horário do lugar:

- nascimento às 08:30 em São Paulo;
- evento às 19:00 em Paris;
- assinatura às 10:00 em Brasília.

Use **UTC** quando a fonte já vem em tempo universal:

- 12:00 UTC;
- 03:15 UT;
- evento astronômico;
- log técnico;
- dado de efeméride.

UTC evita confusão de fuso quando a fonte já está nesse padrão. Mas não transforme uma hora local em UTC sem converter.

Na revisão final, o Astrologic mostra se a hora foi tratada como local ou UTC. Se isso estiver diferente da fonte, volte para **Data** antes de salvar.

## Qualidade da fonte

Para mapa importante, registre a qualidade da data e hora.

Use qualidade alta quando existe fonte forte, como documento, registro oficial ou retificação bem feita. Use qualidade baixa quando a fonte é memória, imprensa, aproximação, conflito de dados ou origem desconhecida.

Boas notas de fonte são diretas:

- "certidão em mãos";
- "hora informada pela mãe";
- "reportagem, sem documento";
- "evento registrado em UTC";
- "hora retificada, fonte no prontuário";
- "sem hora".

Isso ajuda você, o suporte e qualquer pessoa que use o mapa depois.

Se a fonte é fraca, escreva isso sem vergonha. Um mapa com "hora aproximada por memória" é mais honesto do que um mapa que parece exato e não é.

## Local e atlas

![Pesquisa no atlas](/img/edchart/atlassearch.png)
_Pesquise cidade e país no Atlas para preencher coordenadas e fuso com mais segurança._

Comece sempre pelo atlas quando possível.

Na etapa **Local**, você escolhe entre **Pesquisar no atlas** e **Definir manualmente**.

Ao escolher uma cidade do atlas, o Astrologic guarda o vínculo com a localidade. Isso ajuda a conferir fuso histórico e reduz risco de coordenada errada.

Se a cidade não aparecer:

1. pesquise uma cidade próxima;
2. selecione a opção mais parecida;
3. abra **Definir manualmente**;
4. ajuste nome, país, longitude e latitude;
5. aplique o local.

## Local manual

![Seção local do mapa](/img/edchart/sectlocal.png)
_Revise cidade, país, coordenadas e fuso antes de salvar mapas dependentes de local._

Use local manual quando o mapa é de:

- bairro;
- hospital;
- observatório;
- empresa;
- prédio público;
- local de evento;
- cidade pequena ausente no atlas;
- coordenada fornecida pela própria fonte.

Confira com atenção:

- longitude leste/oeste;
- latitude norte/sul;
- país;
- se o local realmente corresponde ao evento.

Erro de coordenada pode mudar casa, Ascendente e técnicas sensíveis ao local.

Quando usar local manual, confira principalmente o sinal da longitude e da latitude. Brasil, por exemplo, normalmente fica em longitude oeste e latitude sul. Um sinal invertido pode jogar o mapa para outro lado do mundo.

## Fuso

![Detalhes completos da configuração de fuso horário](/img/edchart/tminfo.png)
_Abra as informações de fuso quando precisar entender se o horário veio do Atlas ou de ajuste manual._

Quando o mapa tem hora, o fuso precisa ser coerente com data e local.

O editor pode mostrar:

- fuso aplicado;
- fuso oficial base;
- sugestão de fuso histórico;
- período de início/fim da regra;
- aviso de local fora do atlas;
- erro de consulta quando a conexão falha.

Se o fuso automático sugerir uma alteração, confira antes de salvar. Se você tem uma fonte melhor para aquele caso, use fuso manual e registre a justificativa na nota.

## Salvar em pasta

![Seção arquivo na edição de dados](/img/edchart/sectarc.png)
_Use a seção Arquivo para escolher pasta, organização e dados complementares do cadastro._

Escolha a pasta antes de salvar.

Use pastas para evitar que o mapa novo se perca:

- Clientes;
- Família;
- Pesquisa;
- Mundial;
- Aulas;
- Eventos;
- Testes.

Se você criou o mapa a partir de uma pasta em **Meu arquivo**, o editor pode sugerir essa pasta. Confira na etapa **Arquivo**.

Na etapa **Arquivo**, a pasta aparece antes da revisão final. Se o mapa é de estudo ou teste, salve em uma pasta própria para não misturar com clientes, família ou pesquisa principal.

## Aniversário

Em mapa de pessoa, **Lembrar aniversário** faz o mapa aparecer nos aniversários próximos do Início.

Desative quando:

- é mapa de teste;
- é mapa de evento;
- é organização;
- é pessoa que você não quer acompanhar nessa lista;
- é mapa duplicado usado só para estudo.

Se marcar falecido/finalizado, o mapa deixa de ser tratado como aniversariante ativo.

## Mapa importado

Na primeira etapa de **Novo mapa**, o botão **Importar dados** abre o importador sem salvar nada. Ele serve para trazer mapas de um arquivo ou texto exportado e depois revisar cada mapa dentro do mesmo editor.

O importador tem duas formas de entrada:

- **Colar dados**: use **Colar** para pegar o texto da área de transferência, ou cole manualmente em **Dados dos mapas**, e depois clique em **Importar**;
- **Arquivo**: solte ou selecione um arquivo `.al`, `.aaf` ou `.csv`.

O Astrologic aceita dados de outro Astrologic, Astro.com/AAF e Vega Plus Online. Depois da leitura, você escolhe quais mapas importados quer revisar.

Use **Voltar para edição** para sair do importador e retornar ao cadastro manual.

### O que acontece depois de importar

Quando o Astrologic encontra mapas válidos, ele cria uma fila temporária de importação e abre o primeiro mapa como **Novo mapa** já preenchido.

Se o arquivo tiver vários mapas, o importador mostra uma busca por nome e a quantidade de mapas prontos para importar. Selecione um mapa da lista para abrir esse registro no editor.

Nesse caso, a tela pode mostrar **Importando de** e o botão **Importar dados**. Use isso para escolher ou revisar mapas que estão na fila de importação.

Antes de salvar mapa importado, confira:

- nome;
- data;
- hora;
- local;
- UTC/local;
- longitude e latitude;
- fuso aplicado;
- fonte/qualidade da hora;
- pasta de destino.

Importação não é confirmação automática de qualidade. Ela só traz os dados para revisão.

Ao salvar um mapa importado, ele sai da fila. Se ainda houver mapas no arquivo importado, volte em **Importar dados**, pesquise o próximo nome e repita a revisão. Quando todos forem salvos, a fila é limpa.

Se quiser abandonar aquela fila e começar de novo, use **Nova importação** no importador. Isso volta para a tela de colar dados ou escolher arquivo.

### Quando a importação falha

Se aparecer **Nenhum mapa válido para importar**, normalmente o problema é um destes:

- o texto copiado não é uma exportação de mapa;
- o arquivo está em formato diferente de `.al`, `.aaf` ou `.csv`;
- o `.csv` não é do Vega Plus Online;
- o `.aaf` não contém dados reconhecíveis do Astro.com;
- o arquivo foi cortado, baixado incompleto ou colado pela metade;
- os mapas importados não têm data ou fuso suficientes para serem aceitos.

Quando isso acontecer, volte para a origem do arquivo, exporte novamente e tente importar sem editar o conteúdo no meio do caminho.

Se a importação trouxer vários mapas, revise um por vez. Salvar em lote sem conferir local, fuso e fonte costuma criar arquivo difícil de limpar depois.

## Revisão final

A etapa **Salvar** é uma conferência, não só um botão.

Ela resume:

- tipo do mapa;
- gênero, quando aplicável;
- idade ou estado de aniversário;
- qualidade da fonte;
- nome;
- pasta de destino;
- data e hora;
- local;
- longitude e latitude;
- fuso aplicado;
- problemas que impedem salvar.

Se algo estiver incompleto, a revisão mostra mensagens como:

- **O nome deve conter ao menos 3 caracteres.**
- **A data não foi informada.**
- **O local não foi informado.**

Quando aparecerem avisos, volte pela própria janela e corrija. Não tente resolver tudo na etapa final.

## Limite do plano

O número de mapas que você pode salvar depende do plano de acesso.

Em **Meu arquivo**, o rodapé mostra algo como **50 de 1200**. Se o limite estiver cheio, você precisa remover mapas, exportar e limpar o arquivo, ou ajustar o plano antes de criar/importar mais mapas.

Se o editor avisar **Limite atingido**, o problema não é o formulário. É espaço disponível no plano.

## Quando não salvar ainda

Não salve se:

- a data está incompleta e você sabe que pode confirmar logo;
- a hora foi colocada só para passar adiante;
- a cidade parece errada;
- longitude ou latitude foram copiadas sem direção;
- o fuso não foi conferido em mapa com hora;
- você está importando e não revisou os dados;
- o mapa ficou na pasta errada e você não quer perder o controle do arquivo.

Se precisa continuar depois, deixe a edição aberta ou volte ao rascunho enquanto ele existir. Mas não conte com o rascunho como backup permanente.

O botão **Cancelar** fecha o cadastro. Se houver rascunho temporário, ele pode ser descartado. Use cancelar quando tem certeza de que não quer continuar aquele mapa.

## Depois de salvar

Depois de salvo, o mapa aparece no arquivo e pode ser usado em:

- mapa completo;
- Feed;
- Lousa;
- Pesquisa;
- PDF e imagem;
- técnicas e slots;
- exportação;
- aniversários do Início, quando habilitado.

Se você salvou um mapa novo e não o encontrou, procure em **Meu arquivo > Todos** antes de filtrar por pasta.

## Se algo não bater

### O botão de salvar não libera

Alguma etapa ainda está inválida. Verifique as abas em vermelho. Os motivos mais comuns são nome curto, data vazia, local incompleto ou fuso pendente.

### A cidade não aparece

Use local manual ou escolha uma cidade próxima no atlas e ajuste. Para mapas importantes, confira coordenadas em uma fonte externa.

### Não tenho hora

Salve sem hora. Não use hora fictícia. Depois, se conseguir a fonte correta, edite o mapa.

### O mapa sumiu depois de salvar

Abra **Meu arquivo > Todos** e pesquise pelo nome. Se você salvou em uma pasta específica, talvez esteja olhando outra pasta.

### Criei duplicado

Abra **Meu arquivo**, pesquise pelo nome e compare data/local. Remova apenas o duplicado que você tem certeza que não precisa.

### Salvei com fuso errado

Abra o mapa, vá em **ações > Editar dados do mapa**, corrija local/fuso e salve novamente. Depois reabra técnicas que estavam usando o mapa antigo.