Gaia にオントロジーデータを追加する

Foundry オントロジーの一部として設定された地理空間データを、ユーザーのユースケースに応じてさまざまな方法で Gotham の Gaia アプリケーションに追加できます。Foundry オントロジーデータを Gotham で利用可能にするためには、Foundry の オントロジーマネージャ を使用して興味のあるオブジェクトタイプをタイプマッピングすることで、両者のオントロジーの統一表現を確立する必要があります。

Foundry データを Gaia に追加するための利用可能な方法の比較

Foundry でオブジェクトタイプをタイプマッピングして Gotham 統合を有効にした後、Foundry オントロジーのデータを Gaia に追加するための 6 つの方法があります:

• ドラッグ＆ドロップ
• Foundry オブジェクト検索
• 検索テンプレート
• 地理時間系列同期
• 関数を利用したエンタープライズマップレイヤー
• バージョン管理オブジェクトセットを利用したエンタープライズマップレイヤー

各方法に関する詳細情報は以下の表で確認できます:

以下のセクションでは、各統合方法を実装するための詳細な手順を提供しています。

個別のオブジェクトと保存された探索をドラッグ＆ドロップする

Foundry から Gaia マップへ個別のオブジェクトまたは保存された探索から派生したオブジェクトセット（最大 5,000 個のオブジェクトを含む可能性があります）をドラッグ＆ドロップすることができます。

Foundry から Gaia マップに個別のオブジェクトをドラッグ＆ドロップするには:

1. Foundry で Object Explorer を起動します。
2. オブジェクトタイプを検索します。
3. Object Explorer 画面の最右側の 結果 パネルからオブジェクトを選択します。
4. Object Explorer 画面の左上隅にあるオブジェクトのアイコンを選択します。
5. Foundry からオブジェクトをドラッグし、Gaia マップの任意の場所にドロップします。これで、ユーザーのマップ上と左側パネル内でデフォルトレイヤーとして Dropped Object Layer [Date] [Time] というタイトルの一部としてオブジェクトを表示できます。

Foundry から Gaia マップにオブジェクトセットをドラッグ＆ドロップする前に、既存のオブジェクトタイプからバージョン管理オブジェクトセットを作成する必要があります。バージョン管理オブジェクトセットを作成するには:

1. Foundry で Object Explorer を起動します。
2. ユーザーのオブジェクトタイプを検索して選択します。
3. Object Explorer 画面のトップリボンの中央にある 結果 を選択します。
4. 検索バーを使用してオブジェクトタイプのプロパティで選択を絞り込み、オブジェクトセットに追加するオブジェクトをフィルター処理する。
   • たとえば、オブジェクトタイプが name プロパティによって定義された位置をキャプチャする場合、where name is location_1 or where name is location_2 と入力し、キーボードの enter または return を押して location オブジェクトをフィルター処理することができます。
5. 選択したオブジェクトを公開プロジェクト内の探索として保存するために、青い 保存 ボタンを選択します。

バージョン管理オブジェクトセットを探索として作成および保存した後、以下の手順に従って Gaia マップにそれをドラッグ＆ドロップすることができます:

1. Object Explorer ビューのトップリボンから 新しい探索 を選択します。
2. 作成時に付けた名前に基づいてオブジェクトセットを検索して選択します。オブジェクトセットは、Object Explorer の検索バーの下の 私の探索とリスト にも表示される場合があります。
3. Object Explorer 画面の左上隅にあるオブジェクトセットのアイコンを選択します。
4. Foundry からオブジェクトセットをドラッグし、Gaia マップの任意の場所にドロップします。オブジェクトは、ユーザーの保存した探索にちなんで自動的に名前付けされた検索レイヤー内にネストされ、マップと左側パネルに個別に表示されます。

Gaia で Foundry オブジェクトタイプを検索する

Gaia の左側パネルの データソース セクション内で Foundry オブジェクトタイプを検索できます。さらに、マップに追加する前にオブジェクトに対して幾何学的および時間ベースのフィルターを適用できます。Gaia から Foundry オブジェクトタイプを検索するには:

