# Exportar e importar mapas

Use esta página quando os dados do mapa precisam entrar ou sair do app.

## Use esta ordem

1. Escolha se vai **compartilhar dados** ou **importar mapas**.
2. Se for enviar, use o formato certo (legível, Astrologic ou AAF) e revisa antes de copiar.
3. Se for importar, use **Novo mapa > Importar dados** e revise data/local/fuso.
4. Só finalize quando data, local e fuso estiverem confiáveis.

## Regra rápida

- usar formato Astrologic para troca entre apps do Ecossistema Astrologic;
- usar AAF/CSV quando o sistema de origem exige;
- importar em lote no **Meu arquivo** para `.al`;
- manter observação de fonte quando houver divergência de horário.

## Diagnóstico rápido

1. **Importou e faltou dado crítico**: confira o texto antes de salvar e faça edição imediata.
2. **Fuso não batendo**: valide se veio em UTC/local e se o mapa veio com local do atlas.
3. **A mensagem não exporta**: reduz para poucos mapas e teste um a um.

## Ir para

- [Importar novo mapa](ajuda/novo-mapa) - Use o fluxo de revisão por etapa para corrigir e salvar com segurança.
- [Editar campos técnicos](ajuda/editar-mapa) - Ajuste nome, data e local antes de salvar a importação.
- [Exportar em lote](ajuda/meu-arquivo) - Encontre e selecione a pasta para backup dos seus mapas.

Exportar e importar serve para três situações diferentes:

- compartilhar os dados de **um mapa** com outra pessoa;
- importar mapa vindo de outro Astrologic, Astro.com, Vega ou arquivo compatível;
- exportar ou importar vários registros do **Meu arquivo** em formato Astrologic `.al`.

![Exportar e importar dados do mapa](/img/expimp/imp.png)
_Exportar e importar serve para mover dados de mapas, não para gerar imagem ou PDF._

Antes de importar, lembre: o Astrologic sempre permite revisar o mapa antes de salvar. Confira nome, data, hora, local, fuso e fonte.

## Compartilhar dados de um mapa

![Compartilhar dados do mapa](/img/expimp/expact.png)
_Escolha a ação de exportação conforme o destino: backup, envio para outro usuário ou organização local._

Abra o mapa na versão completa e use **ações > Compartilhar dados do mapa**.

Essa tela mostra formatos diferentes do mesmo mapa. Em cada formato, você pode usar:

- **Copiar dados**: copia para a área de transferência;
- **Compartilhar**: usa o compartilhamento do sistema, quando o navegador permite;
- **Tornar anônimo**: remove o nome original e substitui por um nome anônimo antes de copiar ou compartilhar.

Use compartilhamento de dados quando quer enviar o mapa para outro usuário importar, não quando quer enviar a imagem do mapa. Para imagem ou PDF, veja [PDF e imagem](pdf-e-imagem).

## Formatos de compartilhamento

### Formato legível

É bom para mandar por mensagem, email ou atendimento. A pessoa consegue ler os dados principais sem importar.

Exemplo:

```text
Dados do mapa de André Boudineau
André Boudineau
Em 04/02/1891 às 07:00 AA
Villeneuve-Saint-Georges - França
2°27 Leste 48°44 Norte
Fuso aplicado 00:10 Leste
```

### Formato Astrologic

É o melhor formato para importar em outro Astrologic.

Exemplo:

```ini
;Dados do mapa de André Boudineau
[chart]
name = André Boudineau
type = 1
gender = m
date = 1891-02-04
time = 07:00
sourceid = 1
sourceab = AA
local = Villeneuve-Saint-Georges
country = França
cab = fr
geoid = 2968529
long = +2.27
lat = +48.44
tz = -00:10_0__1
tzorig = -01:00_WAT
finished = 1
```

### AAF

AAF é um formato de intercâmbio astrológico usado por alguns programas.

Exemplo:

```text
#: Created by Astrologic Go
#A93:André Boudineau,*,m,4.2.1891,07:00,Villeneuve-Saint-Georges,França
#B93:2411767.7847222,48n44,2e27,0e10,0
#ZNAM:,
```

Use AAF quando precisa trocar dados com programas que aceitam esse formato. Ele é útil, mas nem sempre carrega todos os detalhes internos do Astrologic.

