データ接続と統合Foundry での地理空間データ地理時間系列地理時間系列をオントロジーと統合する

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

地理時系列をオントロジーと統合する

Gaia マップなどの Palantir アプリケーション内で分析と可視化に利用する地理時系列をオントロジーに設定するには、Pipeline Builder を使用して次の操作を行います。

オントロジーのデータを Gaia ではなく Foundry のマップに追加する場合は、時系列を使用して、地理空間オブジェクトまたは地理時系列オブジェクトに関連付けられたデータを表示し、分析します。詳しくはこちらの地理空間時系列のユースケースチュートリアルを参照してください。

エンロールメントや具体的なユースケースに基づき、地理時系列データをオントロジーにインデックス化するためにどの種類の統合を使用すべきかについて、さらに質問がある場合は、地理空間の FAQ ページを確認するか、Palantir サポートにお問い合わせください。

地理時系列同期の出力を地理時系列オブジェクトタイプへの参照として追加するには、以下の手順に沿って進めます。

Pipeline Builder で新しいパイプラインを作成する

  1. Pipeline Builder に移動し、緑色の新規作成ボタンを選択します。
  2. パイプラインに名前を付け、保存先のプロジェクトを選択します。
  3. ストリーミングパイプラインを選択してから、パイプラインの作成を選択します。地理時系列はバッチパイプラインにも対応していますが、ストリーミングを使用すると、追跡対象のエンティティをリアルタイムで更新できます。

地理時系列データセットをインポートして加工する

開始する前に、既存の地理時系列データモデリングのドキュメントを確認してください。地理時系列同期とオブジェクトタイプの元となるストリーミングデータセットを特定し、以下の手順に沿ってパイプラインに追加します。

ストリーミングデータセットには、少なくとも、特定のタイムスタンプにおける緯度と経度など、追跡対象のエンティティの時間経過に伴う移動を記録する列と、地理時系列同期をオブジェクトタイプに結合するための string 列を含める必要があります。時間とともに変化するデータを含む列はライブフィールドと呼ばれ、エンティティの名前など、変化しないデータを含む列は静的フィールドと呼ばれます。

  1. データをすでにプラットフォームに取り込んでいる場合は、Foundry データを追加を選択します。
  2. データを追加モーダルでファイルを検索し、+ アイコンを選択して各データセットをパイプラインに追加します。
  3. データを追加モーダルの右下にあるデータを追加を選択します。

パイプラインのグラフキャンバスに表示されたストリーミングデータセット。

地理時系列同期を作成する

Pipeline Builder での地理時系列同期の設定について詳しくはこちら。

必要なデータ加工は、ストリーミングデータセットを Foundry に取り込んだ時点での生データの状態によって異なります。以下に示すサンプルデータには、同期の主要フィールドにマッピングする次の列が含まれています。

  • Series_ID: 地理時系列同期をオブジェクトタイプに結合するために使用する string 列です。シリーズIDの設定について詳しくはこちら。
  • Timestamp: エンティティの位置が記録された時刻を含む timestamp 列です。
  • Geopoint: エンティティの緯度と経度のペアを含む geopoint 列です。

地理時系列同期の主要フィールドの表示。

データセットには、地理時系列同期のプロパティにマッピングされる追加の列が含まれていますが、Palantir のマップアプリケーションで同期を機能させるためにこれらの列は必須ではありません。

地理時系列同期内の追加プロパティの表示。

必要に応じて、Pipeline Builder の型変換と GeoPoint を作成のデータ加工を使用して、生のストリーミングデータセットを地理時系列同期として出力できるように準備します。

Pipeline Builder の「型変換」と「GeoPoint を作成」のデータ加工カードの表示。

