Samsara

Feeds vom Typ "Samsara" in ArcGIS Velocity senden HTTPS-Anforderungen zusammen mit entsprechenden Parametern an die angegebene Samsara-API-URL.

Beispiele

Im Folgenden sehen Sie Beispiele für die Verwendung des Samsara-Feeds:

• Die Samsara-API mit der URL https://api.samsara.com/fleet/vehicles/stats?types=gps wird alle fünf Sekunden abgefragt, um die aktuelle Position der Fahrzeuge und relevante Statistiken abzurufen.
• Die Samsara-API mit der URL https://api.samsara.com/fleet/equipment/locations wird jede Minute abgefragt, um die aktuelle Position der Ausrüstung abzurufen.
• Jeder Endpunkt einer GET-Anforderung von der Samsara-API (v2), der ein Daten- und Paginierungsobjekt in der JSON-Antwort zurückgibt.

Verwendungshinweise

Beachten Sie beim Arbeiten mit dem Samsara-Feed Folgendes:

• Der Samsara-Feed fragt die angegebene Samsara-API-URL in dem im Schritt Feed-Abfrageintervall des Konfigurationsassistenten festgelegten Intervall ab, um Daten zu laden.

  Hinweis:

  Der Feed darf nicht so konfiguriert werden, dass er häufiger ausgeführt wird, als die Samsara-API Features zurückgeben kann.

• Wenn ein Abfrageintervall festgelegt ist, erfolgt die Abfrage nicht zur Startzeit des Feeds, sondern in regelmäßigen Zeitintervallen. Wenn z. B. für einen Feed festgelegt ist, dass die Abfrage von Daten alle 5 Minuten erfolgt, und der Feed um 8:03 Uhr gestartet wird, erfolgt die erste Datenabfrage um 8:05 Uhr, die nächste um 8:10 Uhr usw.
• In den Velocity-Subskriptionslizenzstufen gibt es Begrenzungen für die Datenmenge, die von einem Feed erfasst werden kann, wie im Folgenden aufgeführt. Wenn die Feeds die Erfassungsgrenze Ihrer Lizenzstufe überschreiten, wird eine Meldung im Protokoll erstellt und eine E-Mail gesendet, in der Sie benachrichtigt werden, dass die Grenze erreicht wurde. Wenn die Erfassung von Daten länger als eine Stunde über dem Grenzwert liegt, wird der Feed angehalten. Wenden Sie sich an Ihren Ansprechpartner bei Esri oder den technischen Support von Esri, um sich ggf. über die Velocity-Lizenzstufen zu informieren, die Ihre Workflows unterstützen. Folgende Lizenzstufen sind verfügbar:
  • Standard: Daten werden mit 25 KB/Sekunde (ca. 100 Ereignisse pro Sekunde) erfasst und verarbeitet.
  • Advanced: Daten werden mit 250 KB/Sekunde (ca. 1.000 Ereignisse pro Sekunde) erfasst und verarbeitet.
  • Dedicated: Daten werden mit 2.500 KB/Sekunde (ca. 10.000 Ereignisse pro Sekunde) erfasst und verarbeitet.
• Der Parameter URL-Parameter unterstützt globale Feed-Variablen. Standardmäßig werden die globalen Feed-Variablen in Epoch-Zeit konvertiert (Millisekunden seit 01. Januar 1970 UTC). Optional können Sie die globalen Feed-Variablen in Epoch-Sekunden (Sekunden seit dem 1. Januar 1970) und ein Zeichenfolge-Datum/Uhrzeit-Format konvertieren. In der folgenden Aufstellung sind die verfügbaren Feed-Variablen mit der Angabe, welche Zeit sie darstellen, aufgeführt. Beim ersten Start oder Neustart des Feeds entspricht die Zeit $feed.FeedLastScheduledStart der aktuellen Laufzeit minus fünf Minuten.
  • $feed.FeedStartTime: Der Zeitpunkt, zu dem der Feed gestartet wurde
  • $feed.FeedScheduledStartTime: Der Zeitpunkt der planmäßigen Ausführung der nächsten Wiederholung des Feeds.
  • $feed.FeedLastScheduledStartTime: Der Zeitpunkt der planmäßigen Ausführung der letzten Wiederholung des Feeds.
