Skip To Content

外部 Web サイトをポーリング (JSON)

[外部 Web サイトをポーリング (JSON)] 入力コネクタは、JSON として書式設定されたイベント データを外部 Web サイトから取得し、適合させるために使用されます。ArcGIS GeoEvent Server での一般的な JSON データ レコードの書式設定の例については、GeoNet ブログ記事「JSON Data Structures - Working with Hierarchy and Multicardinality」をご参照ください。

複数のイベント レコードがバッチで返される場合は、次に示すように、配列として整理する必要があります。JSON インバウンド アダプターは、各オブジェクトの配列を個別のイベント レコードとして処理します。

JSON 配列として整理されたイベント データ

使用上の注意

  • この入力コネクタを使用し、JSON として書式設定されたデータを持つ Web サーバーや Web サービスを検索して、処理対象のイベント データ レコードを作成できるよう適合します。
  • この入力コネクタは、JSON インバウンド アダプターと HTTP インバウンド トランスポートを組み合わせます。
  • このアダプターは、フィーチャ JSON や GeoJSON とは異なり、汎用 JSON を解釈します。
  • 汎用 JSON レコードには、ジオメトリを表すデータを含める必要はありません。
  • JSON 配列で整理した一般的なイベント データを、上に示します。
  • アダプターは、単一の JSON レコードと、配列に整理された JSON レコードの両方を処理します。
  • [HTTP メソッド] は、Web サービスでデータを検索するために使用する HTTP リクエストのタイプを指定します。デフォルトでは、[HTTP/GET] リクエストを使用します。
  • アダプターは、X、Y、Z 属性値からポイント ジオメトリを構築することができます。
  • [パラメーター] プロパティを使用してクエリ パラメーターを指定すると、対象データを特定できます。
  • HTTP/GET リクエストの一部としてクエリ パラメーターを指定することで、返されるアイテム数を絞り込むことができるようになるため、パフォーマンスを向上できます。
  • 指定したクエリ パラメーターの名前と値は、外部 Web サービスがサポートするリクエストによって異なります。
  • この入力コネクタでは、外部 Web サーバーや Web サービスで認証を要求せずに HTTP/GET リクエストを許可することを想定しています。認証を必要とする外部 Web サイトの場合、JSON インバウンド アダプターと基本、証明書、または OAuth 認証をサポートする HTTP インバウンドトランスポートを組み合わせるカスタム入力コネクタを作成することもご検討ください。
  • [新しいデータのみ受信] プロパティは、これまでに観測されていない、または新たに更新されたデータのみをフィードから返すようリクエストします。この機能では、データ フィードが HTTP リクエストへの応答のヘッダーに Last-Modified を 正しく組み込む必要があります。応答のヘッダーに、コンテンツの最終更新日/時刻が示されていない場合、GeoEvent Server は、応答のデータが新しいか、または最近更新されたデータであることを想定します。応答ヘッダーで Last-Modified を使用する方法について詳しくは、RFC 7232 HTTP 仕様をご参照ください。
  • この入力コネクタには [Learning Mode] が含まれます。Learning Mode は、入力コネクタが構築したジオイベント定義を修正できるようにする場合に便利です。このプロパティの目的とは、受信したイベント データが可変的なスキーマやデータ構造を持つことを一時的に許可することです。入力コネクタは、受信したデータ レコードのサンプルを使用して可変的なデータ構造について学習し、これまでに観測されなかった新しい属性フィールドを既存のジオイベント定義に付加します。

    ジオイベント定義のリアルタイム変更を許可すると、ジオイベント サービスのリアルタイム解析の設計に悪影響が及ぶことがあります。インバウンド イベント データでスキーマの不一致が予期される場合は、[Learning Mode] をできる限り短い時間にわたって使用し、インバウンド データで予期されるすべてのバリアントをサポートするジオイベント定義を生成することをお勧めします。その後 [Learning mode] をオフにし、自動生成されたジオイベント定義をコピーして、本番配置用に調整することができます。

パラメーター

パラメーター説明

名前

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

デフォルト空間参照

座標値が、想定されている WGS84 地理座標系システムの緯度と経度の値ではない属性フィールド値をもとにジオメトリを作成するか、受信したジオメトリ文字列に空間参照が含まれない場合に使用される空間参照の Well-Known ID (WKID)。WKID または Well-Known Text (WKT) を含む属性フィールドの WKT 値または名前が指定されることもあります。

URL

データを JSON としてホスティングする外部 Web サイトの基本 URL。GeoEvent Server は URL にポール リクエストを発行し、JSON データを取得します。

ジオイベント定義の作成

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

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

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

(条件)

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

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

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

(条件)

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

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

HTTP メソッド

GeoEvent Server がデータ フィードを提供する外部サーバーにポーリングするときに使用される HTTP リクエスト メソッド。デフォルトでは、[HTTP/GET] リクエストを使用します。

  • GETGeoEvent Server は GET リクエストを発行します。
  • POSTGeoEvent Server は POST リクエストを発行します。
  • PUTGeoEvent Server は PUT リクエストを発行します。

