KML を TCX に変換

KML は Google Earth のための描画形式です。線や点、それに色やアイコンといった見た目の指定を持てます。ルートを表すこともできますが、それは KML にとって「たまたま描けるもの」の 1 つにすぎません。

TCX はスポーツ用の記録形式で、Garmin が定義しています。ワークアウトには必ず所要時間、距離、強度という数値が要求されます。KML にその発想はないので、この変換は単純な書き換えではなく、足りない部分を埋める作業になります。

TCX の仕様は 1 つのラップに合計時間・合計距離・強度の申告を求めます。KML のファイルにはこれらの数値がそもそも存在しないので、ここでは軌跡の座標から計算して埋めています。

距離は連続する 2 点間をハーバーサイン公式で求め、それを全部足し合わせたものです。地球の半径には 6,371,000 メートルを使っています。所要時間は、軌跡の最初の点と最後の点にタイムスタンプが両方ある場合だけ、その差から出しています。

Google My Maps で手描きしたルートのように、時間の情報を一切持たない KML は珍しくありません。この場合、所要時間はゼロとして書き出されます。距離は座標だけで計算できるので、そちらは正しく出ます。

時間の情報がもともと存在しないファイルから、この変換機が実際のペースを推測することはありません。所要時間が必要なワークアウトとして使うなら、時間付きのトラッキングデータを使う経路(GPX からの変換など)のほうが向いています。

TCX は Running や Biking のような決まった種目のリストからの申告を必要とします。KML にはそもそも種目という概念がないので、ここでは常に Other(その他)として書き出されます。

Garmin Connect などに取り込んだあと、種目を Running や Cycling に手動で直すことはできますが、それはインポートの後工程です。この変換自体が種目を判定することはありません。

KML は Placemark ごとに色、線の太さ、アイコン、説明文の HTML を持てます。これらは地図としての見た目を作るための情報で、TCX の側にそれを置く場所がありません。

同じ理由で、`ExtendedData` に入れたカスタム項目、地表に貼り付けたオーバーレイ画像、外部の KML を読み込むネットワークリンクも、すべてこの変換の対象外です。TCX が持って出られるのは座標と時刻だけです。

KML の中に線が複数あれば、それぞれが TCX の側で別々の Activity(アクティビティ)として書き出されます。1 つの地図に何本かのルートを描いていた場合、TCX を開くと複数のワークアウト記録として現れます。

点(ウェイポイント)しか含まない KML の場合は、その点の並びを 1 つのアクティビティとしてそのまま書き出します。ワークアウトの記録として空のファイルを作らないための処理です。

緯度と経度は小数点以下 6 桁まで書き出されます。これはおよそ 11 センチメートルの精度に相当し、徒歩や自転車のルートを表すには十分な細かさです。

標高やタイムスタンプは、KML に書かれていたとおりの値がそのまま渡されます。単位を変換したり、書式を作り直したりすることはありません。

この変換に専用のエンジンは要りません。KML も TCX も XML なので、サイトのほかのデータ変換とテキスト解析のしくみを共有しています。処理はすべてあなたのブラウザーの中で行われ、GPS の軌跡がどこかにアップロードされることはありません。

自宅の位置が特定できるようなルートを扱うことも多いだけに、この点は意味を持ちます。ファイルは変換のあいだも変換のあとも、あなたの機械から出ません。