Converter TCX para KMZ

Um TCX é inabrível para a maioria das pessoas. Tem uma extensão que ninguém reconhece, é XML em vez de algo que um duplo clique renderiza, e o software que lê corretamente é a plataforma de treino que quem recebe talvez não use. Mandar um para o secretário de um clube ou o organizador de uma prova gera uma resposta perguntando o que é isso.

Um KMZ produz um globo com uma linha. Essa diferença — entre um arquivo que precisa ser explicado e um arquivo que abre — é o motivo inteiro desta conversão, e vale deixar claro que é uma decisão de apresentação, não de dado. Nada no percurso melhora. O que muda é se a pessoa do outro lado consegue ver sem precisar de explicação.

Medido numa sessão de 7.200 pontos — duas horas a uma amostra por segundo, carregando tempo e altitude — o TCX ficou em cerca de 2,2 MB, o KML intermediário em cerca de 258 KB, e o KMZ pronto em cerca de 47 KB. São aproximadamente 315 bytes por ponto de trajeto reduzidos para menos de sete.

Dois efeitos sem relação entre si se empilham, e vale manter eles separados. A primeira queda, de quase nove para um, é o arquivo de treino virando um desenho: a marcação verbosa de `<Position>`, os horários e os elementos de sensor saem, e nada disso é recuperável. A segunda, cinco e meio para um, é a compressão deflate, e essa é totalmente reversível. Só a segunda é compressão, e chamar tudo de compressão sugeriria que o original ainda está lá dentro em algum lugar.

Renomear a saída para `.zip` e abrir revela um único membro chamado `doc.kml` na raiz do arquivo. Esse nome e essa posição são o que todo leitor de KML procura primeiro, então o arquivo abre sem lógica de reserva alguma.

Não há mais nada dentro — sem pasta de imagens, sem ícone, sem segundo documento, sem manifesto. A maioria dos KMZ em circulação carrega recursos junto do KML, que é para o que o formato foi desenhado; este faz o trabalho mais estreito de comprimir um único documento num único nome de arquivo. Isso também torna o arquivo trivialmente auditável: se você quer saber exatamente o que o seu técnico vai ver, extraia esse único arquivo e leia.

Tudo que uma plataforma de treino lê está ausente. Frequência cardíaca, cadência, potência, a distância corrida em cada ponto, calorias, as divisões de volta e cada média por volta são descartadas, porque um documento do Google Earth não tem elemento nenhum que guardasse qualquer uma delas. Então não há análise a fazer sobre o arquivo, só um percurso a olhar.

Os horários vão junto, e é essa a perda que pega as pessoas de surpresa. O controle de linha do tempo do Google Earth — que reproduz um trajeto — precisa de um gx:Track com valores `<when>` em paralelo, e esta conversão escreve um LineString simples. Se a pessoa para quem você está mandando de fato quer estudar a sessão, mande o próprio TCX, ou converta para GPX, que mantém o relógio e que a maioria do software de treino importa.

Um marcador por atividade, nomeado pelo esporte — `Corrida`, `Ciclismo` ou `Outro`, já que uma atividade de TCX não tem campo de nome, e o título da plataforma que você conhece mora num banco de dados, não na exportação. A linha segue o terreno em vez de cortar através dele, porque uma marcação de tesselação é ligada em cada LineString, e é desenhada com a aparência padrão do Google Earth já que nenhum estilo é escrito.

Não há alfinete nenhum. Um TCX não tem conceito de ponto de referência, então nada no arquivo vira um marcador, e quem recebe vê uma linha nua na barra lateral. Se um início, um pico ou um ponto de encontro precisa de destaque, o caminho prático é acrescentar os marcadores no Google Earth depois de abrir o arquivo e salvar de volta — o que leva um minuto e produz um documento de briefing melhor do que qualquer conversor conseguiria.

