EsriJSON ist ein Format zum Codieren verschiedener Strukturen geographischer Daten. Beim Referenzieren von EsriJSON wird in der Regel das FeatureSet-Objekt referenziert, bei dem das FeatureSet eine Gruppe aus Feature-Objekten enthält. Daten im EsriJSON-Format können in ArcGIS Velocity als FeatureSet-Objekt (Sammlung von Features) oder als einzelne Feature-Objekte als Zeilen erfasst werden.
Das Datenformat EsriJSON wird für die folgenden Feed- und Datenquellentypen unterstützt:
- Feeds: Azure Event Hub, Azure Service Bus, AWS IoT, Website (Abfrage), Endpunkt (empfangen), Kafka, WebSocket, RabbitMQ, MQTT
- Datenquellen: Azure Blob Storage, Amazon S3, Website (Abfrage)
Unterstützte EsriJSON-Daten
Velocity unterstützt EsriJSON-Daten, die einen konsistenten Geometrietyp, konsistente Felder und einen konsistenten Raumbezug aufweisen.
Generieren von EsriJSON
Daten können mit den Werkzeugen ArcGIS Pro-Features in JSON und ArcMap-Features in JSON aus zahlreichen Formaten in EsriJSON konvertiert werden.
Festlegen der EsriJSON-Konfiguration
Beim Konfigurieren eines Feeds oder einer Datenquelle wird anhand von Stichproben der Typ der erfassten Daten ermittelt. Wenn anhand der Stichproben bestimmt wird, dass es sich um das EsriJSON-Format handelt, können zusätzliche Eigenschaften für die EsriJSON-Konfiguration festgelegt werden.
Positionseigenschaften
Es müssen ggf. zusätzliche Positionsinformationen konfiguriert werden, wenn diese nicht in den Stichprobendaten vorliegen. Dies ist insbesondere der Fall, wenn Stichproben einzelner Feature-Objekte erfasst werden. Beispielsweise umfassen Geometrieobjekte in einem Feature-Array häufig keinen Raumbezug für die einzelnen Features. Bei Stichproben eines FeatureSet-Objekts kann Velocity die vollständigen Positionsinformationen ableiten, sodass die Konfiguration zusätzlicher Positionsinformationen nicht nötig ist.
Überlegungen und Beschränkungen
Beim Arbeiten mit Daten im EsriJSON-Format in Velocity sind einige wichtige Überlegungen und Beschränkungen zu berücksichtigen.
Die Eigenschaften von EsriJSON-Features müssen konsistent bleiben
Im EsriJSON-Datenformat werden Attributdaten als Name-Wert-Paare im Attributobjekt dargestellt. Die Eigenschaften müssen einen Wert aufweisen oder NULL sein. Wenn für eine Eigenschaft eines Features kein Wert vorhanden ist, muss der fehlende Wert als NULL dargestellt werden, statt keinen Attributnamen anzugeben.
Ändern von Feldtypen
In der Regel wird empfohlen, dass Feldtypen für EsriJSON nicht geändert werden. Wenn Velocity FeatureSet-Objekte erfasst, wird eine genaue Darstellung der Feldtypen abgeleitet, die dann beim Konfigurieren einer Quelle oder eines Feeds nicht geändert werden sollten. In Bezug auf das Ändern der Feldtypen sind Feature-Objekte die Ausnahmen. Wenn Feature-Objekte die Zeit in Datumsfeldern als Epochenzeit in Millisekunden darstellen, werden sie immer als ganzzahlige Feldtypen ohne ein vollständiges FeatureSet abgeleitet, das explizit Feldtypen enthält, und sollten daher entsprechend angepasst werden. Außerdem versucht Velocity im Fall von Feature-Objekten, sonstige Feldtypen ausschließlich basierend auf den abgerufenen Samples abzuleiten. In diesem Fall sollten die Feldtypen entsprechend überprüft werden.
Größe von EsriJSON-Dateien
Bei der Erfassung von EsriJSON-Dateien empfiehlt sich eine Dateigröße von unter 100 MB. Wenn Sie eine größere Datenmenge erfassen müssen, wird empfohlen, die Dateien in Dateien mit einer Größe von jeweils unter 100 MB aufzuteilen.