[WebSocket 上の GeoJSON を受信] 入力コネクタは、GeoJSON として書式設定したイベント データを、ArcGIS GeoEvent Server でホストされる WebSocket で受信し、適合するために使用されます。標準的な GeoEvent Server 構成では、クライアントは wss://<machine_name>.<domain>:6143/path として書式設定されたエンドポイントを登録し、データを送信することを想定する必要があります。ここで path とは、[URL パス] で指定された値です。
Web サーバーや Web サービスから複数のイベント データ レコードが返される場合は、次に示すように、FeatureCollection として整理する必要があります。GeoJSON インバウンド アダプターは、FeatureCollection の各フィーチャ レコードを、個別のイベント データ レコードとして処理します。
GeoJSON データ レコードの書式設定の詳細の例については、「GeoJSON の仕様」をご参照ください。
この入力コネクタは、クライアント アプリケーションが GeoEvent Server に登録し、データを送信できるよう、サーバーとして実行します。クライアントとして動作し、サーバーの WebSocket からブロードキャストされたデータを受信するよう登録する入力コネクタをお探しの場合は、外部 WebSocket を購読 (GeoJSON) の使用をご検討ください。
使用上の注意
- この入力コネクタを使用し、GeoJSON として書式設定されたデータを、GeoEvent Server がホストする WebSocket 経由で受信します。
- この入力コネクタは、GeoJSON インバウンド アダプターと WebSocket インバウンド トランスポートをペアにします。
- GeoJSON フィーチャ レコードには、ジオメトリ メンバーとプロパティ メンバーの両方が含まれます。
- GeoJSON FeatureCollection の一部として整理された通常のイベント データを、上の図に示します。
- アダプターは単一の GeoJSON フィーチャ レコードと、GeoJSON FeatureCollection レコードの両方を処理します。
- フィーチャ JSON と同様、GeoJSON は汎用 JSON のサブタイプです。これらの特有の形式を処理するには、異なる GeoEvent Server アダプターが使用されます。
- GeoJSON データ レコードの書式設定の詳細と例については、「GeoJSON の仕様」をご参照ください。
- アダプターは [フィールドからジオメトリを作成] 機能をサポートしていません。
- このコネクタは、WebSocket (ws) プロトコルと WebSocket Secure (wss) プロトコルの両方をサポートしています。
- WebSocket エンドポイントにデータを送信するクライアントは、ws://<machine_name>.<domain>:6180/path を使用する必要があります。
- WebSocket Secure エンドポイントにデータを送信するクライアントは、wss://<machine_name>.<domain>:6143/path を使用する必要があります。
パラメーター
| パラメーター | 説明 |
|---|---|
名前 | GeoEvent Manager で参照用として使用される入力コネクタの記述名。 |
URL パス | 完全な URL エンドポイントには、プロトコル、ホスト名または IP アドレス、ポートとパスが含まれます。このコネクタでは、URL のパスだけが指定されることを想定しています。デフォルトは [/ws] です。 登録には完全な URL が使用され、ws://<machine_name>.<domain>:6180/path や wss://<machine_name>.<domain>:6143/path のようになります。 たとえば、[URL パス] が「/SampleRecords」と指定される場合、WebSocket Secure URL にデータを送信するクライアントは wss://PS000123.esri.com:6143/SampleRecords を使用します (esri.com ドメイン上のコンピューター PS000123 の場合)。 |
ジオイベント定義の作成 | インバウンド イベント データに新しいジオイベント定義を使用するか、既存のジオイベント定義を使用するかを指定します。GeoEvent Server がインバウンド データ属性フィールドおよびデータ タイプを理解するには、ジオイベント定義が必要です。
|
ジオイベント定義名 (新規) (条件) | 新しいジオイベント定義に与えられる名前。指定した名前を持つジオイベント定義がすでに存在する場合、既存のジオイベント定義が使用されます。最初に受信したデータ レコードを使用し、後続のデータ レコードで予期されるスキーマを決定します。新しいジオイベント定義は、最初のデータ レコードのスキーマに基づいて作成されます。 このプロパティは、[ジオイベント定義の作成] が [はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。 |
ジオイベント定義名 (既存) (条件) | 受信したデータを適合して、GeoEvent Service によって処理されるイベント データを作成する際に使用する、既存のジオイベント定義の名前。 このプロパティは、[ジオイベント定義の作成] が [いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。 |
デフォルト空間参照 | ジオメトリの座標が表される空間参照系の Well-Known ID (WKID) または Well-Known Text (WKT)。このプロパティにはデフォルト値はありません。 このプロパティはサポートされていません。GeoJSON 仕様によると、すべての座標は World Geodetic System 1984 (WGS 84) のデータ (10 進経緯度単位の経度と緯度) を使用する、地理座標参照系で表す必要があります。 |
推定される日付形式 | 日付時間値として予期される文字列表現を一致させ、それを Java Date 値に変換するために使用されるパターン。パターンの形式は、Java SimpleDateFormat クラス変換に従います。このプロパティにはデフォルト値はありません。 GeoEvent Server では、日付/時間値を ISO 8601 標準で表すことを推奨していますが、日付値として一般的に認識されている日付/時間値の文字列表現のいくつかは、[推定される日付形式] パターンを指定しなくても Java Date 値に変換することができます。これらの要件を次に示します。
受信した日付/時間の値が、上記の 5 つ以外の形式で表される場合は、GeoEvent Server が日付/時間値を適合する方法を把握できるよう、[推定される日付形式] を指定する必要があります。 |