Como Usar - Gerador de KML

1. Visão Geral

O Gerador de KML converte planilhas Excel de obras rodoviárias em arquivos KML para visualização no Google Earth. O sistema oferece dois modos de processamento:

Simples: Cria apenas alfinetes no mapa
Com Rotas: Cria alfinetes e rotas entre pontos usando a API do Google Maps

2. Preparando a Planilha Excel

Colunas da Planilha

Coluna	Status	Descrição	Exemplo
`tipo`	Obrigatório	Tipo da obra	Duplicação, Interseções
`ano`	Obrigatório	Ano da obra	2024, 2025
`kmi`	Obrigatório	Quilômetro inicial	120.5, 45
`lati`	Obrigatório	Latitude inicial	-23.550520
`longi`	Obrigatório	Longitude inicial	-46.633308
`kmf`	Opcional	Quilômetro final	125.8
`latf`	Opcional	Latitude final	-23.560000
`longf`	Opcional	Longitude final	-46.640000
`sentido`	Opcional	Sentido da obra	Norte, Sul

Importante: Para criar rotas, as colunas kmf, latf e longf são necessárias.

3. Formatos de Coordenadas

O sistema aceita três formatos de coordenadas:

Formato Decimal (Recomendado)

Latitude:  -23.550520
Longitude: -46.633308
        

Use ponto (.) ou vírgula (,) como separador decimal. Latitudes sul e longitudes oeste devem ser negativas.

Formato DMS (Graus, Minutos, Segundos)

Latitude:  23°33'1.87"S  ou  23 33 1.87 S
Longitude: 46°37'59.91"W ou  46 37 59.91 W
        

Formato DMS sem Direção

33 1.87
37 59.91
        

Se não houver direção (S/N/W/E), o sistema assume coordenadas brasileiras (negativas).

Validação Automática: O sistema verifica se as coordenadas estão dentro do território brasileiro (Lat: -35 a 5, Lon: -75 a -30).

4. Passo a Passo para Usar

Prepare sua planilha Excel
- Formate a planilha base com os dados corretos
- Certifique-se de que todas as colunas obrigatórias estão presentes
- Verifique se as coordenadas estão em um formato válido
- Salve como .xlsx
Acesse o sistema
- Abra o navegador e vá para a página inicial
- Clique na área de upload ou arraste o arquivo
Escolha o tipo de processamento
- Simples: Se você quer apenas alfinetes
- Com Rotas: Se você tem coordenadas inicial e final e quer rotas
Clique em "Processar Arquivo"
- Aguarde o processamento concluir
- Verifique as estatísticas exibidas
Faça o download
- Download KML: Arquivo para abrir no Google Earth
- Download Log (.txt): Detalhes do processamento para debug

5. Entendendo o Log de Processamento

O arquivo de log (.txt) contém informações detalhadas sobre o processamento:

Informações no Log:

Data e hora do processamento
Nome do arquivo processado
Total de registros encontrados
Colunas identificadas na planilha
Detalhes de cada item processado
Itens ignorados (com motivo)
Rotas criadas (se aplicável)
Resumo final com estatísticas

Dica: Use o log para identificar problemas com coordenadas ou dados ausentes na sua planilha.

6. Problemas Comuns

Todos os itens foram ignorados

Verifique se as colunas estão com os nomes corretos
Certifique-se de que as coordenadas estão preenchidas
Confirme que está usando a primeira sheet da planilha

Coordenadas inválidas

Verifique se as coordenadas estão dentro do Brasil
Confirme o formato (decimal ou DMS)
Use ponto (.) no lugar de vírgula (,) para decimais no Excel

Rotas não foram criadas

Certifique-se de escolher o modo "Com Rotas"
Verifique se latf e longf estão preenchidos
Confirme que kmi é diferente de kmf

Erro ao processar

Verifique se o arquivo é realmente Excel (.xlsx ou .xls)
Certifique-se de que a planilha não está corrompida
Consulte o log para detalhes do erro

7. Dicas e Melhores Práticas

Use sempre o formato decimal para coordenadas quando possível
Mantenha uma planilha modelo com as colunas corretas
Valide suas coordenadas no Google Maps antes de enviar
Organize seus dados por ano e tipo para facilitar visualização
Sempre faça download do log para verificar o processamento
Teste com uma planilha pequena antes de processar dados grandes
Mantenha backup das suas planilhas originais

8. Suporte e Contato

Para dúvidas ou problemas:

Consulte o arquivo de log para detalhes do erro
Entre em contato com o Lucas Diego para reportar o erro!

Como Usar o Gerador de KML