【テックブログ】3Dmapspocket® v4はどう変わった?3D機能を支える設計とUI改善の舞台裏

公開日
更新日
  • X
  • Facebook
  • LinkedIn
【テックブログ】3Dmapspocket® v4はどう変わった?3D機能を支える設計とUI改善の舞台裏

前編では、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を比較

 v3の地図画面
v4の地図画面

v4では、情報の階層や操作メニューを整理するとともに、画面を構成する機能を共通Componentとして整理しました。

ページごとに扱うデータが異なる場合でも、基本的な操作方法やUIの一貫性を保ちながら、新しい機能やデータを追加しやすい構造を目指しています。

v3の地図詳細表示
v4の地図詳細表示

共通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を使用する各ページへ反映しやすくなります。

v3 Dashboard
v4 Dashboard

継続的に進化できるアプリケーションへ

v4の開発では、React Provider Patternを活用したState管理、Cesium Entityの扱い、再利用可能なComponent、3Dオブジェクトの表示、UIなど、幅広い領域を見直しました。

その根底にあるのは、今後さらにデータや機能、利用シーンが増えていったときにも、継続的に改善していけるアプリケーションにするという考え方です。

拡張性の高いコードは、新しい機能やユーザーのニーズへ柔軟に対応していくための土台になります。一貫性のあるUIや3D空間の視認性向上も、さまざまな地理空間データをより扱いやすくすることにつながります。

私たち開発チームは今後もユーザーからの声や新たな利用ニーズを取り入れながら、3Dmapspocket®を継続的に改善し、より良いアプリケーションへ育てていきます。

筆者

ソフトウェア技術部

M.B.

関連記事

サービスに関するお問い合わせ、
またはIRメールの配信登録はこちらから
FOLLOW US
  • X
  • YouTube
  • Facebook
  • LinkedIn