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

使用上の注意

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

パラメーター

パラメーター説明

名前

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