jpmap_terrain

jpmap_terrainは、日本の地理院タイル標高データに基づきBabylon.jsで3D地形表現を構築するフロントエンドプロジェクトです。TypeScriptで実装され、npmパッケージ jpmap-terrain としてESMおよび型定義ファイル(.d.ts)付きで配布されています（@babylonjs/coreはpeerDependency）。 主な公開APIは2つあります。第1の JpmapTerrain は、任意のDOM要素にマウントして3D地形ビューアを埋め込むもので、WebGPU/WebGL2エンジン選択、緯度経度・高度・方位角・仰角の指定、flyToによるカメラ移動、コンパス表示切替などが可能です。地図種別として標準地図と航空写真を切り替えられます。第2の JpmapDiorama は、地形を手元サイズの正方形「箱庭」として表示するAPIで、標準WebブラウザとWebXR(immersive-ar)セッションの両方に対応し、AR対応環境ではARセッションへの突入が可能です。 デモポータルには17のデモが含まれており、3D地形ビューア、タイムラプス（太陽位置・陰影アニメーション）、ズームループ、富士山頂周回、ポリゴン/サークルAPI確認、距離計測、QGroundControl .planファイルビューア、GPXビューア（統計・標高グラフ付き）、3Dモデル配置、アバターアニメーション、Boids群衆シミュレーション、フライトデモ、Havok物理を使用したArtillery対戦ゲーム、グローブ地形、箱庭ジオラマなどが含まれます。 技術スタックは TypeScript / Babylon.js / Vite（デモ用）/ tsdown（ライブラリビルド用）/ Playwright（Visual Regression Test）/ Vitest（ユニットテスト）です。開発サーバーはホットリロード付きで起動し、Docker/Nginxによるデモサイト配信構成も提供されています。URLパラメータでエンジン切替、地図種別、2D/3D表示モード、Google Maps互換の緯度経度パス形式によるカメラ位置指定が可能です。ライセンスはApache-2.0です。