qwc-services による Web GIS の構築 #5 編集機能

Last updated at 2025-03-31Posted at 2025-03-30

QGIS Server と QGIS Web Client 2 (QWC2) を中核とする統合的 Web GIS エコ・システムである qwc-services によって Web GIS を構築する作業記録の第5回です。

第1回では、qwc-docker によって qwc-services をインストールし、MapCache とも連携させて、QGIS のプロジェクトを Web 地図として表示するところまでやりました。

qwc-services による Web GIS の構築 #1 qwc-docker

第2回では、ユーザの認証と権限管理について調べて、地図やレイヤを閲覧できるユーザを限定したり、ビューワの機能を使用できるユーザを限定したりする方法を確認しました。

qwc-services による Web GIS の構築 #2 認証と権限

第3回では、qwc-services によって実現される「編集」関連の機能に不可欠なデータベース環境である PostGIS を使えるようにしました。

qwc-services による Web GIS の構築 #3 PostGIS

第4回は、ちょっと寄り道をして、QWC2 Viewer とは独立したページを Web GIS に追加する方法として、Python のマイクロ・ウェブ・フレームワークである Flask の使用を検討しました。

qwc-services による Web GIS の構築 #4 独自ページを追加

今回は、いよいよ qwc-services と PostGIS によって実現される編集機能を見ていきます。

1. 編集機能を利用するための条件

マニュアル（QWC2 > Selected topics > Editing > Quick Start
）によると、QWC2 ビューワの編集機能を利用してレイヤを編集できるようにするためには、次に示すステップを踏んでくれ、とのことです。

レイヤのデータソースを PostGIS データベースにする
- 特にデータセットのプライマリ・キーを必ず構成する
QGIS の PostgreSQL 接続をサービス名を使って構成する
- そのサービスをホストの pg_service.conf と qwc-docker/pg_service-write.conf に追加する
- データベース・ホストが Docker コンテナ内からアクセス可能であることを必ず確認する
プライマリ・キー・フィールドが serial タイプである場合は、QGIS の属性フォームで対応するフィールド・ウィジェット・タイプを 非表示 にする
QWC Admin で対応する Map リソースの子として Data リソースを作成する
- 編集を許可するロールに、Map と Data の両方に対する許可を与える
Data リソースに対する許可において Write チェックボックスを OFF のままにすると、データセットは Read Only としてアクセスを許可される
- 属性テーブルや地物フォームをデータセットの表示だけに利用し、編集を許可したくない場合に有効
QWC Admin で Generate service configuration ボタンを押して、サービス構成を更新する

以下、詳しく見ていきます。

1-1. PostGIS は必須

QWC2 ビューワの編集機能は、QGIS Server の WMS や WFS のサービスを利用するのではなく、レイヤのデータソースとなっている PostGIS のテーブルに直接アクセスして情報を取得したり更新したりする仕様になっています。つまり Shapefile をデータソースとするレイヤは編集機能の対象外なのです。

従って、前々回で説明したように、編集対象とするベクタ・レイヤは Shapefile から PostGIS テーブルにデータを移行する必要があります。

qwc-services による Web GIS の構築 #3 PostGIS
- 1-5-3. データベース接続のテスト（データのエクスポート）
- 2-3-3. 一括インポートのスクリプト

どのような方法でも構いませんが、上で述べられているように、プライマリ・キーを必ず設定する必要があります。pgAdmin4 などでテーブルを確認して、プライマリ・キーが適切に設定されていない場合は手作業で修正して下さい。

1-2. pg_service.conf を使う

同じく前々回で説明したように、データベースへの接続には pg_service.conf を使用します。

qwc-services による Web GIS の構築 #3 PostGIS

そのサービスをホストの pg_service.conf と qwc-docker/pg_service-write.conf に追加する

この部分はドキュメントが若干説明不足です。

通常は qwc-docker/pg_service-write.conf を使用する必要はなく、qwc-docker/pg_service.conf に当該サービスを追加登録するだけで構いません。

qwc-docker/pg_service-write.conf は、qwc-data-service において qwc-docker/pg_service.conf の代りに使用することが出来ます。

docker-compose.yml

   qwc-data-service:
     image: sourcepole/qwc-data-service:latest-2025-lts
     environment:
       <<: *qwc-service-variables
       SERVICE_MOUNTPOINT: '/api/v1/data'
       ATTACHMENTS_BASE_DIR: '/attachments'
       MAX_ATTACHMENT_FILE_SIZE: 1048576
     volumes:
       - ./volumes/config:/srv/qwc_service/config:ro
       - ./volumes/attachments:/attachments
-      - ./pg_service.conf:/srv/pg_service.conf:ro
+      # - ./pg_service.conf:/srv/pg_service.conf:ro
       # NOTE: you can mount a pg_service-write.conf with R/W DB users and have R/O DB users in the main pg_service.c    onf
-      # - ./pg_service-write.conf:/srv/pg_service.conf:ro
+      - ./pg_service-write.conf:/srv/pg_service.conf:ro