1. マップの左側パネル内で データソース を選択します。
2. Foundry 内での名前に基づいてオブジェクトタイプを検索し、左側パネルの下部にある オブジェクトタイプ に表示されます。
3. オブジェクトタイプの横にある オブジェクトを検索 を選択します。
4. マップに追加したいオブジェクトを選択し、オブジェクト検索パネルのトップリボンで利用可能な必要な幾何学フィルターを適用します。
   • すべて は、発見されたオブジェクトタイプからすべてのオブジェクトをマップに追加します。
   • ビュー は、現在のマップビュー内で利用可能なオブジェクトのみを追加します。
   • 描画 は、検索パネルから設定および追加できる図形内に存在するオブジェクトをマップに追加します。
   • 選択 は、アクティブなマップからアイテムを選択することを可能にします。
5. 静的範囲 または ローリングウィンドウ 内でアクティブなオブジェクトを読み込むために必要な時間フィルターを適用します。
6. 必要に応じて ライブ更新検索結果 をオンに切り替えることができ、フィルタリングパラメーターに一致する新しく作成されたオブジェクトに基づいて、30 秒ごとにオブジェクトまたはオブジェクトセットが更新されます。
7. 検索タイトル 内にオブジェクト検索の名前を入力し、検索 を選択します。

検索テンプレートを作成する

Gaia 管理アプリケーションで検索テンプレートを作成し、Foundry オブジェクトをマップに追加する際に左側パネルの データソース タブを通じてカスタムオブジェクト検索インターフェースを事前に設定できます。

検索テンプレートを作成して実装するには、Gaia 管理アプリケーションを起動し、以下の手順に従ってください:

1. ジオ検索 パネルを見つけて、表示 を選択して Gotham エンロールメント内のすべてのアクティブなジオ検索を表示します。
2. ジオ検索リストの下にスクロールし、追加 を選択します。
3. 検索にタイトルを付け、各構成入力ボックスに入力します。
   • 説明 は検索テンプレートインターフェースの上部に表示されます。
   • タブ ID はジオ検索と検索テンプレート間のマッピングを可能にします。
   • タブアイコン はユーザー検索時に データソース タブに表示されます。
   • テンプレート ID は タブ ID と一致し、ジオ検索と検索テンプレート間のマッピングを可能にします。
   • 分類 はエンロールメントに応じてオプションである場合があります。
   • ACL グループ はグループアクセスのための権限を設定します。
4. 必要に応じて追加の構成を入力します。
5. Gaia 管理アプリケーションでジオ検索を保存するために、右上リボンの プレビューと保存 を選択します。

検索テンプレートとペアリングされた場合に、Gaia マップ上でフランスの都市を検索し、その地理的境界を表示できるようにするジオ検索の例を参照できます。

6. 検索テンプレート パネルを見つけて、表示 を選択して Gotham エンロールメント内のすべてのアクティブな検索テンプレートを表示します。
7. 既存の templates: の下にスクロールし、検索テンプレートの構成とジオ検索マッピングを含む YAML コードを挿入します。以下の検索テンプレート YAML コードブロックの例を参照できます。

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
- id: french_cities # `Tab ID`と`Template ID`フィールドのgeo searchと一致します。
    title: French cities # `Data sources`パネルに表示される検索テンプレート名。
    query:
      queryType: AND # クエリタイプを定義し、関連するサブクエリを挿入します。
      subqueries:
        - inputId: keyword
          queryType: KEYWORD
        - field: object_type
          queryType: OBJECT_TYPE
          value:
            - # オブジェクトタイプのRID
    dataSource: foundry-federation
    namespaces:
      - foundry-federation
    description: フランスの都市を検索し、その境界を表示します。
    integratedDataSetIds: []
    inputs:
      - hint: Type a keyword... # キーワードを入力してください...
        id: keyword
        inputType: TEXTFIELD # フリーテキスト検索を有効にします。
        label: Keyword
    aggregations: []

8. 右上のリボンにある Preview and save を選択して、検索テンプレートを保存します。

