ShapefileからGeoPackageへ乗り換える理由と一括変換【文字化け・CRSの注意とPyQGISスクリプト】
Shapefileは今も多くの現場で使われていますが、形式の古さからくる制約があります。 QGISで新しくデータを作る・まとめて管理するなら、OGC(地理空間の国際標準化団体)の標準形式であるGeoPackageに移すと、扱いがかなり楽になります。
この記事では、自治体や測量会社のように古いShapefileを大量に抱えている組織を想定して、乗り換える理由と、変換で失敗しやすい点(文字化け・座標参照系の抜け・属性名の切れ)、フォルダ内のShapefileを1つのGeoPackageにまとめるPyQGISスクリプトを紹介します。形式そのものの比較はGISデータ形式の違いで扱っています。
要点
- Shapefileは、属性名が10文字まで、属性の型は整数・実数・文字列・日付のみ(日時は持てない)、.shpと.dbfは2GBを超えないことが推奨、という制約があります(GDALの説明)。
- 1つのデータが.shp・.shx・.dbf(必須)と.prj・.cpgなどに分かれるため、受け渡しで.prjが欠けると座標参照系(CRS)が分からなくなり、.cpgが欠けると文字コードが分からなくなります。
- GeoPackageはSQLiteのデータベース1ファイルで、複数のレイヤをまとめて持てます。新しく作るときは文字コードがUTF-8になり、空間インデックスも既定で作られます(GDALの説明)。
- 日本語のShapefileで.cpgが無いものは、文字コード(多くはShift_JIS=CP932)を指定して読み込んでから変換します。
- フォルダ内のShapefileをまとめて変換するスクリプトを下に載せています(QGIS 3.44・4.2で動作確認)。
1. Shapefileの制約
GDAL(QGISがデータの読み書きに使うライブラリ)の説明から、実務で困りやすいものを挙げます。
| 制約 | 内容 |
|---|---|
| 属性名 | 10文字まで。長い名前は切られ、重なると番号が付く |
| 属性の型 | 整数・64ビット整数・実数・文字列・日付のみ。日時(時刻つき)は持てない |
| サイズ | .shp・.dbfとも2GBを超えるのは推奨されない |
| ファイル | .shp・.shx・.dbfの3つが1組。座標参照系は.prj、文字コードは.cpgに入る |
| 文字コード | .cpgか、.dbfの中の文字コードの印(LDID)で判断する |
日本語のShapefileで起きやすい文字化け
GDALは文字コードを.cpgか.dbfの印で判断するため、どちらも無いShift_JISのShapefileは、文字コードを指定しないと属性の日本語が化けます。古いソフトで作られたデータや、.cpgを付けずに受け渡されたデータで起きやすい問題です(経験則(要検証))。
QGISの画面で1つずつ直すなら、レイヤのプロパティの「ソース」で、データソースのエンコーディング(英語版では Data source encoding)をShift_JIS(CP932)にしてから書き出します。メニューや項目の名前は、版や表示言語によって少し違うことがあります。
2. GeoPackageにすると何が変わるか
| 項目 | Shapefile | GeoPackage |
|---|---|---|
| ファイルの数 | 1データで3つ以上 | 1つ(複数レイヤもまとめて入る) |
| 属性名 | 10文字まで | DBFの10文字の制限は無い |
| 日時の型 | 持てない(日付のみ) | 持てる |
| 文字コード | .cpgか.dbfの印で判断 | 新しく作るときはUTF-8 |
| 空間インデックス | 別ファイル(.qixなど) | 既定で作られる |
| 規格 | Esriが公開した仕様 | OGCの標準(最新は1.4.0) |
GeoPackageはSQLiteのデータベースを入れ物にした形式で、ベクタの地物のほか、ラスタのタイルや表データも持てます。QGISでは、レイヤのスタイルやメタデータをGeoPackageの中に一緒に保存することもできます(後述の「Package layers」)。
表示が重いデータの扱いはQGISで大量データを扱う方法にまとめています。
乗り換えるときに確かめること
□ データを渡す相手(委託先・他部署・使っているソフト)が
GeoPackageを読めるか
□ 納品の仕様でShapefileが指定されていないか
(指定されていれば、納品はShapefileのままにする)
□ 元のShapefileの文字コードと座標参照系が分かっているか
□ 10文字で切られた属性名を、元の名前に戻す必要があるか
(いずれも組織での運用上の確認で、経験則(要検証)です)
3. QGISの画面で変換する
1つずつ変換する
レイヤを右クリック
→ エクスポート
→ 新規ファイルに地物を保存
→ 形式:GeoPackage
→ ファイル名とレイヤ名を指定
複数のレイヤを1つのGeoPackageにまとめる
プロセシングのアルゴリズム「Package layers」(ID:native:package)を使うと、プロジェクトに読み込んだ複数のレイヤを1つのGeoPackageに書き出せます。主な設定は次のとおりです。
| 設定(引数名) | 内容 |
|---|---|
| 入力レイヤ(LAYERS) | まとめるレイヤ |
| 出力先(OUTPUT) | 書き出すGeoPackage |
| 既存のGeoPackageを上書き(OVERWRITE) | 同じファイルがあるとき |
| スタイルを保存(SAVE_STYLES) | レイヤのスタイルもGeoPackageに入れる |
| メタデータを保存(SAVE_METADATA) | レイヤのメタデータも入れる |
| 選択した地物だけ(SELECTED_FEATURES_ONLY) | 選択中の地物だけを書き出す |
(QGIS 4.2では、範囲(EXTENT)と出力のCRS(CRS)の設定も加わっています)
読み込む前に、文字化けするレイヤはエンコーディングを直しておきます。
4. フォルダ内のShapefileをまとめて変換するPyQGISスクリプト
レイヤが多いときは、フォルダ内のShapefileをまとめて1つのGeoPackageに変換するスクリプトが便利です。次の点を自動で処理します。
- レイヤ名は、Shapefileのファイル名(拡張子なし)にする
- .cpgが無いShapefileは、指定した文字コード(既定はCP932)で読む
- .prjが無いShapefileは、変換はするがCRSが不明だと知らせる
- 出力先のGeoPackageがすでにあるときは、同じ名前のレイヤだけを置き換える
使い方
1. QGISのメニュー「プラグイン」→「Pythonコンソール」を開く
2. コンソールの「エディタを表示」で編集画面を開き、下のスクリプトを貼り付ける
3. 「ここを書き換える」の3行(フォルダ・出力先・文字コード)を直す
4. 実行ボタンで実行する
5. コンソールに出る「成功」「失敗」と注意書きを確かめる
(メニューやボタンの名前は、版や表示言語によって少し違うことがあります)
"""フォルダ内の Shapefile を 1 つの GeoPackage にまとめて変換する(QGIS の Python コンソール用)
- QGIS 3 系と 4 系の両方で動く書き方(列挙型は型名まで書く。3.44・4.2 で確認)
- レイヤ名は Shapefile のファイル名(拡張子なし)
- .cpg(文字コードの指定)が無い Shapefile は FALLBACK_ENCODING で読む
- 出力の GeoPackage がすでにあるときは、同じ名前のレイヤだけを置き換える
"""
from pathlib import Path
from qgis.core import QgsProject, QgsVectorFileWriter, QgsVectorLayer
# ===== ここを書き換える =====
SRC_DIR = r"C:\data\shapefiles" # Shapefile が入っているフォルダ
OUT_GPKG = r"C:\data\converted.gpkg" # 書き出す GeoPackage
FALLBACK_ENCODING = "CP932" # .cpg が無いときの文字コード(Shift_JIS 系)
# ===========================
def convert_folder(src_dir, out_gpkg, fallback_encoding="CP932"):
src_dir = Path(src_dir)
out_gpkg = Path(out_gpkg)
shapefiles = sorted(src_dir.glob("*.shp"))
if not shapefiles:
print(f"Shapefile が見つかりません: {src_dir}")
return []
results = []
for shp in shapefiles:
name = shp.stem
layer = QgsVectorLayer(str(shp), name, "ogr")
if not layer.isValid():
results.append((name, "失敗", "読み込めませんでした"))
continue
notes = []
if not shp.with_suffix(".cpg").exists():
layer.setProviderEncoding(fallback_encoding)
notes.append(f".cpg が無いので {fallback_encoding} で読みました")
if not layer.crs().isValid():
notes.append(".prj が無いので CRS が不明です(変換後に設定してください)")
options = QgsVectorFileWriter.SaveVectorOptions()
options.driverName = "GPKG"
options.layerName = name
options.fileEncoding = "UTF-8"
if out_gpkg.exists():
options.actionOnExistingFile = (
QgsVectorFileWriter.ActionOnExistingFile.CreateOrOverwriteLayer
)
else:
options.actionOnExistingFile = (
QgsVectorFileWriter.ActionOnExistingFile.CreateOrOverwriteFile
)
error, message, _, _ = QgsVectorFileWriter.writeAsVectorFormatV3(
layer, str(out_gpkg), QgsProject.instance().transformContext(), options
)
if error == QgsVectorFileWriter.WriterError.NoError:
notes.insert(0, f"{layer.featureCount()} 件")
results.append((name, "成功", " / ".join(notes)))
else:
results.append((name, "失敗", message))
for name, status, detail in results:
print(f"{status}: {name} {detail}")
return results
convert_folder(SRC_DIR, OUT_GPKG, FALLBACK_ENCODING)
検証の記録:QGIS 3.44.13・4.2.0(Windows)で、検証用に作った3つのShapefile(Shift_JISで書いて.cpgを消したもの、UTF-8の.cpgつきのもの、.prjの無いもの)を変換し、文字・件数・CRSが正しく移ること、同じ出力先に2回実行してもレイヤが重複しないことを確認(2026年11月14日)。
列挙型を QgsVectorFileWriter.ActionOnExistingFile.CreateOrOverwriteLayer のように型名まで書いているのは、QGIS 4(Qt6)でも動かすためです。QGIS 4への移行で変わる点はQGIS 4 移行の実務チェックリストにまとめています。
5. 変換後のチェックリスト
□ 各レイヤの地物の件数が、元のShapefileと同じ
□ 日本語の属性が化けていない(数件を開いて確かめる)
□ CRS(EPSGコード)が元と同じ。.prjが無かったレイヤにはCRSを設定した
□ 10文字で切られた属性名を、必要なら付け直した
□ スタイル・ラベルを付け直した(またはPackage layersで一緒に保存した)
□ 元のShapefileは、しばらく消さずに残した
座標参照系が分からないデータの見分け方はQGISで地図がずれる原因と直し方を参考にしてください。
解決しないときは
参考・一次情報
- GDAL「ESRI Shapefile / DBF」 — 属性名の10文字の制限、使える型、2GB、.cpgとLDIDによる文字コードの判断。
- GDAL「GPKG – GeoPackage vector」 — SQLiteを入れ物にすること、UTF-8、空間インデックスの既定、日時の保存。
- OGC「GeoPackage Standard」 — GeoPackageの規格(最新は1.4.0)。
- QGIS「Database」アルゴリズム(Package layers) — 複数のレイヤを1つのGeoPackageに書き出すアルゴリズム。3.44の説明書きにはSAVE_METADATAなど一部の引数が載っていないため、引数名はQGISのソース(qgsalgorithmpackage.cpp)と、QGIS 3.44.13・4.2.0のアルゴリズムの定義で確かめた。
- PyQGIS API「QgsVectorFileWriter」 — スクリプトで使っている書き出しのクラス。
(いずれも2026年11月14日に確認)
関連記事
- GISデータ形式の違い【シェープファイル・GeoJSON・GeoPackageを比較】
- QGISで大量データを扱う方法【パフォーマンス改善ガイド】
- PyQGIS入門【QGISをPythonで自動化】
- QGISバッチ処理入門【複数ファイルの一括処理】
最終更新: 2026年11月