• Der Samsara-Feed verarbeitet automatisch die JSON-Antwort der Samsara-API im zurückgegebenen Objekt data und glättet den JSON-Code.
• Sie können Arrays glätten und spezifische Ausnahmen für die Glättung von Arrays angeben. Trennen Sie mehrere Ausnahmeregelungen für das Glätten von Arrays durch Kommas voneinander ab.
• Velocity verarbeitet automatisch paginierte Antworten der Samsara-API, um alle Features zu verarbeiten.
• Nachdem Sie die Feed-Verbindungsparameter konfiguriert haben, definieren Sie das Schema und die Schlüsselfeldparameter.

Parameter

Nachfolgend werden die Parameter für den Samsara-Feed beschrieben:

Parameter	Beschreibung	Datentyp
URL	Die Samsara-API-URL. Dies muss ein Endpunkt einer GET-Anforderung der Samsara-API sein, da der Feed die Daten zur Erfassung abruft. Die URL und die angegebenen URL-Parameter steuern die Daten, die von der Samsara-API zurückgegeben werden. Die URL Ihres Samsara-API-Endpunkts finden Sie unter Überblick über die Samsara-API.	Zeichenfolge
API-Schlüssel	Der Samsara-API-Schlüssel. Geben Sie den API-Schlüssel in der folgenden Form an: samsara_api_<yourAPIKey>.	Zeichenfolge
URL-Parameter	Optionale URL-Parameter, die in die URL der HTTP-Anforderung, die an die angegebene Samsara-URL gesendet wird, aufgenommen werden sollen. Parameter können auch im Parameter URL festgelegt werden. Die hier eingegebenen URL-Parameter setzen aber alle entsprechenden Parameter, die für den Parameter URL angegeben wurden, außer Kraft. Hier definierte Parameter sind stets als URL codiert. Dieser Parameter unterstützt globale Feed-Variablen.	Schlüssel/Wert-Paar
Globale Variablen	Konvertiert die globalen Feed-Variablen in ein benutzerdefiniertes Datums- und Zeitformat. Dieser Parameter ist optional. Weitere Informationen zum Festlegen eines Datum/Uhrzeit-Formats (Epoch-Millisekunden, Epoch-Sekunden und Zeichenfolgenformat)	Zeichenfolge
Zusätzliche Protokollierung	Gibt an, ob die Protokollierung von unverarbeiteten HTTP-Anforderungen und Antworten, die von Velocity an die Samsara-URL gesendet werden, aktiviert ist. Dieser Parameter ist optional. Hinweis: Aktivieren Sie diesen Parameter nur zur Problembehebung. Deaktivieren Sie ihn wieder nach Beendigung der Problembehebung. Nach der Aktivierung starten Sie den Feed. Die Debug-Protokolle sind dann auf der Seite "Feed-Protokolle" verfügbar. Wenden Sie sich an den technischen Support von Esri, falls Sie Unterstützung bei der Fehlerbehebung benötigen.	Boolesch

Überlegungen und Beschränkungen

Nachfolgend finden Sie Überlegungen und Einschränkungen zum Verwenden des Samsara-Feeds:

• Für die Nutzung dieses Feed-Typs sind eine Samsara-Subskription und ein API-Schlüssel erforderlich.
• Die aktuelle Generation der Samsara-APIs verwendet das RFC 3339-Format für Zeitstempel. Legen Sie zur Konfiguration den Parameter Startzeit auf das Feld mit dieser datetime-Zeichenfolge fest, und verwenden Sie das folgende Format für die datetime-Zeichenfolge: yyyy-MM-dd'T'HH:mm:ss'Z'.
• Die Samsara-API kann alle 5 Sekunden abgefragt werden.