一般的なワークフローでは、IoT システムから外部データをリクエストするのではなく、組織の IoT インフラストクチャ内のデバイスからデータをプッシュします。 1 つの方法として、Web サーバーに対して HTTP POST リクエストを行います。 ArcGIS Velocity の HTTP 受信器フィードによって組み込みの HTTP エンドポイントが作成され、これをプログラムで使用することで、IoT デバイスやアプリケーションからのデータを HTTP POST リクエストを介して Velocity に送信できます。
例
以下は、HTTP 受信機フィードの使用例です。
- ある組織では、指定した Velocity HTTP エンドポイントに POST リクエストを使用してデータをプッシュするようにデバイスが構成されています。
- GIS アナリストは、フィーチャを処理する Python スクリプトを作成し、そのスクリプトが実行されるたびに、指定した Velocity HTTP エンドポイントに POST リクエストを使用してデータをプッシュします。
使用上の注意
HTTP 受信器フィードを操作する際には、以下の点に注意してください。
- HTTP POST リクエストはプレーン テキストとして送信します。
- HTTP 受信機フィードは、スキーマやキー フィールドなどをユーザーが構成します。 このフィードが作成されると、フィードの詳細ページの [HTTP エンドポイントのパス] の下で URL を利用できます。 これは HTTP POST リクエストを使用したデータのプッシュ先となる URL です。
- [認証タイプ] パラメーターを [ArcGIS] に使用して、オープン認証 (OAuth) 2.0 認証を使用します。 各受信メッセージにはフィードの所有者の有効なトークンが含まれていなければなりません。 有効なトークンがないメッセージは拒否されます。
- フィードの接続パラメーターを設定した後で、入力データの構成を参照して、スキーマとキー フィールドの定義方法について確認してください。
パラメーター
以下は、HTTP 受信器フィードのパラメーターです。
| パラメーター | 説明 | データ タイプ |
|---|---|---|
HTTP エンドポイントのパス | メッセージの送信に使用する完全な URL。 この URL は、フィードが開始された後で Velocity によって生成および設定されます。 | String |
認証タイプ | 受信メッセージの認証タイプを指定します。 オプションは [なし]、[ArcGIS]、および [基本] です。 [なし] を指定した場合、認証は実行されません。 [ArcGIS] を指定した場合、各受信メッセージにはフィードの所有者の有効なトークンが含まれていなければなりません。 有効なトークンがないメッセージは拒否されます。 トークンはリクエスト ヘッダーに Authorization: Bearer <your token> として含まれている必要があります。 | String |
その他のログ | 未処理の HTTP リクエストと Velocity が発行した応答のログ出力を有効にするかどうかを指定します。 注意:このパラメーターは、トラブルシューティングの目的でのみ有効にし、トラブルシューティングが完了したら無効にします。 有効にした後は、フィードを開始すると、デバッグ レベルのログがフィード ログ ページで使用できるようになります。 必要に応じて、Esri テクニカル サポート にお問い合わせください。 | Boolean |
Username | HTTP 受信機にアクセスするためのユーザー名を指定します。 このパラメーターは、[認証タイプ] 値が [基本] に設定されている場合に使用できます。 | String |
パスワード | HTTP 受信機にアクセスするためのパスワードを指定します。 このパラメーターは、[認証タイプ] 値が [基本] に設定されている場合に使用できます。 | String |
検討事項および制限事項
[ArcGIS] 認証タイプを使用した HTTP 受信器フィードは、書き込み権限とともに他のユーザーやグループと共有できます。 HTTP 受信器フィードが書き込み権限とともに共有された場合、共有されたユーザーおよびグループはフィードにデータを書き込むことができます。 他のユーザーおよびグループがフィードにデータを書き込むことを望まない場合は、フィードを書き込み権限付きで共有しないでください。 書き込み権限は、Velocity のフィード詳細ページで有効または無効にできます。