## Tornar anônimo

Use **Tornar anônimo** quando quer compartilhar os dados técnicos sem expor o nome da pessoa.

O app troca o nome exibido por **Anônimo**, mas mantém os dados necessários para cálculo: data, hora, local, coordenadas, fuso e fonte.

Exemplo:

```text
Dados do mapa de Anônimo
Anônimo
Em 04/02/1891 às 07:00 AA
Villeneuve-Saint-Georges - França
2°27 Leste 48°44 Norte
Fuso aplicado 00:10 Leste
```

Se o mapa tiver notas, biografia ou informações sensíveis em outras áreas, revise antes de compartilhar por outros meios.

## Importar no Novo mapa

Para importar dados de um mapa ou de uma lista pequena, use o fluxo de **Novo mapa**.

1. Abra **Novo mapa**.
2. Clique em **Importar dados**.
3. Escolha **Colar dados** ou **Arquivo**.
4. Importe.
5. Revise os dados no editor.
6. Salve no seu arquivo.

![Importar dados do mapa](/img/expimp/imppaste.png)
_Na importação, revise a origem do arquivo antes de criar mapas no seu arquivo._

O importador aceita dados colados e arquivos compatíveis. O app identifica o formato quando possível.

Formatos usados nesse fluxo:

- dados Astrologic em texto;
- arquivo Astrologic `.al`;
- arquivo `.ini` no formato Astrologic;
- arquivo `.aaf`;
- CSV do Vega Plus Online.

## Importar um mapa

![Importar dados de um mapa](/img/expimp/impsing.png)
_Importação individual permite conferir um mapa antes de salvar definitivamente._

Quando você cola dados de um único mapa, o app abre o editor com esses dados preenchidos.

Antes de salvar, confira:

- nome;
- tipo de mapa;
- data;
- hora ou marcação de sem hora;
- local;
- país;
- longitude e latitude;
- fuso;
- fonte do horário.

Se o local não foi reconhecido pelo Atlas, ele pode entrar como local manual. Isso não impede salvar, mas vale revisar com cuidado.

## Importar vários mapas pelo Novo mapa

![Importar dados de vários mapas](/img/expimp/implist.png)
_Na importação em lista, revise quantidade e itens antes de confirmar em lote._

Quando o arquivo ou texto tem vários mapas, o Astrologic guarda uma lista temporária de mapas prontos para importar.

O processo é um por vez:

1. importe o arquivo ou cole os dados;
2. escolha um mapa da lista;
3. revise no editor;
4. salve;
5. volte em **Novo mapa > Importar dados** para escolher o próximo.

Depois que um mapa é salvo, ele sai da lista de importação. Importações não realizadas podem ser descartadas automaticamente depois de um tempo.

## Importar no Meu arquivo

O **Meu arquivo** também tem importação própria para registros em lote.

Use esse caminho quando você tem um arquivo Astrologic `.al` de backup ou recebido de outro usuário.

No Meu arquivo:

1. abra o painel lateral de pastas e ações;
2. escolha **Importar dados de mapas**;
3. solte ou selecione o arquivo `.al`;
4. escolha a pasta onde salvar;
5. selecione os mapas que quer importar;
6. clique em **Importar**.

![Selecione o arquivo e arraste para o local indicado](/img/db/dbimport1.png)
_O primeiro passo da importação identifica o arquivo e prepara a revisão dos mapas._

Na etapa de seleção, o app mostra os mapas encontrados no arquivo.

![Selecione onde salvar e quais mapas importar](/img/db/dbimport2.png)
_Revise os dados importados antes de concluir para evitar mapas duplicados ou incompletos._

Depois da importação, você pode abrir os mapas recém importados.

![Importar dados de mapas concluído](/img/db/dbimport3.png)
_Depois de importar, confira onde os mapas foram salvos e se precisam de pasta ou revisão._

Esse fluxo é melhor para backup e movimentação de vários mapas entre contas ou aparelhos.

## Exportar no Meu arquivo

No Meu arquivo, a exportação em lote usa o formato Astrologic `.al`.

Use para:

- backup;
- enviar mapas para outro usuário do Astrologic;
- migrar mapas;
- guardar uma cópia de uma pasta ou seleção.

