KMZファイルを開いてKML・画像を取り出す方法

地図表示と内容確認を最初に分ける

Googleの公式資料では、KMZは主となるKMLファイルと画像、音声、モデル等の補助ファイルをZIP形式で一つにまとめた書庫です。Google EarthはKML／KMZを地理データとして読み込みますが、Karuzipは座標を地図へ描画せず、書庫内の項目を一覧・抽出します。目的に合わない方法で開くと、『解凍できたのに地図が見えない』『KMLだけ取り出したら画像が消えた』という混乱が起きます。

KMLとKMZの違いはXML単体かZIPパッケージか

KMLは地点、線、面、スタイル、説明、リンク等をXMLで記述する形式です。KMZはそのKMLと関連ファイルをZIPでまとめます。Googleの推奨構成では主KMLを最上位に置き、通常はdoc.kmlとします。ただし主KMLの名前は固定ではなく、拡張子が.kmlで一つだけなら別名でも構いません。複数のKMLを入れると、どれが最初に読まれるか確定できません。

KMZをKMLへ『変換』したいという検索の多くは、主KMLを取り出すだけで足ります。ただしKMLが書庫内画像をfiles/icon.pngのように参照している場合、KMLだけを別の場所へ移すと画像が見つからなくなります。

KMZを開く前に確認する7項目

• 元KMZを上書きせず、確認が終わるまで残す
• 配布元、作成日、対象地域、座標系や利用条件を確認する
• ファイルサイズとSHA-256が提供されていれば照合する
• 拡張子が.kmzのままか、二重拡張子になっていないか確認する
• 個人宅、顧客拠点、調査地点等の機微な座標を含まないか確認する
• NetworkLink、画像URL、説明欄のリンク等、外部参照の有無を確認する
• 抽出先は空の専用フォルダーにし、元データと混在させない

KMZは位置情報を含み得ます。アプリがローカル処理でも、取り出したKMLや画像を別サービスへアップロードすれば送信は発生します。業務データは組織の取扱規則を確認し、オンライン変換へ安易に渡しません。

KaruzipでKMZを開きKMLを取り出す4ステップ

1. 1

   KMZを拡張子のまま開く

   .kmzを.zipへ変更せず、Karuzipの「中身を見る」から選びます。元ファイルは別名保存せず、そのまま残します。

2. 2

   主KMLと参照先を一覧する

   最上位のdoc.kmlまたは一つの.kmlを探し、files、images、models等のフォルダーと項目数、サイズを確認します。

3. 3

   書庫テスト後に必要項目を選ぶ

   書庫テストでZIP層を最後まで読めるか確認します。KMLだけ読むなら主KMLを、表示を再現するなら参照先も選びます。

4. 4

   空フォルダーへ解凍して照合する

   出力件数、階層、サイズを確認します。重要な標本はSHA-256を照合し、KML内の相対参照先が同じ階層にあるか確認します。

実測：自作KMZの主KMLと3つの補助ファイルを確認

第三者の地理データや外部URLを使わず、検証用のdoc.kmlを作成しました。地点一つ、短いライン一つ、相対参照のPNG一つを含みます。補助ファイルはKaruzipの既存アイコン、説明文、検証条件JSONだけで、実行コードや個人情報は含みません。これらをZIP形式でまとめ、拡張子.kmzの自作標本にしました。

PNGは既に圧縮されたデータなので、KMZ全体の12,632 bytesと展開後12,677 bytesはほぼ同じです。『KMZなら大幅に小さくなる』とは限らず、中身の種類で圧縮効果が変わります。

sample-data.json一件だけを取り出して照合する

一覧からfiles/sample-data.jsonだけを指定して解凍しました。出力先には同じ階層のJSONが一件だけ作られ、元データとSHA-256が一致しました。これはZIP内の一項目を同一内容で取り出せた証拠であり、KMLが地図アプリで正しく描画される証拠ではありません。

画像が赤い×になる時は相対パスと欠落を確認する

