Der gRPC-Feed-Typ in ArcGIS Velocity erstellt einen integrierten gRPC-Pfadendpunkt, mit dem Daten programmgesteuert von gRPC-Clients und -Anwendungen entweder in diskontinuierlichen Anforderungen oder in einem kontinuierlichen Strom an Velocity gesendet werden können. gRPC ist eine Open-Source-Remote-Prozeduraufruf-Umgebung, die zum Verbinden verteilter Anwendungen und Services dient.
Beispiele
Im Folgenden sehen Sie Beispiele für die Verwendung des gRPC-Feeds:
- Ein GIS-Workshop hat einen benutzerdefinierten gRPC-Client implementiert, der Python verwendet, um mithilfe des gRPC-Feeds strukturierte Daten an Velocity zu senden.
- Eine Organisation mit mehreren Anwendungen zur Datenerfassung, die in verschiedenen Sprachen geschrieben sind, möchte ihre Daten für räumliche Analysen zur Verfügung stellen. Benutzerdefinierte gRPC-Clients werden entwickelt, damit sie Daten aus ihren verschiedenen Anwendungen mithilfe des gRPC-Feeds an Velocity senden.
Verwendungshinweise
Beachten Sie beim Arbeiten mit dem gRPC-Feed Folgendes:
- Der gRPC-Feed wird einschließlich der Schema- und Schlüsselfeldangabe, von einem Velocity-Benutzer konfiguriert. Nachdem der Feed erstellt worden ist, stehen auf der Seite mit den Feed-Details die Parameter Schlüssel für gRPC-Endpunkt-Header-Pfad, gRPC-Endpunkt-Header-Pfad und gRPC-Endpunkt-URL zur Verfügung. Diese Parameter werden zum Erstellen eines gRPC-Clients benötigt.
- Setzen Sie den Parameter Authentifizierungstyp auf ArcGIS, um die OAuth 2.0-Authentifizierung zu verwenden. Jede eingehende Nachricht muss ein gültiges Token für den Besitzer des Feeds enthalten. Nachrichten ohne gültiges Token werden zurückgewiesen.
- Daten von einem gRPC-Client müssen als strukturiertes Objekt formatiert werden, das durch die Datei velocity_grpc.proto definiert wird.
- Der gRPC-Feed-Typ unterstützt synchrone und asynchrone Aufrufe.
- Der gRPC-Feed-Typ unterstützt Client-Streaming-RPC (mehrere Anforderungen mit einer Antwort) und unäre RPC (einzelne Anforderung mit einer Antwort).
- Neben dem Konfigurieren der Feed-Verbindungsparameter muss ein gRPC-Client erstellt werden, um Features an Velocity senden zu können. Die gRPC-Umgebung unterstützt viele Entwicklersprachen. Das GitHub-Repository realtime-grpc-feed enthält wichtige Ressourcen, wie z. B. die Datei velocity_grpc.proto, die zum Definieren der Vereinbarung zwischen dem Client und dem gRPC-Feed-Service, der Entwicklerdokumentation und der Referenzimplementierungen verwendet wird, mit denen dargestellt wird, wie ein gRPC-Client erstellt wird.
- Weitere Informationen zu den gRPC-Funktionen und den Client-Entwicklungsstrategien finden Sie auf der gRPC-Webseite.
Parameter
Nachfolgend werden die Parameter für den gRPC-Feed beschrieben:
Parameter | Beschreibung | Datentyp |
---|---|---|
Authentifizierungstyp | Legt fest, ob eingehende Nachrichten authentifiziert werden. Die folgenden Optionen sind verfügbar:
Das Token muss im folgenden Format in den Anforderungsheadern angegeben werden: Authorization: Bearer <your_token>. | Zeichenfolge |
Schlüssel für gRPC-Endpunkt-Header-Pfad | Der Schlüssel, mit dem der Feed zum Weiterleiten von Nachrichten angegeben wird. Der Schlüssel wird mit dem Header-Pfad zum Weiterleiten von Nachrichten zu dem Feed verwendet. Dieser Parameter wird von Velocity generiert und ausgefüllt, nachdem der Feed veröffentlicht wurde. | Zeichenfolge |
gRPC-Endpunkt-Header-Pfad | Der Pfad, mit dem der Feed zum Weiterleiten von Nachrichten angegeben wird. Dieser Parameter wird von Velocity generiert und ausgefüllt, nachdem der Feed veröffentlicht wurde. | Zeichenfolge |
gRPC-Endpunkt-URL | Die vollständige URL zum Senden von Nachrichten gemäß Definition im gRPC-Clientkanal. Dieser Parameter wird von Velocity generiert und ausgefüllt, nachdem der Feed veröffentlicht wurde. | Zeichenfolge |
Überlegungen und Beschränkungen
gRPC-Feeds, die den Authentifizierungstyp ArcGIS verwenden, können mit der Schreibberechtigung für andere Benutzer und Gruppen freigegeben werden. Wenn ein gRPC-Feed mit Schreibberechtigungen freigegeben wird, können die Benutzer und Gruppen, für die er freigegeben ist, Daten in den Feed schreiben. Geben Sie einen Feed nicht mit Schreibberechtigungen frei, wenn andere Benutzer und Gruppen keine Daten darin speichern sollen. Sie können Schreibberechtigungen auf der Seite mit den Feed-Details in Velocity aktivieren und deaktivieren. Weitere Informationen finden Sie unter Freigeben von Feeds.