KMZ を CSV に変換

KMZ ファイルを開こうとしている人が、それを最初に作った人であることはめったにありません。測量会社、水道やガスなどの事業者、自治体の都市計画課、観光局、施工業者からの添付ファイルとして届き、その組織が標準にしているツールで作られ、受け取る側にも Google Earth があることを前提にしています。作業指示書を作ったり件数を確認したりしたいだけなのに、40 個の座標を読むために地球儀ビューアーをインストールするのは割の悪い取引です。

この変換はまさにその状況のためにあります。アーカイブを開き、中の文書を読み、位置と名前を行として渡します。フォームに座標を貼り付けたり、資産台帳と突き合わせたり、メールに書かれていた 18 か所が本当にファイルに含まれているか確認したりするには十分です。地図そのものは手に入りません。地図こそが納品物なら、Google Earth が本当に正しい道具です。

KMZ 独自のデータモデルというものは存在しません。この形式は、主要なメンバーが KML 文書である ZIP アーカイブであり、KMZ が表現できるものはすべてその KML によって表現されています。アーカイブが存在するのは、地図がそれが参照する画像——カスタムのピンアイコン、写真オーバーレイ、地形にジオリファレンスされたスキャン図面など——と一緒に、1 ファイルが置き去りにされると壊れるフォルダーとしてではなく、1 つのファイルとして移動できるようにするためです。

読み込み処理は、Google Earth が書き込む名前である doc.kml を探し、それがなければ .kml で終わる最初のメンバーにフォールバックします。このフォールバックは念のための保険ではありません。仕様が求めているのはアーカイブの主要な文書が KML であることだけで、特定の名前ではありません。他のツールで書き出されたファイルは Sites_Phase2.kml のような名前を持ちます。.kml で終わるメンバーがまったくない場合、この変換は空の表を作るのではなく、そう明示するメッセージで停止します。

4 MB の KMZ が、4 MB 分の座標であることはほとんどありません。かさばっているのはたいてい files/ や images/ フォルダーで、アイコンの PNG、JPEG のオーバーレイ、ときには数千ピクセルにも及ぶスキャンされた敷地図が入っています。それらは CSV には何も表現されませんが、見落としで黙って落とされているわけではありません。表にはラスター画像を置く場所がなく、もう持っていないファイルを指すファイル名の列は、積極的に誤解を招くだけだからです。

実務上の帰結として、実質的な中身が画像である KMZ は、ほぼ空の CSV に変換されます。2 つの角にマーカーを持つジオリファレンス済みの図面は、2 行だけを返し、図面そのものは何も返しません。そうなった場合、そのアーカイブはデータセットというより文書であり、別の変換ツールを探すのではなく、手作業で展開して画像を見るのが答えです。

すべての行は type、name、latitude、longitude、elevation、time を持ちます。type は単独で落とされた点と、描かれた線の頂点を区別し、まず絞り込むべき項目です。資産の位置を示す KMZ ならすべてが waypoint 行になるはずで、track 行の大きな塊があるなら、そのファイルはルートや境界も含んでいるということです。

name はプレイスマークが持っていたラベルで、線のすべての頂点に繰り返されるので、大きなファイルから 1 つの地物だけを絞り込むのに結合操作が要りません。latitude と longitude は 10 進の度数で、地図検索ボックスや配車システム、ジオコーディング API がどれもそのまま受け付ける形式です。elevation と time はしばしば空です。描かれた地図はどちらも記録しないからで、元データが持っていなかった値には空欄が正しい出力です。

拡張子を .zip に変えてダブルクリックするのは中身を見る正当な方法で、コストがかからずファイルの正体を確認できるので知っておく価値があります。どのデスクトップ OS でも開け、一緒に運ばれてきた画像とともに KML が見えます。

そのあとに手に入るのは XML です。座標は「経度, 緯度, 高度」の 3 つ組が 1 つの要素の中でひとまとまりに書かれ、経度が先で、プレイスマークとフォルダーの構造に包まれています。特定の数値を探している人にとっては読めますが、データセットとしては使えません。この変換はその先の半分——フォルダーツリーの走査、座標の分割、緯度を先にする入れ替え——を行います。ここが手作業だと面倒で間違えやすい部分です。