GoogleのKMZ資料では、KML内の画像やモデル等を相対パスで参照し、主KMLから見た階層を保つ方法が推奨されています。たとえばfiles/karuzip-icon.pngという参照があるなら、doc.kmlとfilesフォルダーの位置関係を変えません。KMLだけをデスクトップへ移したり、画像を別名にしたりすると、地図上で画像が空白や赤い×になることがあります。

KMLの相対URLは通常、主KMLがある場所を基準に解決されます。3DモデルのsourceHrefにはDAEファイル基準という例外があるため、モデル付きKMZは単純な一括置換を避けます。

KMZからKMLへの変換と拡張子変更を混同しない

Googleの公式手順では、KMZの外側がZIPであるため、ZIPとして作成した後に.kmzへ変更する方法も説明されています。ただし、既存KMZからKMLを得るために毎回.zipへ変更する必要はありません。KMZ対応の書庫機能なら拡張子のまま開けます。またKMLを別のGIS形式へ変える、座標系を変える、レイヤーを統合する作業は、主KMLの抽出とは別の変換です。

書庫テスト、KML妥当性、地図表示、安全性は別の確認

Karuzipの書庫テストは、KMZのZIPデータを最後まで読めるかを確認します。KMLが整形式のXMLか、OGC KMLとして妥当か、参照先が存在するか、Google Earth等がすべての要素を表示できるかまでは判定しません。KMLのdescriptionにはHTML、NetworkLinkには外部URLを含められるため、書庫が正常でも参照先と内容の確認は残ります。

個人情報や業務位置情報を含むKMZは、オンライン変換よりローカルで内容を確認します。外部URLへ接続する必要がある場合は、ドメイン、通信先、利用規約、データの機密性を別途判断します。

KMZを開けない・表示できない時の確認順

Karuzipで一覧できない

ダウンロード未完了、拡張子だけが.kmzの別形式、ZIP層の破損を疑います。元ファイルを残し、サイズとハッシュを確認して再取得します。パスワード付きZIPを.kmzへ変更した独自配布物は、一般的なKMZとして互換性を期待できません。

書庫テストは通るがGoogle Earthで開けない

主KMLがない、KMLが複数ある、XMLに無効な文字がある、名前空間や要素が対応外、座標やRegionの条件で見えない等を切り分けます。ZIPのCRC成功とKMLの解析成功は別です。

doc.kmlはあるが画像やモデルが欠ける

KML内のhref、ファイル名の大文字小文字、URLエンコード、フォルダー階層、外部URLを確認します。KMLだけを移動した場合は、元KMZから参照先も同じ相対位置へ取り出します。

大きなKMZが遅い

画像、3Dモデル、細かい地物が多いと、解凍だけでなく地図アプリの解析・描画にも時間がかかります。まず一覧で容量の大きい項目を確認し、空き容量を確保します。解凍速度と地図描画速度を同じ性能指標にしません。

KMZの開き方・KMLへの変換でよくある質問

あわせて確認したいガイド

Karuzipで確認した条件

根拠と更新方針

Windowsの操作、ZIP形式の仕様、Karuzipの機能を混同しないよう、判断ごとに根拠を分けています。

• KMZ Files | Google for Developers developers.google.com KMZがZIP形式で主KMLと補助ファイルをまとめること、主KML、推奨階層、相対参照、ZIP作成と抽出の扱い。
• KML Reference | Google for Developers developers.google.com KMLの要素、Link、Icon、NetworkLink、Model、相対URL、description内コンテンツ等の仕様。
• Models | Google for Developers developers.google.com KMZ内のdoc.kml、models、textures、相対参照とResourceMapの関係。
• Import data into Google Earth | Google for Developers developers.google.com Google EarthへKMLまたはKMZを読み込み、地図プロジェクトとして扱う操作。
• KML Standard | Open Geospatial Consortium www.ogc.org KMLがOGCの地理情報表示用標準であり、仕様文書が公開されていること。
• RFC 3986: Uniform Resource Identifier www.rfc-editor.org KMZ内の相対参照解決でGoogle公式資料が参照するURI解決の基礎。
• KMZファイルとは | Karuzip karuzip.com Karuzip v1.3.0でのKMZ一覧、書庫情報、書庫テスト、全体・選択解凍と、地図表示・KML編集非対応の範囲。