厳密的には、外部 Web サーバーや Web サービスでデータを検索する場合、ポーリング入力では常に HTTP/GET リクエストを使用する必要があります。このプロパティを変更して POST か PUT のいずれかを指定すると、その他のプロパティが表示されますが、この入力コネクタには関係ありません。

記事の差出人

記事の本文

記事の本文の MIME タイプ

POST パラメーター

(条件)

これらのプロパティは、[HTTP メソッド][Get] に設定されている場合に、デフォルトで非表示になります。

詳細については、下の「制限事項」をご参照ください。

デフォルト空間参照

座標値が、想定されている WGS84 地理座標系システムの緯度と経度の値ではない属性フィールド値をもとにジオメトリを作成するか、受信したジオメトリ文字列に空間参照が含まれない場合に使用される空間参照の Well-Known ID (WKID)。WKID または Well-Known Text (WKT) を含む属性フィールドの WKT 値または名前が指定されることもあります。

新しいデータのみ受信

アダプターが、データ フィード応答のヘッダーの Last-Modified 値を検索し、この値を使用して、受信済みだが更新はされていないデータの処理を回避するかどうかを指定します。プロパティの名前は誤解を招く可能性があります。フィードがコネクタのクエリへの応答に含めるデータは、常にトランスポートによって受信されます。ただし、[新しいデータのみ受信] を指定すると、トランスポートは最後のリクエストの日付/時間をキャッシュし、データ フィードからの応答にトランスポートのキャッシュ値よりも大きい Last-Modified 値が含まれる場合にのみ、受信したデータをアダプターにリレーします。

Last-Modified 値の指定はオプションです。実際には、応答に Last-Modified 値を含むデータ フィードはそれほど多くありません。このプロパティのデフォルトは [はい] ですが、Last-Modified 値が見つからない場合、応答に含まれるデータが新しいか更新済みであるかを判断するための日付/時間がないため、プロパティは基本的に無視されます。

  • はい - 新しいデータか更新されたデータを含む応答だけが、各ポーリング間隔に処理されます。
  • いいえ - 受信したすべてのデータが、各ポーリング間隔に処理されます。

応答ヘッダーの Last-Modified を使用する方法について詳しくは、RFC 7232 HTTP 仕様をご参照ください。

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

頻度 (秒)

外部 Web サーバーまたは Web サービスがデータのポーリングを受ける間隔 (秒単位)。デフォルトは [10] 秒です (つまり、10 秒ごとに 1 回のポール リクエストが行われます)。

ヘッダー パラメーターの名前:値リスト

外部 Web サーバーまたは Web サービスにポーリングしたときに、リクエストの HTTP ヘッダーに含まれるパラメーター。ヘッダー パラメーターは、名前:値ペア (コロンも含む) をカンマで区切って指定する必要があります。

フィールドからジオメトリを作成

入力コネクタが、属性として受信した座標値を使用してポイント ジオメトリを作成するかどうかを指定します。デフォルトは [いいえ] です。

  • はい - 指定したイベント属性の値を使用し、ポイント ジオメトリを作成します。
  • いいえ - ポイント ジオメトリは作成されません。属性フィールドには、ジオメトリとして解釈される値が含まれているか、イベント レコードが非空間である (ジオメトリがない) と想定されます。

X ジオメトリ フィールド

(条件)

ポイント位置の X 座標部 (水平、経度など) を含むインバウンド イベント データの属性フィールド。