つまり、他のサービスには qwc-docker/pg_service.conf を読ませるけれども、qwc-data-service だけには qwc-docker/pg_service-write.conf を代りに読ませるという設定が可能です。これによって、PostGIS に対する r/w 権限を持ったユーザを使う設定を qwc-data-service に限定することが可能になります。

qwc-data-service が二つの設定を読んで使い分けてくれるという事ではありません。

1-3. serial 型のプライマリ・キーは非表示にする

QGIS Desktop で、レイヤのプロパティを開き、属性フォームで serial 型のプライマリ・キーのウィジェット型を「非表示」にします。

ウィジェット型を「非表示」にせず、代りに「編集可能」のチェックボックスを OFF にしても良いでしょう。

1-4. Map リソースと Data リソースを作成して許可を与える

1-4-1. リソースの作成

QWC Admin で Map リソースと Data リソースを作成します。

Map リソース ... 編集可能なレイヤの親である地図のリソース
Data リソース ... 編集可能なレイヤを表わすリソース
- Layer リソースは WMS 経由でアクセス可能なレイヤを表わすのに対して、Data リソースは PostGIS 経由でアクセス可能なレイヤを表わす

[＋ New Resource] ボタンからリソースを追加しても構わないのですが、[Imoort maps]、[Import resources] ボタンを使って自動的に登録することが可能です。自動登録の方がスペルミスや親子関係の間違いが無いので確実です。

上の図は、Map リソースの [Import resources] ボタンを押したときに表示される入力フォームです。

リソース ... Map リソースを親とする子リソースのタイプを指定
- 通常は Data を選択
- Data(create), Data(read), Data(update), Data(delete) は、データ・リソースへのアクセスを細かく制御したい場合に使用
ロール ... 自動登録するリソースに対する権限を付与するロールを指定
Write チェックボックス
- ON ... R/W 許可
- OFF ... Read Only 許可

[Import resources] ボタンを押すと Map に含まれる全てのレイヤについて、子のリソースが自動作成されます。そして同時に指定したロールに許可が与えられます。

結果的に不要なリソースも作成されますので、要らないものは後で削除して下さい。

1-4-2. リソースに対する許可を与える

許可（Permissions）の一覧表示で確認して、レイヤの編集を許可したいロールに対して Data リソースと親の Map リソースの許可を付与します。

リソース ... ドロップダウンから選択
ロール ... リソースに対する権限を付与するロールを指定
Write チェックボックス
- ON ... R/W 許可
- OFF ... Read Only 許可

あるロール対してに Data リソースへのアクセスを許可する場合は、そのロールに対して Data リソースの親である Map リソースへのアクセス許可も同時に付与する必要があります。

例えば、あるユーザが user ロールと editor ロールの両方を持っており、user ロールに対して Map へのアクセス許可、editor ロールに対して Data へのアクセス許可が与えられていれば、理屈の上ではそのユーザがレイヤを編集して構わない筈です。しかし QWC2 ビューワではこのユーザはレイヤを編集することが出来ません。editor ロールに Map へのアクセス許可も追加する必要があります。

Data へのアクセス許可の有無は、ユーザのレベルではなく、ロールのレベルで判定されるためです。

1-5. 構成の再作成

リソースや許可を変更したときは、必ず [Generate service configuration] ボタンを押して構成を再作成する必要があります。

2. レイヤの属性フォームの設定

QWC2 ビューワの編集機能は QGIS プロジェクトにおけるレイヤの属性フォームの設定を参照します。

「レイヤ > プロパティ > 属性フォーム」を開いて、各フィールドについて設定を行います。

2-1. 別名（Alias）

「別名（Alias）」に設定した値が地物フォームや属性テーブルにおいてフィールド名の代りに使用されます。

2-2. 編集可能

「編集可能」のチェック・ボックスを OFF に設定すると、地物フォームや属性テーブルにおいて、フィールドは Read Only の扱いになります。

2-3. ウィジェット型

主なウィジェット型としては、

非表示
テキスト編集
日付/時刻
範囲（Range）
チェックボックス
バリューマップ（＝ドロップダウン・リスト）

があります。

2-3-1. 非表示

フィールドを非表示とするためのウィジェット型です。

serial 型のプライマリ・キーなど、ユーザに編集を許さず、見せる必要すら無いフィールドに適しています。

2-3-2. テキスト編集

一般的なテキスト入力欄を表示するウィジェットです。

文字列のフィールドも数値のフィールドも、デフォルトではこの型のウィジェットを使います。

2-3-3. 日付/時刻

日付、時刻、日付/時刻型のフィールドに用いられるウィジェットです。

2-3-4. 範囲（Range）

数値型のフィールドに使用できるウィジェットで、以下を設定することが出来ます。

下限値
上限値
小数点以下の桁数
タイプ
- テキスト & スピンボタン
- スライダー
- ダイアル（QWC2 ビューワは未対応）
ステップ

数値型のフィールドにはデフォルトでは「テキスト編集」ウィジェットが割り当てられますが、この「範囲（Range）」ウィジェットの使用を検討して下さい。

下限値、上限値を指定出来る
実数の場合、小数点以下の桁数を指定できる
スピンボタンやスライダを使用できる

