gRPC

ArcGIS Velocity の gRPC フィード タイプは、gRPC クライアントやアプリケーションからのデータを、プログラムを使用して、不連続のリクエストまたは連続したストリームで Velocity に送信する際に使用できる、ビルトインの gRPC パス エンドポイントを作成します。gRPC は、分散アプリケーションおよびサービスの接続に使用される、オープンソースのリモート プロシージャ呼び出しフレームワークです。

以下は、gRPC フィードの使用例です。

  • ある GIS ワークショップでは、Python を使用したカスタム gRPC クライアントを実装し、gRPC フィードを使用して構造化データを Velocity に送信しています。
  • 異なる言語で作成された複数のデータ収集アプリケーションを保有する組織が、そのデータを地理空間分析に使用することを考えています。 カスタム gRPC クライアントは、gRPC フィードを使用してさまざまなアプリケーションから Velocity にデータを送信できるように開発されました。

使用上の注意

gRPC フィードを操作する際には、以下の点に注意してください。

  • gRPC フィードは、スキーマやキー フィールドの指定を含み、Velocity ユーザーによって構成されます。 フィードが作成されると、[gRPC エンドポイントのヘッダー パスのキー][gRPC エンドポイントのヘッダー パス]、および [gRPC エンドポイントの URL] パラメーターが、フィードの詳細ページで使用できるようになります。 これらのパラメーターは、gRPC クライアントを作成する際には必須です。
  • [認証タイプ] パラメーターを [ArcGIS] に使用して、OAuth 2.0 認証を使用します。 各受信メッセージにはフィードの所有者の有効なトークンが含まれていなければなりません。 有効なトークンがないメッセージは拒否されます。
  • gRPC クライアントからのデータは、velocity_grpc.proto ファイルで定義された構造化オブジェクトとして形成される必要があります。
  • gRPC フィード タイプは、同期および非同期の呼び出しをサポートしています。
  • gRPC フィード タイプは、クライアントストリーミング RPC (複数のリクエストに対して 1 つのレスポンス) と単項 RPC (1 つのリクエストに対して 1 つのレスポンス) をサポートしています。
  • フィード接続パラメーターの構成に加えて、Velocity にフィーチャを送信する gRPC クライアントを作成する必要があります。 gRPC フレームワークは、多くの開発言語に対応しています。 realtime-grpc-feed GitHub リポジトリには、クライアントと gRPC フィード サービス間のコントラクトの定義に使用される velocity_grpc.proto ファイル、開発者向けドキュメント、gRPC クライアントの作成方法を説明したリファレンス実装などの重要なリソースが含まれています。
  • gRPC の機能やクライアント開発方法については、gRPC の Web ページをご参照ください。

パラメーター

以下は、gRPC フィードのパラメーターです。

パラメーター説明データ タイプ

認証タイプ

受信メッセージを認証するかどうかを指定します。 次のようなオプションがあります。

  • [なし] - 認証を実行しません。
  • [ArcGIS] - 各受信メッセージにはフィードの所有者の有効なトークンが含まれていなければなりません。 有効なトークンがないメッセージは拒否されます。

トークンはリクエスト ヘッダーに Authorization: Bearer <your_token> の形式で含まれている必要があります。

String

gRPC エンドポイントのヘッダー パスのキー

メッセージをルーティングする際のフィードを識別するキー。 このキーは、メッセージをフィードにルーティングする際にヘッダー パスとともに使用されます。

このパラメーターは、フィードが公開された後で Velocity によって生成および設定されます。

String

gRPC エンドポイントのヘッダー パス

メッセージをルーティングする際のフィードを識別するパス。

このパラメーターは、フィードが公開された後で Velocity によって生成および設定されます。

String

gRPC エンドポイントの URL

gRPC クライアント チャンネルで定義されている、メッセージを送信する際の完全な URL。

このパラメーターは、フィードが公開された後で Velocity によって生成および設定されます。

String

検討事項および制限事項

[ArcGIS] 認証タイプを使用した gRPC フィードは、書き込み権限とともに他のユーザーやグループと共有できます。 gRPC フィードが書き込み権限とともに共有された場合、共有されたユーザーおよびグループはフィードにデータを書き込むことができます。 他のユーザーおよびグループがフィードにデータを書き込むことを望まない場合は、フィードを書き込み権限付きで共有しないでください。 書き込み権限は、Velocity のフィード詳細ページで有効または無効にできます。 詳細については、「フィードの共有」をご参照ください。