Skip To Content

外部 WebSocket を購読 (GeoJSON)

[外部 WebSocket を購読 (GeoJSON)] 入力コネクタは、GeoJSON として書式設定され、外部サーバーの WebSocket からブロードキャストされたイベント データを受信し、適合するために使用されます。 GeoJSON データ レコードの書式設定の詳細の例については、「GeoJSON の仕様」をご参照ください。

この入力コネクタはクライアントとして動作し、WebSocket がホストするサーバーに登録する必要があります。 サーバーとして動作し、クライアント アプリケーションによる入力への登録とデータ送信を許可する入力コネクタをお探しの場合は、[WebSocket 上の GeoJSON を受信] の使用をご検討ください。

使用上の注意

  • この入力コネクタを使用し、GeoJSON として書式設定されたデータを、外部サーバーがホストする WebSocket 経由で受信します。
  • この入力コネクタはクライアントとして動作し、サーバーのホスト WebSocket に登録して、サーバーがブロードキャストしたデータを受信します。
  • この入力コネクタは、GeoJSON インバウンド アダプターと WebSocket インバウンド トランスポートを組み合わせます。
  • GeoJSON フィーチャ レコードには、ジオメトリ メンバーとプロパティ メンバーの両方が含まれます。
  • アダプターは単一の 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 で参照用として使用される入力コネクタの記述名。

リモート サーバーの WebSocket の URI (クライアント モード)

プロトコル、ホスト名または IP アドレス、ポート、パスなど、完全な URL エンドポイント。 デフォルトは、[localhost] です。 このパラメーターを更新して、サーバーでホストされた WebSocket の URI を反映します。

ジオイベント定義の作成

インバウンド イベント データに新しいジオイベント定義を使用するか、既存のジオイベント定義を使用するかを指定します。 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 値に変換することができます。 これらの要件を次に示します。

  • "2019-12-31T23:59:59" – ISO 8601 標準形式
  • 1577836799000 – Java Date (紀元からの時間を示す Long 型整数、UTC)
  • "Tue Dec 31 23:59:59 -0000 2019" – 一般的な Web サービス文字列形式
  • "12/31/2019 11:59:59 PM" – 米国で使用される一般的な形式 (12 時間形式)
  • "12/31/2019 23:59:59" – 米国で使用される一般的な形式 (24 時間形式)

受信した日付/時間の値が、上記の 5 つ以外の形式で表される場合は、GeoEvent Server が日付/時間値を適合する方法を把握できるよう、[推定される日付形式] を指定する必要があります。


このトピックの内容
  1. 使用上の注意
  2. パラメーター