前編では、3Dmapspocket®をゼロから見直すことになった背景と、v4で目指した開発の方向性を紹介しました。
後編では、3D Tiles Viewerを中心に、実際にどのようなリファクタリングを行ったのか、さらに3Dオブジェクトの表示やUIをどう改善したのかを紹介します。
3D Tiles Viewerの改善
3Dmapspocket®のソフトウェア開発チームに所属するM.Bです。3D Tiles機能を実装した際に直面した課題の一つが、開発期間でした。
期待以上の可能性を示したPoCが、短期間でリリースしたい製品機能へと変わり、その過程でソフトウェアアーキテクチャにも改善すべき点が見えてきました。
製品としてさらに機能を拡張していくため、v4では3D Tiles Viewerの設計から見直すことにしました。
静的グローバルクラスからReact Providerへ
3Dmapspocket®の開発を通じて、過去の経験から得た設計手法のすべてが、そのまま大規模なWebアプリケーションへ適用できるわけではないことを学びました。
ダイナミックマッププラットフォームへ入社する前は、Unityを使うゲーム業界で開発していました。ゲーム開発の経験がある方なら、当初の設計思想の背景を理解できると思います。
StaticなSingleton Game Managerは、ゲーム開発では非常に一般的です。3D Tiles Viewerは独立したシステムになるため、慣れ親しんだ設計パターンをそのまま使い、Static Singleton Classでも問題なく動くと考えていました。
しかし、開発を進めるにつれて、Reactアプリケーション内でStatic Classを使うことによる課題が見えてきました。
Static Classの変更とState changeを同期するための処理が増え、コードは想定以上に複雑になり、機能を拡張する際にも影響範囲が広がっていきました。
そこで今回のリファクタリングでは、Reactで一般的に使われるReact Provider Patternを採用しました。このパターンは、Viewerで使用していた主要なState Managerに特に有効でした。
以前は、次のようなGlobal Static Classを使用していました。

最終的には、次のようなReact Providerへ置き換えました。

これまで管理が難しく、既存の実装の上に追加コードを重ねる原因となっていたStateは、Provider内部へ追加したReducerで処理できるようになりました。
Reducerの詳細は、React公式ドキュメントを参照してください。
https://react.dev/reference/react/useReducer
このProviderは、RouteのJSXコード内で親React Componentとして配置するだけで利用できます。

上記のコードが、3D Tiles Routeから返されるJSXのすべてです。
コードの可読性を高め、それぞれの責務を分離することで、機能を拡張しやすい構造になりました。
3D Tiles ViewerのState dataを必要とするComponentはProvider内へ配置し、useTDTViewer()関数を呼び出すことで、Provider内の必要なFieldへアクセスできます。

拡張性に加えて、Providerを親に持たないComponentでは、そのProviderは使用されません。
旧Static Class実装では、これらのClassがアプリケーションのすべてのRouteでメモリへ読み込まれていましたが、v4では必要な場所でのみ使用する構造へ変更しています。
Cesium Entity管理の改善
3D Tiles Viewerでは、3D TilesとScene内のその他すべてのEntityを描画するために、CesiumJSを使用しています。
計測、3D Object、Cameraなど、ユーザーがScene内へ配置できるObjectは、Cesium Entityとして管理されます。
旧3Dmapspocket®にもEntityの動作を管理する仕組みはありましたが、機能拡張を進めるうえで、よりクリーンでモジュール化された構造へ改善する余地がありました。これはリファクタリングで最初に修正した点の一つです。
Cesium Entity ClassをWrapperで包む
まず、私はこれらのObjectに対するラッパークラス(wrapper class)を作成したいと考えました。
CesiumJSでは CallbackProperty と呼ばれる仕組みを利用することで、Entityのプロパティを動的に定義できます。

この例では、ラッパークラスの中に entity というフィールドがあり、その中にEntity Objectを保持しています。
このコードは本質的には次のような意味になります。
「this._position Fieldが更新されたときに、Cesium Viewer上のEntityの位置も更新する」
これにより、アプリケーション側での位置変更をCesium Viewer上の表示へ反映できます。
従来は、Cesiumのワールド空間内におけるEntityの位置を変更するたびに、新しい ConstantProperty Instanceを生成し、関数へ渡す必要がありました。v4では、ラッパークラス内のFieldを更新することで、位置の変更がCesiumのワールド空間へ自動的に反映されるようにしています。