このプロパティは、[フィールドからジオメトリを作成][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

Y ジオメトリ フィールド

(条件)

ポイント位置の Y 座標部 (垂直、緯度など) を含むインバウンド イベント データの属性フィールド。

このプロパティは、[フィールドからジオメトリを作成][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

Z ジオメトリ フィールド

(条件)

ポイント位置の Z 座標部 (深さ、高さなど) を含むインバウンド イベント データのフィールド名。空白のままにすると Z 値は省略され、2D ポイント ジオメトリが作成されます。

このプロパティは、[フィールドからジオメトリを作成][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

JSON オブジェクト名

受信した JSON データ内の下部構造のルート ノードとして使用される JSON 要素の名前。[JSON オブジェクト名] を使用して JSON 要素を名前で指定する場合、アダプターは、オブジェクト名が指定した要素名と一致する下部構造を検索します。特定された下部構造内のデータだけが考慮されます。この設定を空白のままにすると (デフォルト)、最上位の JSON オブジェクトが JSON 構造全体のルートとして使用されます。

パラメーター

基本 URL に付加するクエリ パラメーター (複数可) を指定します。クエリ パラメーターは各 Web サービスに固有であり、すべてのサービスによってサポートされているわけではありません。クエリ パラメーターがサポートされている場合は、対象データを特定します。このプロパティにはデフォルト値はありません。クエリ パラメーターは、通常、[URL] プロパティに組み込まれます。

URL プロキシの使用

GeoEvent Server が HTTP リクエストを行う際に URL プロキシを使用するかどうかを指定します。デフォルトは [いいえ] です。

  • はい - GeoEvent Server は、外部サービスの URL にクエリを送信するときに、指定したプロキシを使用します。
  • いいえ - GeoEvent Server は URL プロキシを使用しません。基本 URL には直接アクセスします。

URL プロキシ

(条件)

HTTP リクエストを実行する際に使用する URL プロキシ。このプロパティにはデフォルト値はありません。

このプロパティは、[URL プロキシの使用][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

推定される日付形式

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

使用できる MIME タイプ (クライアント モード)

(条件)

データ フィードへの応答を受信するときに、このコネクタが許可する MIME タイプを指定します。外部 Web サービスの応答は、GeoEvent Server に送信されるデータに対して実際の MIME タイプを指定します。このコネクタは、このプロパティのデフォルトである次の MIME タイプを理解します。

text/json,application/json

正式な MIME タイプの詳細については、Internet Assigned Numbers Authority (IANA) をご参照ください。ArcGIS Server が使用しない MIME タイプの詳細については、「ArcGIS Server で使用されていない MIME タイプ」をご参照ください。

このプロパティは、[HTTP メソッド][Get] に設定されている場合に表示され、[Post][Put] に設定されている場合は非表示になります。

HTTP タイムアウト (秒)

入力コネクタが、クエリを実行した外部 Web サービスからの応答を待機する最大時間 (秒単位) を指定します。値は 12147483 の整数である必要があります。デフォルト値は [30] 秒です (つまり、30 秒間応答がなければ HTTP リクエストはタイムアウトします)。

Learning Mode

[Learning Mode] を有効にするか無効にするかを指定します。Learning Mode が [はい] に設定されている場合、インバウンド アダプターが作成し、維持しているジオイベント定義に新しいフィールドが付加されます。

  • はい - Learning Mode が有効になります。ジオイベント定義は、異なるスキーマを持つイベント レコードの新規フィールドで更新されます。
  • いいえ - Learning Mode は有効になりません。ジオイベント定義は修正されません。

[Learning Mode] は、入力コネクタが構築したジオイベント定義を修正できるようにする場合に便利です。このプロパティの目的とは、受信したイベント データが可変的なスキーマやデータ構造を持つことを一時的に許可することです。入力コネクタは、受信したデータ レコードのサンプルを使用して可変的なデータ構造について学習し、これまでに観測されなかった新しい属性フィールドを既存のジオイベント定義に付加します。

制限事項

厳密的には、ポーリング入力では常に HTTPS/GET リクエストを使用する必要があります。これには Content-Body は含まれません。また、パラメーターについては、関連データを指定するために使用されるクエリ パラメーターを指定する必要があります。以下のプロパティは、外部 Web サーバーや Web サービスにデータを送信する出力コネクタにのみ該当します。[HTTP メソッド] プロパティ セットをデフォルトの [HTTP/GET] のままにしておくと、以下のプロパティは非表示になります。

パラメーター説明

記事の差出人

(条件)

このコネクタが HTTP/POST または HTTP/PUT リクエストを使用するかどうかを指定します。

  • コンテンツの本文 - HTTP リクエストは、リクエストのコンテンツの本文を使用してデータを送信します。
  • パラメーター - HTTP リクエストは、パラメーターを使用してデータを送信します。このコネクタは、パラメーターを前述の [URL] プロパティに付加します。

このプロパティは、[HTTP メソッド][Post][Put] に設定されている場合に表示され、[Get] に設定されている場合は非表示になります。

記事の本文

(条件)

HTTP/POST または HTTP/PUT リクエストの Content-Body に含めるデータを指定します。

このプロパティは、[記事の差出人][コンテンツの本文] に設定されている場合に表示され、[パラメーター] に設定されている場合は非表示になります。

記事の本文の MIME タイプ

(条件)

HTTP リクエストのコンテンツの本文に含まれるデータの MIME タイプを指定します。MIME タイプは、通常はタイプ/サブタイプで構成され、HTTP クライアント/サーバーが使用し、許可するインターネット メディア タイプを指定する際に使用されます。このプロパティにはデフォルト値はありません。

このプロパティは、[記事の差出人][コンテンツの本文] に設定されている場合に表示され、[パラメーター] に設定されている場合は非表示になります。

POST パラメーター

(条件)

HTTP リクエストの一部として含まれるパラメーターを指定します。[パラメーター] は、名前:値ペア (コロンも含む) をカンマで区切って指定する必要があります。このプロパティにはデフォルト値はありません。

このプロパティは、[記事の差出人][パラメーター] に設定されている場合に表示され、[コンテンツの本文] に設定されている場合は非表示になります。