加工したストリーミングデータから地理時系列同期の出力を作成するには、以下の手順に沿って進めます。

  1. ストリーミングデータセットまたはデータ加工ノードを選択すると、縦方向のメニューバーが表示されます。そこで金色の + アイコンを選択し、新規地理時間シリーズの同期出力を追加します。

  2. 名前とアイコンで同期の名前を入力し、必要に応じてデフォルトのアイコンを変更します。

  3. Foundry が同期を書き込む宛先名前空間を選択します。

  4. ストリーミングデータセットの該当する列を、同期の主要分野に割り当てます。

  5. 観測スキーマがすでに存在する場合は、同期に設定します。存在しない場合は、この項目を空のままにできます。Foundry は、同期にマッピングされたプロパティから新しいスキーマを生成します。観測スキーマについて詳しくはこちら。

  6. 必要に応じて、追加のプロパティの右側にあるライブアイコンを切り替え、1個以上のプロパティを静的に指定します。

    Foundry は、新しい観測ごとに、特定のタイムスタンプにおけるエンティティの速度などのライブプロパティ値を記録します。プロパティを静的に指定すると、Foundry はそのプロパティの最新の値を記録し、シリーズ内のすべての観測に適用します。

    プロパティパネルの「ライブ」にカーソルを合わせると表示される説明ツールチップ。

  7. 必要に応じて、同期のスタイルを設定し、下流でのレンダリングを制御します。デプロイ後は、Ontology Manager のジオメトリスタイルタブで、地理時系列オブジェクトタイプのデフォルトのトラックスタイルを編集することもできます。

  8. 必要に応じて、統合のストレージ設定を構成します。

  9. インターフェースを参照を選択してから地理時系列同期のプロパティをマッピングし、地理時系列オブジェクトタイプのプロパティを表すインターフェースを参照します。

地理時系列同期で地理時系列インターフェースを参照する様子。

ほとんどのユースケースに適した地理時系列インターフェースは、Palantir の Core Ontology からインストールできます。Ontology Manager でこのインターフェースにアクセスできない場合は、エンロールメントにインストールするために Palantir サポートにお問い合わせください。

  1. 保存を選択し、地理時系列同期を保存します。

地理時系列オブジェクトタイプを作成する

次に、地理時系列データセットを加工して、地理時系列参照(GTSR)を介して地理時系列同期にリンクされた地理時系列オブジェクトタイプを作成します。

  1. パイプライン内の地理時系列データセットを選択し、データ加工を選択して新しいデータ加工を挿入します。
  2. 式を適用を検索して選択します。
  3. 「列、式、または値」というラベルの入力項目を選択し、列からデータセットの主キー列を選択します。この例では、データセットの mmsi 列に、主キーとして使用できる一意の船舶識別子が含まれています。
  4. mmsi などのデータセットの一意の識別子をコピーした、Series_ID という名前の新しい列を作成します。この新しい列を使用して、地理時系列同期をオブジェクトタイプにリンクします。

Pipeline Builder の「式を適用」データ加工ブロックに、ある列の値を別の列にコピーする式が表示されています。

  1. 適用を選択してから、パイプラインの変更を保存し、データをプレビューします。

Pipeline Builder にデータセットのプレビューが表示されています。

地理時系列データセットを加工したら、以下の手順に沿って、Pipeline Builder のオントロジー出力を使用して地理時系列オブジェクトタイプを作成します。

  1. 作成したデータ加工ノードを選択すると、縦方向のメニューバーが表示されます。そこで金色の + アイコンを選択し、新規オブジェクトタイプ出力を追加します。

データ加工ノードからアクセスできる「出力を追加」メニューが表示されています。

  1. 名前とアイコンで同期の名前を入力し、必要に応じてデフォルトのアイコンを変更します。
  2. 表示されているプロパティの右側にある省略記号アイコンを選択して、主キーとタイトルのプロパティを設定します。

主キーとタイトルのプロパティが表示されています。

  1. Series_ID プロパティの横にあるリンクアイコンを選択し、地理時系列 > このパイプラインからを選択して、GTSR プロパティをオブジェクトタイプにマッピングします。Foundry から… を選択し、対応する地理時系列統合を選択することで、別のパイプラインの地理時系列同期を選択することもできます。

GTSR がオブジェクトタイプのプロパティにリンクされています。

オブジェクトタイプが持てる地理時系列参照プロパティは最大1個であり、地理時系列参照の配列にすることはできません。

  1. 画面の下部にあるインターフェースを実装を選択し、地理時系列同期が参照しているものと同じインターフェースを選択します。

地理時系列インターフェースのモーダルが表示されています。

  1. 次へを選択してインターフェースの必須プロパティを実装し、実装を選択して Pipeline Builder のオブジェクトタイプ作成ウィンドウに戻ってから、変更を保存します。

パイプラインをデプロイする

地理時系列同期を設定し、オブジェクトタイプとインターフェースを作成して、GTSR を介して両者のリンクを確立したら、以下の手順に沿ってパイプラインをデプロイします。

  1. パイプラインに加えた変更がすべて保存されていることを確認してください。