Gaia マップに戻って検索テンプレートをテストできます。左側のパネルの Data sources タブに検索テンプレートの名前を入力するか、Integrated data sources サブセクションから手動で選択します。検索テンプレートを選択して、geo 検索と YAML 設定を利用した事前構成済みのインターフェースを起動します。Keyword 検索バーや YAML コードで行ったカスタム設定を使用してオブジェクトを検索し、左側のパネルの下部にある青い Search ボタンを選択する前に Search title を入力します。

検索結果は Gaia マップに表示され、さらに探索できます。

Foundryでリアルタイムのジオテンポラルシリーズ同期を設定する

FoundryのPipeline Builderを使用して、既存のデータセットからジオテンポラルシリーズ同期を作成し、追加の設定なしで Gaia マップに高スケールのリアルタイムジオテンポラルデータを追加できます。

Foundryでジオテンポラルシリーズ同期を作成するには：

1. データセットに移動し、ジオテンポラルシリーズ同期を有効にするためのすべての前提条件フィールドが含まれていることを確認します。
2. All actions > Create new pipeline を選択して Pipeline Builder を起動します。
3. データセットノードを選択し、垂直ポップアップメニューの上部で Transform を選択します。
4. latitude と longitude フィールドをマッピングして新しい geo_point 列を作成するために Construct GeoPoint column を検索して選択します。
5. トランスフォームの左上隅にある編集ボックスを通じてトランスフォームの名前を Create GeoPoint に変更します。
6. 画面の右上にある緑色の矢印アイコンを選択してトランスフォームを保存します。
7. トランスフォームの右上にある Back to graph を選択して Pipeline Builder グラフに戻ります。
8. Create GeoPoint トランスフォームノードの Add output ボタンを選択し、New geotemporal series sync を選択します。下の画像は、Pipeline Builderで利用可能な出力タイプのメニューを示しています。

9. 新しい出力に名前を付け、Destination namespace を Local System などに割り当てます。
10. Primary fields をすべて設定して、同期が元データセット内の正しい列を参照することを確認します。
11. 各プロパティの右側にある X アイコンまたは Clear unmapped properties ボタンを選択して、マッピングされていないプロパティをすべてクリアします。
12. Properties の下で Observation schema を空白のままにします - Foundry は Metadata で上記のシリーズ同期出力に割り当てた名前を自動入力します。
13. Advanced settings の Source system がパイプラインの名前にマッピングされていることを確認します。下の画像は、同期出力に必要なすべての設定を示しています。

14. 画面の右上にある緑色の矢印アイコンを選択して同期を保存します。
15. Save の隣にあるハンマーアイコンを選択して Deploy pipeline を行います。
16. Back to graph に移動します。Create GeoPoint トランスフォームの右側に新しいジオテンポラルシリーズ同期出力ノードが表示され、ノードの下部に緑色の Deployment up-to-date テキストが表示され、正常にデプロイされたことを確認できます。

新しく作成したジオテンポラルシリーズ同期を Gaia マップに追加するには：

1. Gaiaの左側パネルの Data sources タブを開きます。
2. ジオテンポラルシリーズ同期の名前を検索し、Tracks and observations search を選択します。
3. オブジェクト検索パネルの上部リボンにある必要な幾何学的フィルターを適用します。
   • All は、発見されたオブジェクトタイプのすべてのオブジェクトをマップに追加します。
   • View は、現在のマップビュー内で利用可能なオブジェクトのみを追加します。
   • Draw は、検索パネルから設定および追加できる描画した形状内に存在するオブジェクトをマップに追加します。
   • Select は、アクティブなマップからアイテムを選択できます。
4. Historic search または Live feed を選択して、適切な時間枠を選択します。
5. Add to map を選択します。

ジオテンポラルシリーズ同期が Gaia の Map layers の一部として読み込まれると、たとえば特定の飛行経路などの個々のエンティティを選択して追加の設定を行うことができます。

関数を利用したエンタープライズマップレイヤーの使用

