Tutorial - Marcos KM - KMZ Solutions

Resumo Rapido - Formato do Arquivo

IMPORTANTE: O arquivo KML deve ter EXATAMENTE 2 pastas com estes nomes (minusculas):

Pasta	Nome Exato	Conteudo
OBRIGATORIO	`marcos`	Marcos quilometricos (ex: "152", "KM 153") Ordem: Norte → Sul
OBRIGATORIO	`vertices`	Pontos a renomear (qualquer nome)

Coordenadas: Formato longitude,latitude (ambos negativos no Brasil)
Exemplo: -47.5066,-23.9617,0

1. Visao Geral

O sistema Marcos KM processa arquivos KML contendo marcos quilometricos e vertices, gerando automaticamente:

Renomeacao de vertices baseada na distancia do marco mais proximo (formato: KM+metros)
Rota-mestre conectando todos os pontos em sequencia
Placemarks intermediarios a cada intervalo configuravel (50m, 100m, 200m ou 500m)
Arquivo Excel com analise detalhada de distancias
Arquivo de log com estatisticas do processamento

2. Estrutura do Arquivo KML

O arquivo KML deve conter exatamente duas pastas (Folders):

Pasta "marcos" (obrigatoria)

Nome: Exatamente marcos (minusculas, case-sensitive)
Conteudo: Placemarks com marcos quilometricos da rodovia
Formato do nome: Aceita "152", "KM 152", "MARCO 152", "K152", etc.
IMPORTANTE: Ordem dos marcos deve seguir a sequencia real (Norte → Sul)

Pasta "vertices" (obrigatoria)

Nome: Exatamente vertices (minusculas, case-sensitive)
Conteudo: Placemarks com pontos a serem renomeados
Formato do nome: Qualquer texto (ex: "P001", "Ponto A")
Ordem: Nao importa para o processamento

Atencao: Os nomes das pastas devem ser exatamente "marcos" e "vertices" (minusculas). Qualquer variacao causara erro.

Exemplo de Estrutura

<kml xmlns="http://www.opengis.net/kml/2.2">
  <Document>
    <Folder>
      <name>marcos</name>
      <Placemark>
        <name>152</name>
        <Point>
          <coordinates>-47.5066,-23.9617,0</coordinates>
        </Point>
      </Placemark>
    </Folder>

    <Folder>
      <name>vertices</name>
      <Placemark>
        <name>P001</name>
        <Point>
          <coordinates>-47.5100,-23.9700,0</coordinates>
        </Point>
      </Placemark>
    </Folder>
  </Document>
</kml>

Dica: As coordenadas devem estar no formato longitude,latitude (nesta ordem). Para o Brasil, ambos os valores sao negativos.

3. Selecionando o Intervalo

O intervalo define a distancia entre os placemarks intermediarios gerados ao longo da rota-mestre:

Intervalo	Descricao	Quando Usar
50 metros	Alta densidade de marcadores	Trechos curtos, alta precisao necessaria
100 metros	Densidade padrao (recomendado)	Uso geral, balanceado
200 metros	Densidade media	Trechos longos, arquivos menores
500 metros	Baixa densidade	Visualizacao geral, arquivos muito menores

Recomendacao: Use 100m para a maioria dos casos. Intervalos menores geram arquivos maiores mas com mais detalhes.

4. Passo a Passo

Prepare seu arquivo KML
- Abra o Google Earth Pro
- Crie uma pasta chamada "marcos"
- Adicione marcos em ordem Norte → Sul
- Crie uma pasta chamada "vertices"
- Adicione os pontos a renomear
- Salve como arquivo .kml
Faca upload no sistema
- Acesse a pagina "Marcos KM"
- Arraste o arquivo ou clique para selecionar
Selecione o intervalo
- Escolha entre 50m, 100m, 200m ou 500m
- Padrao: 100m (recomendado)
Processe o arquivo
- Clique em "Processar Arquivo"
- Aguarde o processamento (30-60s tipico)
- Acompanhe as estatisticas em tempo real
Baixe os resultados
- KML: Arquivo completo com todos os dados processados
- Excel: Planilha com analise detalhada
- Log: Arquivo de log com estatisticas

5. Entendendo os Arquivos de Saida

Arquivo KML de Saida

O KML gerado contem 6 pastas organizadas:

Marcos: Placemarks originais dos marcos quilometricos
Original Vertices: Vertices com nomes originais (para referencia)
Renamed Vertices: Vertices renomeados no formato KM+metros
Routes: Rotas de cada marco ate cada vertice
Rota-Mestre: Linha amarela conectando todos os pontos em sequencia
Intermediarios: Placemarks a cada X metros (icone quadrado)

Nota: A rota-mestre usa a API do Google Maps para gerar rotas reais. Se a API falhar, linhas retas sao usadas como fallback.

Arquivo Excel

Contem as seguintes colunas:

vertex_index: Numero sequencial do vertice
vertex_original_name: Nome original do vertice
vertex_lat / vertex_lon: Coordenadas do vertice
marco_selected: Marco utilizado para renomeacao
marco_km: Numero do KM do marco
distance_m: Distancia em metros do marco ao vertice
new_name: Nome novo no formato KM+metros
selection_reason: Motivo da selecao do marco

Arquivo de Log

Contem informacoes detalhadas sobre:

Marcos e vertices carregados
Processamento de cada vertice
Rotas obtidas da API
Construcao da rota-mestre
Geracao de placemarks intermediarios
Estatisticas finais e tempo de processamento

6. Problemas Comuns

Erro	Causa	Solucao
"Folder 'marcos' not found"	Nome da pasta incorreto	Use exatamente "marcos" (minusculas)
"Folder 'vertices' not found"	Nome da pasta incorreto	Use exatamente "vertices" (minusculas)
"No marcos with valid KM numbers"	Nomes dos marcos invalidos	Use formatos: "152", "KM 152", etc.
Todos vertices pulados	Coordenadas invalidas	Verifique formato: longitude,latitude
Muitas rotas fallback	API indisponivel ou sem internet	Verifique conexao, linhas retas sao usadas

7. Dicas e Melhores Praticas

Sempre valide as coordenadas antes de processar
Mantenha a ordem correta dos marcos (Norte → Sul)
Comece com intervalo de 100m e ajuste conforme necessario
Use nomes simples para marcos (apenas numeros)
Mantenha backup do KML original
Revise o arquivo de log apos o processamento
Teste com um arquivo pequeno primeiro (5-10 marcos/vertices)
Verifique se todas as coordenadas estao dentro do Brasil

Dica Pro: O sistema arredonda automaticamente as distancias para multiplos de 5 metros nos placemarks intermediarios (ex: 152+652 vira 152+650).

8. Suporte

Se tiver duvidas ou encontrar problemas:

Consulte o Tutorial do Gerador de KML para informacoes sobre coordenadas
Verifique os arquivos de exemplo no Google Earth
Revise o arquivo de log gerado para detalhes de erros

Lembre-se: O processamento usa a API do Google Maps e pode levar 30-60 segundos dependendo da quantidade de pontos.