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) の使用をご検討ください。
使用上の注意
WebSocket 上の GeoJSON を受信入力コネクタを使用する際には、以下の点に注意してください。
- この入力コネクタを使用し、GeoEvent Server でホストされている WebSocket 経由で、GeoJSON として書式設定されたデータを受信します。
- この入力コネクタは、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 を使用する必要があります。
パラメーター
WebSocket 上の GeoJSON を受信入力コネクタのパラメーターを次に示します。
パラメーター | 説明 |
---|---|
名前 | 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 を使用します (PS000123 ドメイン上のコンピューター esri.com の場合)。 |
ジオイベント定義の作成 | インバウンド イベント データに新しいジオイベント定義を使用するか、既存のジオイベント定義を使用するかを指定します。 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 が日付/時間値を適合する方法を把握できるよう、推定される日付形式パターンを指定する必要があります。 |