変更がすべて保存されているため、Pipeline Builder の「保存」ボタンが無効になっています。

  1. デプロイを選択すると、このパイプラインをデプロイパネルが表示されます。

「このパイプラインをデプロイ」パネルが表示されています。

  1. 必要に応じてデプロイ時にリプレイを選択し、指定した時点からパイプラインを再実行します。ストリームのサイズによっては、パイプラインのリプレイがデプロイ速度に影響する場合があります。Pipeline Builder のストリーミングパイプラインの追加オプションについて、詳しくはこちら。
  2. パイプラインをデプロイを選択します。

パイプラインがデプロイされ、オントロジーにオブジェクトタイプが作成されると、地図上でその観測を可視化できます。

パイプラインのデプロイ成功の通知が表示されています。

地理時系列データを可視化する

Gaia にアクセスできるのは、エンロールメントに Gotham が含まれている場合のみです。Gaia へのアクセスや、プラットフォーム内で利用可能な追加のドキュメントについてご質問がある場合は、Palantir サポートにお問い合わせください。

地理時系列がオントロジーと統合されると、関連するオブジェクトタイプを Gaia マップに追加できます。

Ontology Manager でオブジェクトタイプのタイプマッピングを行い、Gotham がそのオブジェクトタイプにアクセスし、Gaia のデータレイヤーとして表示できるようにします。

Pipeline Builder の高度な地理時系列機能を使用するには、エンロールメントに Map Rendering Service が含まれている場合でも、Gotham からオブジェクトタイプを発見可能にするために、タイプマッピングを行う必要があります。この要件は、エンティティの位置を地理時系列として追跡するユースケースにも適用されます。詳細については、オブジェクトタイプのタイプマッピングが必要な場合のガイダンスを確認してください。

オントロジーに接続された地理時系列レイヤーを通じて表示されている Foundry オブジェクトを選択し、マップの右下隅にあるボタンを選択して観測ログを開きます。ログには、オブジェクトタイプの元データとなる地理時系列統合に設定されているすべてのライブプロパティが一覧表示されます。ローリングウィンドウピッカーを使用して、観測をどの時点まで遡って読み込むかを制御します。各行には、観測の位置に移動するズーム先ボタンがあります。観測を選択すると、そのオブジェクトが過去の軌跡上の該当地点に移動します。新しい観測が利用可能になると、更新ボタンが表示されます。

Ontology Manager の地理時系列参照 (GTSR) プロパティ

Ontology Manager で GTSR プロパティタイプを直接設定することもできます。上記で作成した地理時系列同期を新しい Pipeline Builder パイプライン、または同じパイプラインで使用して、次の手順を実行します。

  1. 地理時系列同期の作成に使用したものと同じ地理時系列データセットをインポートするか、そのデータセットを使用します。
  2. パイプライン内の地理時系列データセットを選択し、トランスフォームを選択して新しいデータ加工を挿入します。
  3. 地理時系列参照を作成式を検索して選択します。

Pipeline Builder の地理時系列参照を作成する式を表示しています。

  1. シリーズIDには、地理時系列同期のシリーズIDとして選択したものと同じ列を選択します。
  2. 地理時系列統合 RID には、デプロイ済の地理時系列同期の RID を選択します。
  3. 適用を選択してから、パイプラインへの変更を保存し、データをプレビューします。
  4. データ加工を終了し、データ加工ノードを選択して縦並びのメニューバーを表示します。そこで金色の + アイコンを選択して、新規データセットの出力を追加します。
  5. 地理時系列の列を含むデータセットを使用してパイプラインをデプロイします。

Ontology Manager で、作成した新しいデータセットをデータソースとして使用し、新しいオブジェクトタイプを作成します。 対応する Geotemporal Series Reference プロパティタイプは、Pipeline Builder で作成した列から自動的に設定されるはずです。設定されない場合は、Geotemporal Series Reference タイプのプロパティタイプを追加するか、既存のプロパティタイプを編集できます。

Ontology Manager の地理時系列参照プロパティタイプの設定パネルを表示しています。

続行するには、正しい地理時系列同期の RID を設定する必要があります。また、このワークフローで地理時系列インターフェースを実装することを推奨します。

オブジェクトタイプに設定できる地理時系列参照プロパティは最大1個であり、地理時系列参照の配列にはできません。