外部 Web サイトをポーリング (GeoJSON) 入力コネクタを使用すると、GeoJSON として書式設定されたイベント データを外部 Web サイトから取得して適合させることができます。 GeoJSON データ レコードの書式設定の詳細と例については、「GeoJSON の仕様」をご参照ください。
Web サーバーや Web サービスから複数のイベント データ レコードが返される場合は、次に示すように、FeatureCollection として整理する必要があります。 GeoJSON インバウンド アダプターは、FeatureCollection の各フィーチャ レコードを、個別のイベント データ レコードとして処理します。
使用上の注意
外部 Web サイトをポーリング (GeoJSON) 入力コネクタを使用する際には、以下の点に注意してください。
- この入力コネクタを使用し、GeoJSON として書式設定されたデータを Web サーバーや Web サーバーで検索して、処理対象のイベント レコードを作成できるよう適合します。
- この入力コネクタは、GeoJSON インバウンド アダプターと HTTP インバウンド トランスポートを組み合わせます。
- GeoJSON フィーチャ レコードには、ジオメトリ メンバーとプロパティ メンバーの両方が含まれます。
- 上の図には、GeoJSON FeatureCollection の一部として整理された標準的なイベント レコードが示されています。
- アダプターは単一の GeoJSON フィーチャ レコードと GeoJSON FeatureCollection レコードの両方を処理します。
- フィーチャ JSON と同様、GeoJSON は汎用 JSON のサブタイプです。 これらの特有の形式を処理するために、さまざまな GeoEvent Server アダプターが使用されます。
- GeoJSON データ レコードの書式設定の詳細と例については、「GeoJSON の仕様」をご参照ください。
- アダプターは [フィールドからジオメトリを作成] 機能をサポートしていません。
- [HTTP メソッド] パラメーターには、Web サービスでデータを検索するために使用する HTTP リクエストのタイプを指定します。 デフォルトでは、[HTTP/GET] リクエストを使用します。
- [パラメーター] パラメーターを使用してクエリ パラメーターを指定すると、対象データを選択できます。
- HTTP/GET リクエストの一部としてクエリ パラメーターを指定することで、返されるアイテム数を絞り込むことができるようになるため、パフォーマンスを向上できます。
- 指定したクエリ パラメーターの名前と値は、外部 Web サービスでサポートされているリクエストによって異なります。
- この入力コネクタでは、外部 Web サーバーや Web サービスで認証を要求せずに HTTP/GET リクエストを許可することを想定しています。 認証を必要とする外部 Web サイトの場合は、JSON インバウンド アダプターと HTTP インバウンド トランスポートをペアにするカスタム入力コネクタを作成して、基本認証、証明書認証、または OAuth 認証に対応できるようにすることを検討してください。
- [新しいデータのみ受信] パラメーターを使用すると、まだ観測されていないデータまたは最近更新されたデータだけがフィードから返されるようにリクエストできます。 この機能では、データ フィードが HTTP リクエストへの応答のヘッダーに Last-Modified を正しく組み込む必要があります。 応答のヘッダーにコンテンツの最終更新日時が示されていない場合、GeoEvent Server は、応答に含まれるデータが新しいデータまたは最近更新されたデータであると想定します。 応答ヘッダーで Last-Modified を使用する方法について詳しくは、RFC 7232 HTTP 仕様をご参照ください。
パラメーター
外部 Web サイトをポーリング (GeoJSON) 入力コネクタのパラメーターを次に示します。
| パラメーター | 説明 |
|---|---|
名前 | GeoEvent Manager で参照用として使用される入力コネクタの記述名。 |
URL | データを GeoJSON としてホスティングする外部 Web サイトの基本 URL。 GeoEvent Server は URL にポール リクエストを発行し、GeoJSON データを取得します。 |
ジオイベント定義の作成 | インバウンド イベント データに新しいジオイベント定義を使用するか、既存のジオイベント定義を使用するかを指定します。 GeoEvent Server がインバウンド データ属性フィールドおよびデータ タイプを理解するには、ジオイベント定義が必要です。
|
ジオイベント定義名 (新規) (条件) | 新しいジオイベント定義に与えられる名前。 指定した名前を持つジオイベント定義がすでに存在する場合、既存のジオイベント定義が使用されます。 最初に受信したデータ レコードを使用し、後続のデータ レコードで予期されるスキーマを決定します。新しいジオイベント定義は、最初のデータ レコードのスキーマに基づいて作成されます。 このパラメーターは、[ジオイベント定義の作成] が [はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。 |
ジオイベント定義名 (既存) (条件) | 受信したデータを適合して、GeoEvent Service によって処理されるイベント データを作成する際に使用する、既存のジオイベント定義の名前。 このパラメーターは、[ジオイベント定義の作成] が [いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。 |
HTTP メソッド | GeoEvent Server がデータ フィードを提供する外部サーバーにポーリングするときに使用される HTTP リクエスト メソッド。 デフォルトでは、[HTTP/GET] リクエストを使用します。
|
Post From Post Body 記事の本文の MIME タイプ POST Parameters (条件) | これらのパラメーターは、[HTTP メソッド] が [Get] に設定されている場合に、デフォルトで非表示になります。 詳細については、下の「制限事項」をご参照ください。 |
デフォルト空間参照 | ジオメトリの座標が表される空間参照系の Well-Known ID (WKID) または Well-Known Text (WKT)。 このパラメーターにはデフォルト値がありません。 これは非推奨のパラメーターです。 GeoJSON 仕様によると、すべての座標は World Geodetic System 1984 (WGS 84) のデータ (10 進経緯度単位の経度と緯度) を使用する、地理座標参照系で表す必要があります。 |
新しいデータのみ受信 | アダプターが、データ フィード応答のヘッダーの Last-Modified 値を検索し、この値を使用して、受信済みだが更新はされていないデータの処理を回避するかどうかを指定します。 パラメーターの名前は誤解を招く可能性があります。 フィードがコネクタのクエリへの応答に含めるデータは、常にトランスポートによって受信されます。 ただし、[新しいデータのみ受信] を指定すると、トランスポートは最後のリクエストの日付/時間をキャッシュし、データ フィードからの応答にトランスポートのキャッシュ値よりも大きい Last-Modified 値が含まれる場合にのみ、受信したデータをアダプターにリレーします。 Last-Modified 値の指定はオプションです。 実際には、応答に Last-Modified 値を含むデータ フィードはそれほど多くありません。 このパラメーターのデフォルトは [はい] ですが、Last-Modified 値が見つからない場合、応答に含まれるデータが新しいか更新済みであるかを判断するための日付/時間がないため、このパラメーターは無視されます。
応答ヘッダーの Last-Modified を使用する方法について詳しくは、RFC 7232 HTTP 仕様をご参照ください。 |
頻度 (秒) | 外部 Web サーバーまたは Web サービスがデータのポーリングを受ける間隔 (秒単位)。 デフォルトは [10] 秒です (つまり、10 秒ごとに 1 回のポール リクエストが行われます)。 |
ヘッダー パラメーターの名前:値のリスト | 外部 Web サーバーまたは Web サービスにポーリングしたときに、リクエストの HTTP ヘッダーに含まれるパラメーター。 ヘッダー パラメーターは、名前:値ペア (コロンも含む) をカンマで区切って指定する必要があります。 |
パラメーター | ベースの URL に付加するクエリ パラメーター (複数可) を指定します。 クエリ パラメーターは各 Web サービスに固有であり、すべてのサービスによってサポートされているわけではありません。 クエリ パラメーターがサポートされている場合は、対象データを特定します。 このパラメーターにはデフォルト値がありません。 クエリ パラメーターは、通常、[URL] パラメーターに組み込まれます。 |
URL プロキシの使用 | GeoEvent Server が HTTP リクエストを行う際に URL プロキシを使用するかどうかを指定します。 デフォルトは [いいえ] です。
|
URL プロキシ (条件) | HTTP リクエストを実行する際に使用する URL プロキシ。 このパラメーターは、[URL プロキシの使用] が [はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。 |
推定される日付形式 | 日付時間値として予期される文字列表現を一致させ、それを Java Date 値に変換するために使用されるパターン。 パターンの形式は、Java SimpleDateFormat クラス変換に従います。 GeoEvent Server では、日付/時間値を ISO 8601 標準で表すことを推奨していますが、日付値として一般的に認識されている日付/時間値の文字列表現のいくつかは、[推定される日付形式] パターンを指定しなくても Java Date 値に変換することができます。 次に例を示します。
受信した日付/時間の値が、上記の 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 サービスからの応答を待機する最大時間 (秒単位) を指定します。 値は 1 ～ 2147483 の整数である必要があります。 デフォルト値は [30] 秒です (つまり、30 秒間応答がなければ HTTP リクエストはタイムアウトします)。 |
検討事項および制限事項
ポーリング入力では、HTTP/GET リクエストを常に使用します。これには Content-Body が含まれません。また、対象のデータを指定するために、クエリ パラメーターを使用します。 次のパラメーターは、外部の Web サーバーまたは Web サービスにデータを送信する出力コネクタにのみ適用されます。 [HTTP メソッド] パラメーターが [HTTP/GET] (デフォルト) に設定されていて、次のパラメーターが非表示になっていることを確認します。
| パラメーター | 説明 |
|---|---|
Post From (条件) | このコネクタが HTTP/POST または HTTP/PUT リクエストを使用するかどうかを指定します。
このパラメーターは、[HTTP メソッド] が [Post] か [Put] に設定されている場合に表示され、[Get] に設定されている場合は非表示になります。 |
Post Body (条件) | HTTP/POST または HTTP/PUT リクエストの Content-Body に含めるデータを指定します。 このパラメーターは、[記事の差出人] が [コンテンツの本文] に設定されている場合に表示され、[パラメーター] に設定されている場合は非表示になります。 |
記事の本文の MIME タイプ (条件) | HTTP リクエストのコンテンツの本文に含まれるデータの MIME タイプを指定します。 MIME タイプは、通常はタイプ/サブタイプで構成され、HTTP クライアント/サーバーが使用し、許可するインターネット メディア タイプを指定する際に使用されます。 このパラメーターは、[記事の差出人] が [コンテンツの本文] に設定されている場合に表示され、[パラメーター] に設定されている場合は非表示になります。 |
POST Parameters (条件) | HTTP リクエストの一部として含まれるパラメーターを指定します。 [パラメーター] は、名前:値ペア (コロンも含む) をカンマで区切って指定する必要があります。 このパラメーターにはデフォルト値がありません。 このパラメーターは、[記事の差出人] が [パラメーター] に設定されている場合に表示され、[コンテンツの本文] に設定されている場合は非表示になります。 |