Feeds vom Typ "Samsara" in ArcGIS Velocity senden HTTPS-Anforderungen zusammen mit entsprechenden Parametern an die angegebene Samsara-API-URL.
Beispiele
Es folgen einige Beispiele für Anwendungsfälle für den Feed:
- 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 Feed die folgenden Punkte:
- 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 pro Sekunde (ca. 100 Ereignisse pro Sekunde) erfasst und verarbeitet.
- Advanced: Daten werden mit 250 KB pro Sekunde (ca. 1.000 Ereignisse pro Sekunde) erfasst und verarbeitet.
- Dedicated: Daten werden mit 2.500 KB pro 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. Die Feed-Analysevariablen mit der Angabe, welche Zeit sie darstellen, sind unten aufgelistet. Wenn der Feed nach dem Start oder Neustart zum ersten Mal ausgeführt wird, ist $feed.FeedLastScheduledStartTime gleich $feed.FeedScheduledStartTime minus dem Schrittwert Feed-Abfrageintervall. Dadurch kann der Feed Daten von der angepassten Startzeit bis zur aktuellen Zeit empfangen, wodurch vermieden wird, dass eine große Menge historischer Daten erfasst wird.
- $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.
- Bei der Verwendung eines Feeds aus der Dropdown-Liste der Samsara-Endpunkte können Typen in URL-Parametern angegeben werden (z. B. gps, engineStates).
Parameter
Nachfolgend werden die Parameter für den Feed beschrieben:
| Parameter | Beschreibung | Datentyp |
|---|---|---|
| Samsara-Endpunkt | Gibt die Samsara-API-URL an. Zu den unterstützten Samsara-Endpunkten gehören die folgenden:
| Samsara-API-URL. |
| URL (konditional) | Die benutzerdefinierte 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. Dieser Parameter ist verfügbar, wenn für den Parameter Samsara-Endpunkt die Option Others festgelegt ist. | Zeichenfolge |
| API-Schlüssel | Der Samsara-API-Schlüssel. Geben Sie den API-Schlüssel in der folgenden Form an: samsara_api_<yourAPIKey>. | Zeichenfolge |
| Nur zuletzt verwendete Daten laden (konditional) | Die zuletzt verwendeten Daten nach dem ersten Laden von Daten laden. Wenn dieser Parameter aktiviert ist, werden beim ersten Erfassen alle Daten in den Feed übernommen, bei den folgenden Aktualisierungen hingegen nur die letzten Daten. Dieser Parameter wird nur für die folgenden beiden Samsara-Endpunkte unterstützt:
| Boolesch |
| URL-Parameter (Optional) | 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. | Zeichenfolge |
| Zusätzliche Protokollierung (Optional) | Aktivieren Sie diesen Parameter, um anzugeben, ob Sie unverarbeitete HTTP-Anforderungen und -Antworten protokollieren möchten, die von Velocity an die Samsara-URL gesendet werden. Hinweis:Aktivieren Sie diesen Parameter 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 Problembehandlung benötigen. | Boolesch |
Überlegungen und Beschränkungen
Berücksichtigen Sie bei der Verwendung des Feeds Folgendes:
- 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.
- Wenn die Benutzeranmeldeinformationen ungültig sind, wird bis zu dreimal versucht, die Verbindung herzustellen. In den Protokollen werden Fehler durch ungültige Anmeldeinformationen angezeigt. Der Feed versucht nach einer auf dem Wiederholungszeitplan basierenden Verzögerung automatisch, den Vorgang erneut zu starten.