というメリットがあります。

「範囲（Range）」ウィジェットを使用すると

スピンボタンやスライダを使用できる

というメリットがありますが、反面、不要な場合でもスピンボタンを非表示に出来ないというデメリットもあります。

2-3-5. チェックボックス

bool, boolean 型のフィールドで使うことを想定したウィジェットです。

2-3-6. バリューマップ（＝ドロップダウン・リスト）

ドロップダウン・リストから値を選択したい場合に使用できるウィジェットです。文字列型のフィールドにも、数値型のフィールドにも使用することが出来ます。

値 ... フィールドに入力される値
説明 ... ドロップダウン・リストに表示される文字列

リストの作成には「レイヤからデータをロード」を利用することが出来ます。

3. 編集対象レイヤでキャッシュを使用しない

編集機能を使う場合は、地物データと地図画像キャッシュとの間に生じるズレが問題になってきます。

つまり、地物データが更新されたのに、ビューワが古い地図画像キャッシュを表示するために、次のような不具合が生じます。

追加した地物が表示されない
削除した地物がまだ表示されている
位置や形状を変更した地物が古い位置や形状で表示される
変更した文字ラベルが古いまま表示される

不具合の回避措置として、編集対象となるレイヤでキャッシュを使わないように設定を変更します。

具体的には、qwc-docker/volumes/config-in/default/themesConfig.json で内部レイヤと外部レイヤの関係を定義しているブロックにおいて、編集対象のレイヤの分を削除します。

themesConfig.json

        "themes": {
            "items": [
                {
                    "id": "isg",
                    "name": "isg",
                    "url": "/ows/scan/isg",
                    "externalLayers": [
-                       {
-                           "name": "spots",
-                           "internalLayer": "spots"
-                       },
-                       {
-                           "name": "tanada",
-                           "internalLayer": "tanada"
-                       },
-                       {
-                           "name": "bld",
-                           "internalLayer": "bld"
-                       },
                        {
                            "name": "road",
                            "internalLayer": "road"
                        },

これで編集対象のレイヤはキャッシュを介さずに表示されるようになります。

これは、パフォーマンスを犠牲にした一時的な回避措置です。

パフォーマンスを犠牲にせずに編集機能と地図画像キャッシュとを両立させる方法については、次回に説明しますので、参照して下さい。

4. ビューワの編集機能

4-1. 地物フォーム

メニューやトップバーから「地物フォーム」を選択すると、「地物を確認したい地点をクリック」というプロンプトが表示されます。

編集可能な地物をクリックすると、下の図のような「地物フォーム」パネルが開いて、選択された地物の属性とジオメトリを編集することが可能になります。

Data または Dara (read) 権限のみの場合は閲覧のみ可能
属性の編集
- 権限が必要
  - Data (write) または Data (update) 権限
- 数値や文字列の属性をフォームで編集することができる
- 編集を完了させたければ「コミット」
- 編集を中止したければ「中止」
ジオメトリの編集
- 権限が必要
  - Data (write) または Data (update) 権限
- 選択された地物の制御点が表示される
- 制御点を掴んで移動することができる
- ポリゴンやポリラインは、ライン上でクリックすると、新しい制御点を追加できる
- 制御点の上で Shift + クリック で削除
- 編集を完了させたければ「コミット」
- 編集を中止したければ「中止」
削除
- 権限が必要
  - Data (write) または Data (delete) 権限
- 地物そのものを削除することができる
- 編集を開始する前または完了した後のみ「削除」ボタンが出る

4-2. 属性テーブル

メニューやトップバーから「属性テーブル」を選択すると、下の図のような「属性テーブル」が表示されます。

4-2-1. 一覧表示

レイヤを選択して「再ロード」ボタンを押すと、下の図のように、レイヤの地物が一覧表示されます。

ヘッダ
- クリックすると、その属性の値で表をソート
フッタ
- ページングボタン
- ページあたりの行数を選択するドロップダウン
- フィルタ
  - 属性
  - 演算子
    - ~ ... 部分一致
    - = ... 一致
    - > ... 大きい
    - >= ... 等しいか大きい
    - <= ... 等しいか小さい
    - < ... 小さい
  - 比較対象値

下の図では、「利用状況｣に｢コシヒカリ｣という文字列を含むものを面積の小さい順にリストしています。

4-2-2. マップ・キャンバス上での位置表示

下の図のように、属性テーブル上の行にマウスをホバーさせると、その地物がマップ・キャンバス上で示されます。

4-2-3. ツールボタン

ボタン	機能	内容
	再ロード	レイヤを変更したときなどに一覧表を再ロード
	地物を追加	属性テーブルではできないので「編集フォームを使ってこのレイヤに新しい地物を追加して下さい」というメッセージが表示される（だけ）
	地物にズーム	チェックボックスで選択された地物（複数可）にズーム
	フォームで編集	チェックボックスで選択された地物（一つだけ）を地物フォームで編集
	削除	チェックボックスで選択された地物（複数可）を削除
	CSV エクスポート	テーブルの内容を CSV にエクスポート