圧縮のせいで、ディスク上のファイルサイズは中にどれだけあるかの目安になりません。KML は繰り返しの多いテキストで、異常によく圧縮されます。ここで測定したおよそ 258 KB の KML は、アーカイブの中でおよそ 47 KB に圧縮されました。5.5 倍です。3 MB の KMZ は、およそ 15 MB 分の KML と、数十万件の座標を持っていることがあります。

無料枠の 100 MB という上限は、そのままの KMZ に適用されるので、実際に先に突き当たるのは数字ではなくブラウザーのタブのメモリーです。大きなアーカイブで止まってしまうなら、.zip にリネームして KML メンバーの展開後のサイズを見ることが有効な診断になります。解析され保持されなければならないのは、アーカイブのサイズではなくその数字です。

何もないように見える結果を生む失敗は 2 種類あり、それぞれ違うものです。アーカイブに KML メンバーがない場合、この変換ははっきりそう伝えます。原因はほぼ常に、書き出されたのではなくリネームされたファイルです。KML はあるのにジオメトリが得られない場合、メッセージは「トラックもウェイポイントも見つかりませんでした」で、これは別の問題であり、直し方も違います。

後者のよくある原因は、ファイルがポリゴンだけで構成されていることです。区画境界、洪水危険区域、カバレッジ範囲といった面は、輪郭を <Polygon> 要素の中に保持しており、この読み込み処理はそこへ降りていきません。影付きの領域だけの KMZ は行を 1 つも生みません。URL からコンテンツを取得するネットワークリンクは、アーカイブが本当にデータを持っていないという、もっと根本的な理由で空になります。

各プレイスマークの名前は引き継がれます。プロ用の書き出しが運ぶ他のほとんどのものはそうではなく、この種のファイルではそれがいちばん問題になりやすい欠落です。資産番号、配管の口径、点検日、区画の参照番号、測量士のメモは、たいてい <description> の吹き出しか <ExtendedData> ブロックの中にあり、どちらも読まれません。Google Earth では情報が詰まっているように見えた KMZ が、実質的な中身のない、名前と数字だけの表に変換されることがあります。

取り戻す方法は 2 つあります。アーカイブを .zip にリネームして KML を取り出して読む方法です。拡張フィールドは冗長ですが完全に読め、<SimpleData name="asset_id"> のような要素が何であるかを教えてくれます。あるいは、送り主に KMZ の元になった表を求めてください。ほぼ常に存在します。独自のスキーマを持つファイルは、誰かが地球儀の上に描いたのではなく、データベースから出てきたものだからです。

緯度と経度は小数点以下 6 桁の 10 進の度数で書かれ、これはおよそ 11 センチメートルの精度です。元データが正当化するよりはるかに細かく、ファイルを読みやすく保つには十分に粗い値です。この形式は、どんな地図サイトの検索ボックスにも、配車や配送システムにも、ジオコーディング API にも、変換なしにそのまま入り、たいていそれこそが人々が表を求めた直接の理由です。

注意すべきなのは、行き先が期待する順序です。48.137154, 11.576124 と書けば、地図検索は緯度を先に読み、意図した場所に着地します。GeoJSON や GIS ライブラリを土台にしたシステムはしばしば経度を先に求め、この組を入れ替えると、ミュンヘンの点がソマリア沖の海へ移動してしまいます。1 回目で気づくほど大きな誤りですが、400 行のうち 1 行だけに起きると見落としやすいものです。

アーカイブはこのブラウザーのタブの中で展開、解析、書き直しが行われます。何も送信されず、変換中にネットワークパネルで確認でき、接続を切っても動作し続けます。作成すべきアカウントも、あとに残る待ち行列のファイルもありません。

このペアにとって、この主張は個人的な話であると同時に契約上の話でもあります。クライアントや事業者、公的機関からの KMZ は、どこに保管してよいかについての条件付きで届くことが多く、それを無料の Web 変換ツールに貼り付けることは、まさにそうした条件が防ごうとしている種類の転送です。ローカルで変換すれば、名指すべき第三者もなく、探し回るべき処理契約もありません。