O app informa que a exportação em lote processa até **100 mapas por vez**. Se precisar exportar mais, filtre ou divida em partes.

O arquivo `.al` é pensado para voltar para o Astrologic. Ele pode incluir mais dados do que o compartilhamento simples, como informações internas do registro, dependendo do contexto exportado.

## Importar do Astro.com

O Astro.com pode fornecer dados em AAF quando essa opção está disponível na sua conta.

Caminho geral:

1. entre na sua conta do Astro.com;
2. abra a área dos dados astrológicos salvos;
3. procure a opção de exportação AAF;
4. copie o texto exportado ou salve como arquivo `.aaf`;
5. no Astrologic, use **Novo mapa > Importar dados**.

O Astro.com muda telas e regras ao longo do tempo. Se a opção AAF não aparecer, confira a ajuda do próprio Astro.com ou exporte por outro caminho disponível.

## Importar do Vega Plus Online

O Vega Plus Online exporta dados de clientes em CSV.

Caminho geral:

1. no Vega, acesse a lista de dados de clientes;
2. exporte em formato de planilha/CSV;
3. salve o arquivo;
4. no Astrologic, use **Novo mapa > Importar dados > Arquivo**;
5. selecione o CSV;
6. importe, revise e salve cada mapa.

![Exportar e importar mapas](/img/aprenda/vegaexpo.png)
_Use exportação para levar dados de mapa para outro fluxo, mantendo imagem/PDF separados de dados editáveis._

Ao importar CSV, confira principalmente local, país, coordenadas e fuso. CSVs de sistemas diferentes podem trazer campos com convenções próprias.

## O que revisar depois de importar

Não salve no automático sem olhar.

Revise:

- **hora**: se está correta ou sem hora;
- **fuso**: se foi importado como fuso padrão, horário de verão, LMT ou UTC;
- **local**: se veio do Atlas ou manual;
- **coordenadas**: longitude e latitude;
- **país**: especialmente em arquivos estrangeiros;
- **tipo de mapa**: pessoa, evento, organização, país etc.;
- **fonte**: código de qualidade do horário;
- **nome**: se veio duplicado, invertido ou com caracteres estranhos.

- [Novo mapa](ajuda/novo-mapa) - Use quando a importação precisa passar pelo cadastro e revisão antes de salvar.
- [Editar mapa](ajuda/editar-mapa) - Corrija data, hora, local, fuso e dados importados depois do salvamento.

## Compartilhar, exportar ou PDF?

Use **Compartilhar dados do mapa** quando a outra pessoa precisa importar ou conferir os dados técnicos.

Use **Exportar `.al` no Meu arquivo** quando quer backup ou lote de mapas.

Use **PDF e imagem** quando quer enviar a visualização do mapa, não os dados para importação.

## Se algo não bater

### O arquivo não foi aceito

Confira a extensão e o formato. No Meu arquivo, a importação em lote é para `.al`. No Novo mapa, o importador aceita formatos como `.al`, `.ini`, `.aaf` e CSV do Vega.

### O importador não encontrou mapas

O arquivo pode estar vazio, corrompido, em formato diferente ou sem dados mínimos. Um mapa precisa ter nome, data, local, longitude e latitude para entrar corretamente.

### O mapa importado veio sem Atlas

Isso pode acontecer quando o arquivo traz coordenadas, mas não traz um identificador do Atlas Astrologic. O mapa ainda pode ser salvo como local manual. Revise coordenadas e fuso.

### O fuso parece estranho

Arquivos externos podem usar convenções diferentes. Confira a linha de fuso no editor e compare com o local/data. Em caso de dúvida, revise pelo Atlas.

### Vieram muitos mapas

No fluxo do Novo mapa, salve um por vez. No Meu arquivo, selecione só os que quer importar e escolha a pasta correta antes de confirmar.

### Quero apagar uma importação temporária

Comece uma nova importação ou deixe a lista expirar. Importações não finalizadas são temporárias.

### Quero enviar para alguém que não usa Astrologic

Envie o formato legível ou gere PDF/imagem. O formato Astrologic e `.al` fazem mais sentido para quem vai importar no Astrologic.