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
- Ein GIS-Workshop hat einen benutzerdefinierten gRPC-Client implementiert, der Python verwendet, um mithilfe des gRPC-Feed-Typs 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-Feed-Typs an Velocity senden.
Verwendungshinweise
- 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.
- Legen Sie den Wert Authentifizierungstyp auf ArcGIS fest, 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 Echtzeit-gRPC-Feed-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
Parameter | Beschreibung | Datentyp |
---|---|---|
Authentifizierungstyp | Legt fest, ob eingehende Nachrichten authentifiziert werden. Die folgenden Optionen sind verfügbar:
Das Token muss in den Anforderungsheadern wie folgt angegeben werden: Authorization: Bearer <Ihr_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 |