Skip To Content

REST エンドポイント上の GeoJSON を受信

REST エンドポイント上の GeoJSON を受信入力コネクタを使用すると、GeoJSON として書式設定されたイベント データを、ArcGIS GeoEvent Server でホストされている REST エンドポイントで受信して適合させることができます。 標準的な GeoEvent Server 構成の場合、データ プロバイダーは https://<machine_name>.<domain>:6143/geoevent/rest/receiver/name として書式設定されたエンドポイントに HTTP/POST 経由でデータを送信することを想定しておく必要があります。ここで、name は、構成済みの入力コネクタの名前を指します。

複数のデータ レコードを送信するクライアントは、以下に示すように、FeatureCollection としてデータ レコードを整理する必要があります。 GeoJSON インバウンド アダプターは、FeatureCollection の各フィーチャ レコードを個別のイベント データ レコードとして処理します。 以下に示す GeoJSON は、GeoEvent Service が処理するイベント データ レコードを 2 つ生成するよう適合されます。

GeoJSON データ レコードの書式設定の詳細の例については、「GeoJSON の仕様」をご参照ください。

2 つの GeoJSON フィーチャ レコードを持つ GeoJSON FeatureCollection

使用上の注意

REST エンドポイント上の GeoJSON を受信入力コネクタを使用する際には、以下の点に注意してください。

  • この入力コネクタを使用し、GeoJSON として書式設定されたデータを受信します。このデータは、GeoEvent Server がホストする REST エンドポイントに HTTP/POST で送信されます。
  • この入力コネクタは、GeoJSON インバウンド アダプターと HTTP インバウンド トランスポートを組み合わせます。
  • 一般的な GeoJSON FeatureCollection を上に示します。 この例のコレクションには 2 つの GeoJSON フィーチャ レコードが含まれます。
  • アダプターは単一の GeoJSON フィーチャ レコードと、GeoJSON FeatureCollection レコードの両方を処理します。
  • フィーチャ JSON と同様、GeoJSON は汎用 JSON のサブタイプです。 これらの特有の形式を処理するには、異なる GeoEvent Server アダプターが使用されます。
  • GeoJSON データ レコードの書式設定の詳細と例については、「GeoJSON の仕様」をご参照ください。
  • REST エンドポイント上の GeoJSON を受信入力コネクタを新しく構成して保存すると、GeoEvent Server でホストされる REST エンドポイントが作成されます。
  • 入力コネクタを保存した後で編集すると、GeoEvent Server でホストされている REST エンドポイントへの完全修飾パスを復元できます。
  • GeoEvent Server は、REST レシーバーに対して異なる基本 URL を使用し、6143 以外のポートを経由して接続するように構成できます。
  • データ プロバイダーは、送信するデータに関連付けられた MIME タイプを HTTP/POST のヘッダーに含める必要があります。
  • 入力を構成する場合は、トランスポートが許可する MIME タイプを指定する必要があります。
  • この入力コネクタでは、クライアントとサーバー間での JSON の送受信に使用されるデフォルトの MIME タイプである application/json を想定しています。
  • 有効な GeoJSON フィーチャ レコードには、ジオメトリとプロパティの両方が含まれます。 この入力コネクタは、プロパティ値として受信した座標値からジオメトリを構築するためには使用できません。 すべての GeoJSON フィーチャ レコードは、座標値が度 (10 進) 単位の経度と緯度で表される World Geodetic System 1984 (WGS84) 測地基準系を使用します。 このコネクタを使用する場合は、デフォルトの空間参照を指定しないでください。

パラメーター

REST エンドポイント上の GeoJSON を受信入力コネクタのパラメーターを次に示します。

パラメーター説明

名前

GeoEvent Manager で参照用として使用される入力コネクタの記述名。

ジオイベント定義の作成

インバウンド イベント データに新しいジオイベント定義を使用するか、既存のジオイベント定義を使用するかを指定します。 GeoEvent Server がインバウンド データ属性フィールドおよびデータ タイプを理解するには、ジオイベント定義が必要です。

  • [はい] – 最初に受信したイベント レコードのスキーマに基づき、新しいジオイベント定義が作成されます。
  • [いいえ] – 新しいジオイベント定義は作成されません。 インバウンド イベント データのスキーマに一致する、既存のジオイベント定義が選択されます。

ジオイベント定義名 (新規)

(条件)

新しいジオイベント定義に与えられる名前。 指定した名前を持つジオイベント定義がすでに存在する場合、既存のジオイベント定義が使用されます。 最初に受信したデータ レコードを使用し、後続のデータ レコードで予期されるスキーマを決定します。新しいジオイベント定義は、最初のデータ レコードのスキーマに基づいて作成されます。

このパラメーターは、[ジオイベント定義の作成][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

ジオイベント定義名 (既存)

(条件)

受信したデータを適合して、GeoEvent Service によって処理されるイベント データを作成する際に使用する、既存のジオイベント定義の名前。

このパラメーターは、[ジオイベント定義の作成][いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。

デフォルト空間参照

ジオメトリの座標が表される空間参照系の Well-Known ID (WKID) または Well-Known Text (WKT)。 このパラメーターにはデフォルト値がありません。

使用できる 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 タイプ」をご参照ください。

推定される日付形式

日付時間値として予期される文字列表現を一致させ、それを 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 が日付/時間値を適合する方法を把握できるよう、推定される日付形式パターンを指定する必要があります。

未加工データのパラメーター名

インバウンド HTTP/GET リクエストに対して未加工データを指定する値を含むクエリ パラメーターの名前。 クエリ パラメーターの値は、GeoJSON フィーチャまたは GeoJSON FeatureCollection として書式設定された、単一の文字列である必要があります。


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