Ponto de trajeto sem `<Position>` é descartado, e o relógio grava esses pontos sempre que o receptor não tem céu: túnel, viaduto, estacionamento coberto de vários andares, cânion de rua profundo. No KMZ esses trechos ficam ausentes, então a linha corre reta do último ponto encontrado até o primeiro depois do intervalo, às vezes atravessando um rio ou uma encosta.

Parece um erro e não é — o arquivo nunca continha essas posições, e nenhuma conversão consegue restaurar elas. Vale uma frase no e-mail de acompanhamento se o percurso tiver um trecho óbvio assim, porque a alternativa é quem recebe concluir que o arquivo está quebrado. Uma sessão inteiramente interna não tem nenhum ponto e produz nenhuma geometria, e nesse caso a conversão diz que nenhum trajeto ou ponto foi encontrado, que é a descrição correta.

Mande o KMZ quando a pergunta é «para onde você foi» e quem recebe não é uma plataforma de treino. Mande o TCX quando a pergunta é sobre a sessão — ritmo, esforço, parciais — e quem recebe tem software que lê. Mande os dois quando estiver em dúvida, já que juntos ainda são menos de três megabytes, e a ambiguidade custa mais tempo do que os bytes custam.

A única combinação a evitar é mandar só o KMZ e tratar ele como um arquivamento da sessão. Não é um, e não dá para converter de volta: o dado de treino não existe no arquivo, e nenhuma ferramenta reconstrói ele. Guarde o TCX onde você guarda os seus registros, e pense no KMZ como você pensaria num PDF exportado de um documento.

Um KMZ não pode ser editado no lugar. Para renomear o marcador, colorir a linha ou aparar um ponto perdido, renomeie o arquivo para `.zip`, extraia o documento, edite o XML, e recompacte com esse documento na raiz do arquivo em vez de dentro de uma pasta. O detalhe da raiz é o que as pessoas mais erram, e o sintoma é um arquivo que abre num mapa vazio em alguns leitores e funciona bem em outros.

Se você espera mais de uma rodada de mudanças, mantenha um KML como cópia de trabalho e produza um KMZ toda vez que for mandar um. É a mesma disciplina de manter um documento de origem e exportar dele, e evita a situação em que a única cópia de um percurso corrigido está dentro de um arquivo que outra pessoa já tem.

Um TCX baixado como exportação em massa de uma plataforma de treino pode guardar várias atividades num documento só, e cada uma vira o próprio marcador no arquivo. Todas tiram o nome do esporte, então um mês de pedalada cai na barra lateral de quem recebe como uma coluna de itens todos dizendo `Ciclismo`, desenhados um em cima do outro no globo sem nada dizendo qual é terça e qual é domingo. Alternar um por um para achar o certo é o único jeito, e é uma coisa ruim de entregar a alguém.

Dividir antes de converter é a correção. As fronteiras de atividade são inconfundíveis no XML — cada elemento `<Activity>` abre com o próprio horário `<Id>` — então cortar o arquivo numa sessão por documento é mecânico, e converter separadamente dá um arquivo por pedalada com um nome que diz qual é qual. Onde elas realmente pertencem juntas, a alternativa é editar o `<name>` de cada marcador no KML antes de compactar, o que leva mais ou menos o mesmo tempo e produz uma barra lateral que alguém consegue de fato ler.

O TCX é analisado, o KML escrito e o arquivo compactado dentro desta aba do navegador. Nenhuma requisição carrega o arquivo para lugar nenhum, o que o painel de rede mostra durante uma conversão, e a página funciona com a conexão desligada depois de carregar.

A alternativa que a maioria das pessoas usa é um conversor na web ou um site de compressão de arquivo, o que significa que um documento com a sua frequência cardíaca e o seu endereço de casa passa pela máquina de um estranho só para um anexo de e-mail ficar menor. Você vai mandar o resultado a alguém de propósito; esse é um destinatário que você escolheu. Fazer a conversão localmente mantém esse número em um.