KASUGAI Canvas v6.17.0

リリースビルド

python run.py -B

配布用 ZIP（kasugai_canvas.exe + web/ + projects/）と、NSIS が利用可能な場合はインストーラーを download\ に作成します。既定のインストール先は C:\kasugai\kasugai_canvas です。

自動更新

Rust サーバー起動時は、管理（⚙）→ その他 から最新リリースの確認・自動更新が行えます。更新時は EXE を自動的に差し替えて再起動します。

起動方法（通常のHTTPサーバー）

cd web
python -m http.server 8520

web/ をドキュメントルートに置くだけです。ブラウザで http://127.0.0.1:8520/ を開いてください。

起動方法（Rustサーバー / 開発）

cargo run --manifest-path server\Cargo.toml
# または
python run.py            # 開発起動
python run.py --release  # リリース版を起動

ブラウザで http://127.0.0.1:8510/ を開いてください。ポートは KASUGAI_CANVAS_PORT 環境変数で変更できます。インスペクター設定は projects/<project>/kasugai_canvas.kasc に保存されます。

起動方法（.kasc ファイルから起動・インストーラー版）

インストーラー版は .kasc 拡張子を関連付けます。任意のフォルダにある .kasc をダブルクリックすると、そのファイルを外部プロジェクトとして登録して開きます。.kasc のあるフォルダがそのままプロジェクトルートになり、DATA/ などの相対参照はそのフォルダ基準で解決されるため、.kasc と DATA/ をまとめたフォルダを渡すだけで納品できます。登録はプロジェクト一覧に残り、システムとは別の場所に複数プロジェクトを管理できます（ファイル名は kasugai_canvas.kasc 以外でも可）。管理（⚙）→ プロジェクト の「プロジェクトルート」で、現在のプロジェクトが実際にどのフォルダを基準にしているか確認できます。詳細は V5: アプリ化 を参照してください。

納品パッケージの推奨構造（プロジェクト群＋共有 DATA/）

納品フォルダ/             … ワークスペースルート。ZIP にしてそのまま渡す
├─ DATA/                  … 全プロジェクト群で共有（../../DATA/x で参照）
├─ ProjectsA/
│  ├─ projects.json       … 群マニフェスト [{"dir":"ProjectA","kasc":"xxx.kasc","title":"計画A"}, ...]
│  ├─ DATA/               … （任意）群内共有（../DATA/x で参照）
│  ├─ ProjectA/{xxx.kasc, project.json, DATA/}
│  └─ ProjectB/{yyy.kasc}
└─ ProjectsB/
   ├─ projects.json
   └─ ProjectC/{zzz.kasc}   … ProjectsA と同じ ../../DATA/ を共有

相対参照の規則: DATA/x は .kasc のあるフォルダ内、../x は1つ上（群フォルダ＝群内共有）、../../x は2つ上（ワークスペースルート＝全群共有）を指します。projects.json を持たないフラット構造（{P1, DATA}）は従来通り ../ が1つ上を指します。この構造を ZIP にすれば受け取り側は群内の .kasc を1つダブルクリックするだけで、マニフェストの一覧に従って群の全プロジェクトが登録され、全参照が解決します。

基本の流れ

• 設定は projects/<project>/kasugai_canvas.kasc に記述します。
• ローカルデータは projects/<project>/DATA/ 以下に置き、設定から相対パスで参照できます。
• 「エクスポート(.kasc)」ボタンで変更をダウンロードし、設定ファイルと差し替えて保存してください。
• web/ ディレクトリは通常の HTTP サーバーにそのまま配置できます。

プロジェクト構成

web/                    # フロントエンド資産(静的配信のみで動作)
├─ index.html / app.js / styles.css
└─ projects/
   ├─ projects.json      # プロジェクト一覧 [{"id":"...","title":"..."}]
   └─ <project_id>/
      ├─ project.json     # 表示名等
      ├─ kasugai_canvas.kasc  # インスペクター設定
      └─ DATA/            # ローカルGeoJSON・3D Tiles・画像等

設定内の相対パス（例: DATA/sample.geojson）は projects/<project_id>/ 直下に解決されます。../DATA/x のように .. で1階層上を指すと、プロジェクト群と並列の共有 DATA/（通常プロジェクトは projects/DATA/）を参照でき、複数プロジェクトで同じデータを使い回せます。Rustサーバー使用時は同構成の projects/ をサーバーと同階層に配置します。

納品用ローカル化の出力先（_local ワークスペース）

管理（⚙）→ アプリ → 保存 で「共有（既定）」または「専用」を選んで「納品パッケージを生成」を実行すると、元のプロジェクトを変更せず、プロジェクトフォルダの隣に <プロジェクト名>_local/ を生成します。共有の取り込み先は _local/DATA/、専用は _local/<name>/DATA/ です。HTTP・HTTPS データは http/、3dtiles: レイヤーの HTTP タイルセットは一式を http/3dtiles/（クラウド・ローカル由来はそれぞれ cloud/・local/）、クラウドは cloud/取得元ハッシュ/ に保存します。xyz: 行のリモートタイルは http/xyz/<name>/ に受け皿フォルダのみ生成して参照を書き換えます（タイル本体はユーザーが配置）。ベースマップ相当の 3D Tiles（Google Photorealistic 等）と base: 行は対象外です。

_local/ は群マニフェスト projects.json とプロジェクトの複製（書き換え済み .kasc＋ローカル DATA/）を含む自己完結パッケージで、フォルダごと ZIP にして渡せば受け取り側は複製内の .kasc を開くだけで使えます。参照は ../DATA/http/x.csv（共有）または DATA/http/x.csv（専用）の相対パスで、登録IDが変わっても維持されます。元からあったローカルデータは DATA/local/ に集約して複製され、取得したデータ（http/・cloud/）とは別フォルダに分かれます。再実行は _local/ を作り直します。詳細は V5: アプリ化 を参照してください。

設定の保存

静的サーバーでは設定をサーバーに保存しません。インスペクターの「エクスポート(.kasc)」でダウンロードし、対象プロジェクトの kasugai_canvas.kasc と差し替えてください。

インスペクター設定

xyz: OpenStreetMap | https://tile.openstreetmap.org/{z}/{x}/{y}.png
base: 地理院タイル 全国最新写真 | https://cyberjapandata.gsi.go.jp/xyz/seamlessphoto/{z}/{x}/{y}.jpg | 出典：国土地理院 | max=18
cam: 東京駅 | 35.653108 | 139.761449 | h=2200.6 | p=-30
info: https://example.com/project-info.html

1 行 種類: 値 形式でレイヤー、ベースマップ、カメラ、Info、凡例等を記述します。完全な書式・オプション・ローカルファイル追加手順は .kasc 設定仕様 を参照してください。