Foundryで作成しオントロジーに公開された関数を利用したエンタープライズマップレイヤー (EML) の一部として、データを Gaia マップに追加できます。

既存のオブジェクトタイプからオブジェクトセットを出力する TypeScript 関数 を作成して Gaia EML をサポートするには：

1. オブジェクトタイプの元データセットを含むプロジェクトフォルダーに移動します。
2. New > Code repository を選択します。
3. What are you building? の下にある Functions オプションを選択し、言語として TypeScript Functions を選択します。
4. リポジトリに名前を付け、公開プロジェクトフォルダーに保存して Foundry オントロジー API へのアクセスを有効にしてから、画面下部の Initialize repository を選択します。
5. 画面の右側にある緑色の Go to index.ts ボタンを選択して関数を書きます。
6. 下書きの index.ts ファイルに組み込まれたライティングプロンプトに従い、自分の関数を挿入します。以下の例コードを参照できます。

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
import { Function, Integer } from "@foundry/functions-api";
import { Objects, ObjectSet, ObjectTypeName };

// MyEmlFunctionクラスを定義
export class MyEmlFunction{

    // 関数デコレーターを使用して関数を定義
    @Function()
    public myFunctionName(): ObjectSet<ObjectTypeName> {
        // Objects.search()を使用してObjectTypeNameを検索し、
        // locationオブジェクトのpropertyTypeToSearchプロパティが
        // "match-parameter"と完全一致するものをフィルタリング
        return Objects.search().ObjectTypeName().filter(location => location.propertyTypeToSearch.exactMatch("match-parameter"));
    }
}

7. 上部のリボンから Commit を選択します。
8. Tag version を選択して、Foundry オントロジーに関数をリリースします。
9. Foundry オントロジーマネージャーの Functions タブで、新しく作成した関数を確認します。

次に、Gaia の管理アプリケーションを起動して、Foundry 関数を利用した EML を確立します。Gaia 管理アプリに移動したら、以下の操作を行います。

1. Enterprise Map Layers ページを検索して選択します。
2. ページ下部の Add を選択して新しい EML を作成します。
3. EML のタイプを Foundry function EML に設定します。
4. EML の Description を入力し、その Capabilities を示します。
5. 必要に応じて Tab icon を入力します。
6. EML の Classification を示します。
7. 必要に応じて、EML のアクセスを制限するために ACL Groups を追加します。
8. Function rid を挿入します。これは Foundry のオントロジーマネージャーアプリケーションの Function の Overview タブからクリップボードにコピーできます。
9. 必要に応じて、EML の Refresh interval (seconds) を設定します。空白のままにすると、EML は更新されません。
10. 必要に応じて、オブジェクトのジオフィルタリングを可能にするために Geo filter property id を挿入します。EML を参照データレイヤーとして追加する際に、オブジェクトタイプの geohash プロパティ ID を使用できます。

Foundry 関数を利用した EML を Gaia マップに追加するには、左側のパネルの Data sources タブで名前を検索します。Gaia は EML を Curated data sources の下にある Reference data layers としてグループ化します。

左側のパネルを使用するか、現在のビューからオブジェクトのアイコンを選択することで、EML の個々のオブジェクトを選択または非表示にできます。

バージョン管理されたオブジェクトセットを利用したエンタープライズマップレイヤーを使用

Foundry オントロジーのオブジェクトタイプから作成したバージョン管理されたオブジェクトセットを利用した EML の一部として、Gaia マップにデータを追加できます。

バージョン管理されたオブジェクトセットを作成するには、Drag and drop individual objects and saved explorations セクションの手順に従ってください。

Gaia 管理アプリケーションでバージョン管理されたオブジェクトセットを利用した EML を確立するには、Use a Function-backed Enterprise Map Layer セクションの手順に従います。EML のタイプを Foundry function EML の代わりに Versioned object set EML に設定します。Function rid を挿入する必要はありません。

バージョン管理されたオブジェクトセットを利用した EML を Gaia マップに追加するには、左側のパネルの Data sources タブで名前を検索します。Gaia は EML を Curated data sources の下にある Reference data layers としてグループ化します。