REST エンドポイントでフィーチャを受信入力コネクタを使用すると、フィーチャ JSON として書式設定されたイベント データを、ArcGIS GeoEvent Server でホストされている REST エンドポイントで受信して適合させることができます。 標準的な GeoEvent Server 構成の場合、データ プロバイダーは https://<machine_name>.<domain>:6143/geoevent/rest/receiver/name として書式設定されたエンドポイントに HTTP/POST 経由でデータを送信することを想定しておく必要があります。ここで、name は、構成済みの入力コネクタの名前を指します。
使用上の注意
REST エンドポイントでフィーチャを受信入力コネクタを使用する際には、以下の点に注意してください。
- このコネクタを使用して、属性とジオメトリを含めるように書式設定されたデータを受信します。「ジオメトリ オブジェクト」をご参照ください。
- この入力コネクタは、フィーチャ JSON インバウンド アダプターと HTTP インバウンド トランスポートを組み合わせます。
- 一般的なフィーチャ JSON の例を上に示します。 この例では、ポイント ジオメトリを持つ 2 つのフィーチャ レコードを配列として整理します。
- アダプターは、配列の各オブジェクトを個別のイベント レコードとして処理します。
- GeoJSON と同様、フィーチャ JSON も汎用 JSON のサブタイプです。 これらの特有の形式を処理するには、異なる GeoEvent Server アダプターが使用されます。
- このアダプターは、ポイント、マルチポイント、ポリライン、ポリゴンのフィーチャを適合することができます。 フィーチャ セットやフィーチャ コレクションは処理しません。
- REST エンドポイントでフィーチャを受信入力コネクタを新しく構成して保存すると、GeoEvent Server でホストされる REST エンドポイントが作成されます。
- データ プロバイダーは、GeoEvent Server がホストする REST エンドポイントに HTTP/POST リクエストの一部としてフィーチャ JSON を送信します。
- 入力コネクタを保存した後で編集すると、GeoEvent Server でホストされている REST エンドポイントへの完全修飾パスを復元できます。
- GeoEvent Server は、REST レシーバーに対して異なる基本 URL を使用するか、6143 以外のポートを経由して接続するように構成できます。
- データ プロバイダーは、送信データに関連する MIME タイプを HTTP/POST のヘッダーに含める必要があります。
- 入力を構成する場合は、トランスポートが許可する MIME タイプを指定する必要があります。
- このコネクタでは、クライアントとサーバー間での JSON の送受信に使用されるデフォルトの MIME タイプである application/json を想定しています。
- 一般的に、フィーチャ JSON では、ジオメトリを構築する座標値ではなく、ジオメトリを含むことを想定しています。
- この入力コネクタは、属性値として受信した座標値からジオメトリを構築しません。
- フィーチャ JSON として書式設定したデータには空間参照を含める必要があります。 このコネクタを使用する場合は、[デフォルト空間参照] パラメーターを指定しないでください。
- トランスポートは、HTTP/GET リクエストと HTTP/POST リクエストの両方を許可します。 通常、データ プロバイダーは HTTP/POST リクエストを行って GeoEvent Server にイベント データを送信します。このとき、リクエスト本文にフィーチャ JSON を含め、クエリ パラメーターは使用しません。 ただし、この入力コネクタは、HTTP/GET リクエストの URL で指定されたクエリ パラメーターの値として含まれるフィーチャ JSON を抽出することもできます。 この機能を利用するには、[未加工データのパラメーター名] パラメーターを使用します。
パラメーター
REST エンドポイントでフィーチャを受信入力コネクタのパラメーターを次に示します。
パラメーター | 説明 |
---|---|
名前 | GeoEvent Manager で参照用として使用される入力コネクタの記述名。 |
ジオイベント定義の作成 | インバウンド イベント データに新しいジオイベント定義を使用するか、既存のジオイベント定義を使用するかを指定します。 GeoEvent Server がインバウンド データ属性フィールドおよびデータ タイプを理解するには、ジオイベント定義が必要です。
|
ジオイベント定義名 (新規) (条件) | 新しいジオイベント定義に与えられる名前。 指定した名前を持つジオイベント定義がすでに存在する場合、既存のジオイベント定義が使用されます。 最初に受信したデータ レコードを使用し、後続のデータ レコードで予期されるスキーマを決定します。新しいジオイベント定義は、最初のデータ レコードのスキーマに基づいて作成されます。 このパラメーターは、[ジオイベント定義の作成] が [はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。 |
ジオイベント定義名 (既存) (条件) | 受信したデータを適合して、GeoEvent Service によって処理されるイベント データを作成する際に使用する、既存のジオイベント定義の名前。 このパラメーターは、[ジオイベント定義の作成] が [いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。 |
推定される日付形式 | 日付時間値として予期される文字列表現を一致させ、それを Java Date 値に変換するために使用されるパターン。 パターンの形式は、Java SimpleDateFormat クラス変換に従います。 GeoEvent Server では、日付/時間値を ISO 8601 標準で表すことを推奨していますが、日付値として一般的に認識されている日付/時間値の文字列表現のいくつかは、[推定される日付形式] パターンを指定しなくても Java Date 値に変換することができます。 次に例を示します。
受信した日付/時間の値が、上記の 5 つ以外の形式で表される場合は、GeoEvent Server が日付/時間値を適合する方法を把握できるよう、推定される日付形式パターンを指定する必要があります。 |
使用できる MIME タイプ (サーバー モード) | 入力コネクタが許可する MIME タイプを指定します。 カンマを使用して値を区切ります (例: text/plain,application/xml,text/xml)。 MIME タイプは、通常はタイプ/サブタイプで構成され、サーバーがクライアントから受け取るデータのインターネット メディア タイプを指定する際に使用されます。 デフォルトでは、クライアントとサーバー間の JSON 送受信の正式 MIME タイプである [application/json] です。 正式な MIME タイプの詳細については、Internet Assigned Numbers Authority (IANA) をご参照ください。 ArcGIS Server が使用しない MIME タイプの詳細については、「ArcGIS Server で使用されていない MIME タイプ」をご参照ください。 |
デフォルト空間参照 | 座標値が、想定されている WGS84 地理座標系システムの緯度と経度の値ではない属性フィールド値をもとにジオメトリを作成するか、受信したジオメトリ文字列に空間参照が含まれない場合に使用される空間参照の Well-Known ID (WKID)。 WKID または Well-Known Text (WKT) を含む属性フィールドの WKT 値または名前が指定されることもあります。 |
未加工データのパラメーター名 | インバウンド HTTP/GET リクエストに対して未加工データを指定する値を含むクエリ パラメーターの名前。 クエリ パラメーターの値は、一般的な JSON として書式設定された、単一の文字列である必要があります。 |