QGISからKML出力すると名前・属性が表示されないときの対処法【具体例付き】
QGIS・Google Earth 実務メモ|2026年10月18日更新
QGISでは「堰堤01」「写真P-01」と表示されていたのに、KMLに書き出してGoogle Earthで開くと、ピンだけが並んで地点名が分からない。あるいは、地点をクリックしても、施設名や点検メモが思ったように表示されない——現地調査の資料を共有するときに困りやすい問題です。
まずは、地図上の地点名、クリック時の説明、文字やアイコンの見た目を分けて確認します。QGISでラベルを設定していても、その設定がKMLへ同じ形で引き継がれるとは限りません。この記事では、砂防施設・写真撮影地点を例に、確認する順番を整理します。
1.「名前が出ない」と「属性が出ない」は別の問題
| 困っていること | 主に確認するもの | 確認の例 |
|---|---|---|
| ピンの横に地点名が出ない | KMLの地点名(name)とラベル設定 | 「堰堤01」という名前が入っているか |
| クリックしても点検メモが出ない | 説明(description)や追加属性(ExtendedData) | 調査日・点検メモを出力対象に含めたか |
| 名前はあるが小さくて読めない | ラベルの大きさ・色・表示条件 | 名前の重なり、表示倍率、既存スタイルを確認 |
名前や属性そのものが出力されていない場合、文字の大きさを変えるだけでは直りません。逆に、データが残っているのに表示しづらいだけなら、名前の作り直しよりもスタイルの確認が先です。
2.具体例:砂防施設の位置を共有する場合
たとえば、QGISで次のような施設ポイントを整理しているとします。以下は説明用の架空データです。
| 施設番号 | 施設名 | 調査日 | 点検メモ |
|---|---|---|---|
| S-001 | 上流第1堰堤 | 2026/10/01 | 流木の堆積を確認 |
| S-002 | 上流第2堰堤 | 2026/10/01 | 右岸側を次回再確認 |
| S-003 | 下流床固工 | 2026/10/02 | 写真P-12と照合 |
この場合、地図上に表示する名前は「S-001 上流第1堰堤」程度にして、調査日と点検メモはクリック時の説明へ回すと使いやすくなります。すべての属性をピンの横に並べると、近接する施設同士で文字が重なり、かえって探しづらくなります。
打合せでは「S-002を見てください」と番号で指定でき、地点をクリックして「右岸側を次回再確認」というメモを読む、という使い方ができます。施設番号を写真台帳や点検表とそろえておくと、Google Earthと報告資料を行き来するときも迷いません。
3.まずQGIS側で、表示用の名前を準備する
- 属性テーブルを開く。名前に使う施設番号・施設名が、空欄になっていないか確認します。QGISの画面上でラベルが見えることと、書き出す属性に名前が入っていることは別です。
- 必要なら表示用の文字列フィールドを追加する。元の「施設名」を直接変更するより、「表示名」などを別に用意すると整理しやすくなります。最初は2~3地点を手入力し、狙った表示になるか試す方法でも十分です。
- レイヤを右クリックし、エクスポートから地物の保存を開く。形式をKMLにし、名前と説明に使いたいフィールドを出力対象に含めます。試験用には、選択した少数の地点だけを書き出すと原因を切り分けやすくなります。
- 名前用・説明用フィールドの割り当てを確認する。書き出し画面に対応するオプションがある場合は、名前用に「表示名」、説明用に点検メモ等を指定します。表示項目はQGISのバージョンや使用ドライバで異なります。
フィールド名を一律にNameへ変更すれば必ず解決する、というわけではありません。GDALのKMLドライバでは、名前用フィールドを指定するNameFieldの既定値はNameです。一方、LIBKMLドライバは異なる設定方式を持ちます。元のフィールドを変更する前に、書き出し時の対応関係を確認しましょう。GDAL KMLドライバの説明/LIBKMLドライバの説明
4.Google Earthで「名前」と「説明」を確認する
書き出したKMLを開いたら、まず左側の地点一覧で名前を確認します。次に、地図上のピンをクリックし、施設名・調査日・点検メモが想定どおりに読めるかを確認します。ここではGoogle Earth Proのデスクトップ版を想定しています。
- 地点一覧にも名前がない:名前の出力先や元の属性値を再確認します。
- 一覧には名前があるが地図上で読めない:地点の表示チェック、ラベルの大きさ・色、拡大率を確認します。
- 名前は見えるがメモがない:説明用フィールドや追加属性が出力されているか確認します。ラベルスタイルの追加だけではメモは補えません。
GoogleのKML仕様では、ラベルは地点名をもとに描画され、LabelStyleで色や大きさを指定します。ただし、スタイルを追加しても、どの表示倍率・どの状態でも全ラベルが必ず表示されることを保証するものではありません。Google KMLリファレンス:LabelStyle
5.具体例:現地写真が50地点ある場合
写真撮影地点を50点まとめて共有する場合は、地図上の名前を「P-01」「P-02」「P-03」のような短い写真番号にすると見通しがよくなります。クリック時の説明には「上流側から堰堤を撮影」「右岸側の流木を撮影」などを整理します。
まず、離れた地点・近接する地点・日本語の説明がある地点の3点程度で試します。写真番号、位置、説明がそろっていることを確認した後で、残りを書き出します。最初から全50点を処理するより、名前の割り当てミスに早く気づけます。
写真そのものをKMZに含めている場合は別途注意が必要です。KMZはKMLや画像などをまとめたファイルです。ラベルが直っても、再保存時に画像が抜ければ写真資料として使えません。写真の表示まで確認してから共有してください。
6.Pythonでまとめて補助処理する場合
多数のファイルで同じ確認を繰り返す場合に備え、旧記事に掲載していたPythonスクリプトをGoogleドライブへ移しました。今回の配布ファイルは旧掲載コードをそのまま別ファイル化したものです。今回、PythonおよびGoogle Earthでの実行検証は行っていません。
このスクリプトは、地点名がすでに入っているデータに対して、未設定の場合にラベル用のスタイル参照を追加する補助処理です。対象フォルダ直下のKML/KMZを処理し、同じフォルダ内の_styledフォルダへ保存する構成です。
地点名の自動生成や、消えてしまった属性の復元は行いません。また、既存のスタイル参照がある地点には変更が加わりません。追加するスタイルの認識も含めて、少数のデータで確認してから使用してください。
まずは単純なポイントKMLで試してください。旧コードはKMZ内の画像サブフォルダを再帰的に再梱包しないため、写真付きKMZでは画像が欠落する可能性があります。複数KMLや画像を含む複雑なKMZには、そのまま使用しないでください。詳しい制約と実行手順は別紙にまとめています。
7.ダウンロード
8.処理後は、この5点を確認する
- 地点名:施設番号や写真番号が想定どおりに表示されているか。
- 位置と件数:地点のずれや欠落がないか。
- クリック時の情報:調査日・点検メモなどが読めるか。
- 付属データ:写真やリンクが処理前と同じように開けるか。
- 表示の見比べ:元ファイルと処理後ファイルを同時表示せず、片方ずつ確認したか。
元データは別の場所に保存し、コピーを使って試してください。特に「名前は入っているか」「説明は残っているか」「見た目の問題か」を分けると、QGIS側で直すべきか、Google Earth側で調整すべきかを判断しやすくなります。
地図太郎というGISアプリなら可能。ただし、一括処理はできない。
返信削除