[フィーチャをストリーム サービスに送信] 出力コネクタは、イベント データをストリーム サービスの WebSocket を通じてフィーチャ JSON としてブロードキャストするために使用されます。 クライアント アプリケーションは、ストリーム サービスの WebSocket に登録してブロードキャスト中のフィーチャ レコードを受信することができます。
ストリーム サービスは、ArcGIS Server の REST Services Directory のコンテンツを参照する際に検出可能である点が、従来のマップ サービスやフィーチャ サービスと似ています。 ストリーム サービスとは、ArcGIS GeoEvent Server ライセンス ロールで ArcGIS Enterprise にリアルタイム機能が追加された場合にのみ使用できる ArcGIS Server サービスです。 ストリーム サービスでは、クライアント/サーバー ワークフローで低遅延のリアルタイム データ配信を重視しています。 ストリーム サービスと従来のマップ サービスやフィーチャ サービスとの主な相違点とは、ストリーム サービスは一般的にデータの持続性がない点です。 ストリーム サービスの [アーカイブ] 機能は、この点に対する例外です。 ストリーム サービスでは WebSocket 技術を利用して、クライアントとの双方向通信とデータ配信を行います。 クライアントは、ジオデータベースにポーリングしてデータを取得するのではなく、データをリアルタイムで受信するために、このサービスに登録します。
公開済みのストリーム サービスは、[フィーチャをストリーム サービスに送信] 出力コネクタが構成されており、GeoEvent Service に組み込まれていない限り、データの受信やブロードキャストは行いません。
ストリーム サービスの詳細については、「ストリーム サービス」をご参照ください。 「ストリーム サービスのチュートリアル」には、ストリーム サービスへの理解を深めるための演習もあります。 ストリーム サービス機能の動画については、Esri Community ブログ「Stream Services, Store Latest, and Related Features」をご参照ください。
使用上の注意
- この出力コネクタを使用し、イベント レコード データをフィーチャ JSON として書式設定し、ストリーム サービスの WebSocket を通じてフィーチャ レコードをブロードキャストします。
- この出力コネクタは、JSON アウトバウンド アダプターとストリーム サービス アウトバウンド トランスポートをペアにします。
- ストリーム サービスを使用するには、ライセンス付与された ArcGIS Server と ArcGIS GeoEvent Server が必要であり、ArcGIS GeoEvent Server サービスを実行する必要があります。
- ArcGIS Server の下では ArcGIS GeoEvent Server が動作しています。ArcGIS Server は ArcGIS Enterprise ポータルとフェデレートされていることがありますが、ストリーム サービスの利用は、ArcGIS Server がフェデレートされていない場合の方が簡単に行えます。
- サービス レイヤーを参照するには、[レイヤーの参照] オプションを使用するか、[レイヤー タイプへの参照] パラメーターの [サービス レイヤー URL] オプションを使用して URL を指定します。 どちらのオプションを使用する場合でも、登録済みデータ ストアへの接続を先に確立する必要があります。
- [ストリーム サービスの公開] は新しい出力を設定するときに使用できる機能で、GeoEvent Manager からストリーム サービスを直接公開することができます。
- ストリーム サービスを公開する場合は、GeoEvent Server に登録されたサーバー接続をデフォルト データ ストアとして使用する必要があります。
- ストリーム サービスを公開するには、ストリーム サービスに含めるフィールドがスキーマに反映された、既存のジオイベント定義が必要です。
- ストリーム サービスの基礎にある WebSocket は、ArcGIS Enterprise ではなく ArcGIS GeoEvent Server の一部として動作します。 デフォルト サーバー接続を使用してストリーム サービスを公開し、そのサーバー接続の URL が ArcGIS Enterprise ポータルのエンドポイントを反映している場合は、ArcGIS GeoEvent Server が動作するコンピューターへのストリーム サービスの公開は、サービス公開のメカニズムによって処理されます。 公開したサービスは、コンテンツ アイテムとして ArcGIS Enterprise ポータルに登録されます。
- ワークフローを分離するためのベスト プラクティスとして、ArcGIS GeoEvent Server が動作するコンピューターとは異なるサーバー コンピューターに ArcGIS Enterprise を配置することをお勧めしています。 GeoEvent Server のデフォルト サーバー接続は、ストリーム サービスを公開する正しいコンピューターを特定するための情報を保持しています。
パラメーター
| パラメーター | 説明 |
|---|---|
名前 | GeoEvent Manager で参照用として使用される出力コネクタの記述名。 |
登録済みのサーバー接続 | GeoEvent Server にデータ ストアとして登録された ArcGIS Server または ArcGIS Enterprise 接続。 注意:GeoEvent Server の [デフォルト] データ ストアとして登録されている ArcGIS Server または ArcGIS Enterprise 接続を、ストリーム サービスの公開時に使用することをお勧めします。 ストリーム サービスは、GeoEvent Server ロールのライセンスが付与された ArcGIS Server に公開する必要があります。 GeoEvent Server としてライセンス付与も構成もされていない ArcGIS Server には、ストリーム サービスを公開できません。 |
サービス タイプへの参照 | サービスを参照するときのオプションを指定します。
|
フォルダー (条件) | ArcGIS REST Services Directory で検出可能な ArcGIS Server サービス フォルダー。 現在のところ、ストリーム サービスは、ArcGIS Enterprise ポータル コンテンツのアイテム フォルダーには公開できません。 ArcGIS Enterprise ポータルとフェデレートした場合は、[Root] フォルダーにストリーム サービスを公開する必要があります。 [サービス タイプへの参照] パラメーターが [サービスの参照] に設定されている場合に表示され、[サービス URL] に設定されている場合は非表示になります。 |
ストリーム サービス名 (条件) | 処理済みのイベント データをフィーチャ レコードとして送信するストリーム サービスの名前。 [サービス タイプへの参照] パラメーターが [サービスの参照] に設定されている場合に表示され、[サービス URL] に設定されている場合は非表示になります。 |
サービス URL (条件) | ストリーム サービスへの URL。 注意:URL によってストリーム サービスを参照する場合、データ ストア接続が確立されていなければなりません。 ストリーム サービスは、パブリックにアクセス可能であるか、データ ストア接続を確立する認証情報を持つユーザーと共有されている必要があります。[サービス タイプへの参照] パラメーターが [サービス URL] に設定されている場合に表示され、[サービスの参照] に設定されている場合は非表示になります。 |
更新間隔 (秒) | 出力コネクタが処理済みのイベント レコードをフィーチャ レコードとして指定のストリーム サービスに送信し、処理済みのイベント レコードをキャッシュからフラッシュする間隔 (秒単位) を指定します。 デフォルトは [0.1] 秒です。つまり、処理済みイベント レコードのデータはキャッシュされ、キャッシュは毎秒 10 回フラッシュされます。 ストリーム サービスでは低遅延のリアルタイム データ配信に重点を置いているため、フィーチャ レコードとしてブロードキャストされるイベント レコードは、最小限の属性と簡易的なジオメトリで比較的シンプルにしておく必要があります。 |
フォーマット済 JSON | フィーチャ JSON 文字列を、空白インデントと改行のフォーマットで整形するかどうかを指定します。 この JSON は PJSON と呼ばれることもあり、通常は、テキスト エディターでコンテンツを確認するシステム ファイルに書き込む場合にのみ適しています。 デフォルトは [いいえ] です。
|
一意のトラック ID を設定 | イベント レコードのタグ付けされた TRACK_ID フィールドを、ストリーム サービスによってブロードキャストされるフィーチャ レコードを更新するための一意の ID として使用するかどうかを指定します。 デフォルトは [いいえ] です。 注意:このパラメーターは、現在は GeoEvent Server に実装されていないため、デフォルト設定である [いいえ] のままにしておく必要があります。次の「検討事項および制限事項」をご参照ください。 |
検討事項および制限事項
[一意のトラック ID を設定] パラメーターは、クライアント アプリケーションを登録するための情報を提供することを目的としています。これによって、クライアント アプリケーションの動作が、シンプルなフィーチャ レコード レシーバーから、フィーチャ レコードの更新を許可する動作に変わります。 このパラメーターが [いいえ] (デフォルト) に設定されている場合、ストリーム サービスのブロードキャストに登録するクライアントは、各フィーチャ レコードを新しい観測値として処理します。 全体的な動作は、フィーチャの追加ワークフローを模倣します。すなわち、各フィーチャ レコード ブロードキャストに対し、新しいフィーチャ レコードが表示されます。 [一意のトラック ID を設定] パラメーターを [はい] に設定すると、フィーチャ ワークフローの更新を模倣する動作に変わります。すなわち、新しいフィーチャ レコードがストリーム サービスによってブロードキャストされると、フィーチャ レコードの最後の位置と属性が更新されることがあります。
実際には、[一意のトラック ID を設定] パラメーターの設定は重要ではありません。 このパラメーター値を変更しても、JSON 仕様の公開ストリーム サービスは変わりません。 現在、ArcGIS Enterprise と ArcGIS Online の StreamLayer の Web マップ実装では、ストリーム サービスで指定された trackIdField を使用しています。これはサービスの timeInfo 仕様にあり、フィーチャ レコードのブロードキャストのたびにストリーム レイヤーが新しいフィーチャ レコードを表示するか、あるいは新しいフィーチャ レコードがブロードキャストされると以前に受信したフィーチャ レコードを更新するかを決定します。 ArcGIS API for JavaScript を使用して実装された Web マッピング アプリケーションでは、この動作を模倣するか、独自の動作を実装するかを選択できます。
[一意のトラック ID を設定] パラメーターを [いいえ] (デフォルト) に設定し、フィーチャの追加またはフィーチャの更新の動作を属性フィールドのタグ付けによって制御することをお勧めします。この属性フィールド値は、センサーまたはトラッキング可能なアセットを一意に識別するために使用されます。
属性フィールドに TRACK_ID とタグ付けしたジオイベント定義を使用してストリーム サービスを公開すると、クライアント アプリケーションは公開したサービスで指定された trackIdField から属性フィールドの名前を取得し、新しいフィーチャ レコードがブロードキャストされると、レイヤーのキャッシュやフィーチャの表示を更新します。 属性フィールドに TRACK_ID とタグ付けされていないジオイベント定義を使用してストリーム サービスを公開すると、公開したストリーム サービスの仕様には trackIdField 値が含まれません。そのため、クライアントでは、すべてのフィーチャ ブロードキャストを特定のセンサーやトラッキング可能なアセットに関連していない、一意の観測として処理することがデフォルトの動作になります。