Entityを2種類に整理
Wrapper Classにより、Scene内のEntityを一般的に扱いやすくなりました。
さらに、ユーザーが操作するEntityの期待動作を整理してみると、明確に2種類へ分類できることが分かりました。
例として、単純な2点間計測を見てみましょう。
この場合、Cesium Entity instanceは4つあります。各Pointに1つずつ、Polylineに1つ、Labelに1つです。
ユーザーが計測を開始すると、Cursorに追従するPoint Entityが生成されます。そのEntityを場所の選択によって「配置」すると、2つ目のPointに加えてLabelとPolylineが生成されます。
新しいPointも最初のPointと同様にCursorへ追従し、場所を選択すると配置され、計測が完了します。
PolylineとLabelの動作は、Pointとは異なります。Labelは2点間の距離を計測して文字で表示し、Polylineは2点間に線を描画します。いずれも、2つのPointの位置の変化に反応するEntityです。
そこで、Entityを次の2種類に分けました。
- Movable Object:ユーザーが持ち上げて配置したり、位置を手動で変更したりできるEntity
- Reactive Object:Movable Objectの変化をListenし、その変化に基づいて自身を更新するEntity
この設計により、PointはLabelやPolyline Entityの存在を意識せず、Listenしている相手へEventをEmitするだけで済みます。LabelとPolylineには、Eventによる更新時のPointの位置など、必要な情報だけを渡します。
より複雑なInteractionでも、このEntityの定義を組み合わせることで対応できます。 その一例が、3D Cubeの作成です。
この場合でも、すべてのEntityの動作はMovable ObjectとReactive Objectの2つの分類に収まります。
この設計によって、従来よりもモジュール化され、拡張しやすい構造になりました。
3D Tiles Viewerへ新たな機能を実装する際には、コードベース上ですでに定義されたAbstract Classを使うことで、Entity表示を必要とする機能を実装しやすくなります。
さらに複雑なEntity Interactionが必要となり、MovableにもReactiveにも分類できないObjectが必要になった場合も、元のCesium Entity Wrapper Classを実装するAbstract Classを追加し、必要なロジックを定義することで対応できます。
Cesium Viewer内の表示改善
ここまで紹介してきた設計面の改善に加え、v4では3D空間を実際に操作するユーザーの見やすさにも手を入れました。
複数のEntityが連携する一部のToolでは、従来、PointとPolylineを同じ色で表示していました。

v4ではSecondary colorを追加し、PointとPolylineで異なる色を使用できるようにしました。

PointとPolylineの役割を色によって区別することで、それぞれの関係を把握しやすくしています。
これらの色は完全にカスタマイズ可能で、ToolごとにPrimary colorとSecondary colorを選択できます。
表示面でのもう一つの大きな改善が、ユーザーが作成した3D ObjectへのEdge lineの追加です。従来のStyleでは、見る角度によって、一つの面がどこで終わり、別の面がどこから始まるのか判別しにくい場合がありました。

この表示では、Cameraを向いているEdgeを確認しにくくなっています。
v4では次のように表示されます。

Edge Lineを追加することで、立体物の形状や面の境界を、より直感的に把握できるようになりました。
設計上の変更だけでなく、実際に3D空間を操作するユーザーにとっての見やすさも、v4で重視したポイントの一つです。
UIの改善 見た目から、その裏側の構造まで
v4ではアプリケーションを拡張・保守しやすくするため、地図画面を構成する仕組みも見直しました。
これまでページごとに実装していた地図のさまざまな機能を、アプリケーション全体で共有できる、再利用可能で組み合わせ可能なComponentとして整理しています。
前述したReact Provider Patternも、ここで効果的に活用しています。

この構造により、地図全体の一貫性を保ちながら、各ページで必要なDataとBehaviorを設定できます。
v4では、さまざまな種類のStateも役割に応じて分離しています。
- TanStack Router:Route、URL Search State、Route Loaderを管理
- TanStack DB:Marker dataとProject dataのReactive Collectionを提供
- Redux Toolkit:選択中Marker、追加待ちMarker、Street View表示など、クライアント側のInteraction Stateを管理
- Zod-style Schema:Route inputをValidation
- Feature Folder:Domain固有コードを、その責務を持つFeatureの近くへ配置
v3では、地図のBehaviorがViewCanvas、MapCanvas、Shared Providerなどの大きなComponentへ集中していました。
v3にも再利用可能な要素はありましたが、v4ではそれぞれの境界をより明確にし、Route ComponentをCompositionとOrchestrationへ集中させています。
こうした設計の見直しは、実際の画面にもつながっています。
v3とv4を比較


v4では、情報の階層や操作メニューを整理するとともに、画面を構成する機能を共通Componentとして整理しました。
ページごとに扱うデータが異なる場合でも、基本的な操作方法やUIの一貫性を保ちながら、新しい機能やデータを追加しやすい構造を目指しています。


共通Componentを組み合わせて各画面を構成することで、ページに応じた機能を提供しながら、UIや操作方法の一貫性を保ちやすくなります。
Dashboardも共通Componentで構成
Dashboardでも、ComponentのReuseとCompositionにより重複コードを削減しています。
Dashboard専用の地図、Marker、詳細表示を別々に作るのではなく、アプリケーション全体で使われる次のComponentを再利用します。
- Map Provider
- Map Frame
- Deck.gl Layer
- Marker Modal
- Marker Details Component
Dashboardは、履歴Heatmapや期限切れMarker datasetなど、画面に必要となるDataとConfigurationを供給します。
Dashboard機能もProvider、Filter、Chart、Content Componentへ分割し、それぞれの責務を明確にしました。
これによりRouteを軽量に保ちながら、ユーザー体験の一貫性を維持できます。また、Shared Componentを加えた改善を、そのComponentを使用する各ページへ反映しやすくなります。


継続的に進化できるアプリケーションへ
v4の開発では、React Provider Patternを活用したState管理、Cesium Entityの扱い、再利用可能なComponent、3Dオブジェクトの表示、UIなど、幅広い領域を見直しました。
その根底にあるのは、今後さらにデータや機能、利用シーンが増えていったときにも、継続的に改善していけるアプリケーションにするという考え方です。
拡張性の高いコードは、新しい機能やユーザーのニーズへ柔軟に対応していくための土台になります。一貫性のあるUIや3D空間の視認性向上も、さまざまな地理空間データをより扱いやすくすることにつながります。
私たち開発チームは今後もユーザーからの声や新たな利用ニーズを取り入れながら、3Dmapspocket®を継続的に改善し、より良いアプリケーションへ育てていきます。
