Skip To Content

WebSocket 上の GeoJSON を受信

[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 FeatureCollection の一部として整理されたイベント データ

使用上の注意

  • この入力コネクタを使用し、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/pathwss://<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 値に変換することができます。これらの要件を次に示します。

  • "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. パラメーター