Le type de flux Samsara dans ArcGIS Velocity envoie des demandes HTTPS à une URL d’API Samsara spécifiée avec les paramètres pertinents.
Exemples
Les exemples suivants illustrent des cas d’utilisation du flux :
- L’API Samsara avec l’URL https://api.samsara.com/fleet/vehicles/stats?types=gps est demandée toutes les cinq secondes pour extraire l’emplacement actuel des véhicules et les statistiques correspondantes.
- L’API Samsara avec l’URL https://api.samsara.com/fleet/equipment/locations est demandée toutes les minutes pour extraire l’emplacement actuel de l’équipement.
- Un point d’extrémité de demande GET à partir de l’API Samsara (v2) qui renvoie un objet de données et de pagination dans la réponse JSON.
Remarques sur l’utilisation
Tenez compte des points suivants lorsque vous utilisez ce flux :
- Le flux Samsara interroge l’URL d’API Samsara indiquée pour charger les données à la vitesse spécifiée dans Feed Polling Interval (Intervalle d’interrogation de flux) de l’assistant de configuration.
Remarque :
Le flux ne doit pas être configuré pour s’exécuter plus souvent que l’API Samsara ne peut renvoyer d’entités.
- Lorsqu’un intervalle d’interrogation est défini, les interrogations ont lieu à intervalles réguliers à partir de l’heure de démarrage du flux. Par exemple, si un flux est configuré pour interroger les données toutes les cinq minutes, et qu’il démarre à 8:03, la première demande de données a lieu à 8:05, la suivante à 8:10, et ainsi de suite.
- Les niveaux de licence de l’abonnement Velocity présentent des limites quant au volume de données pouvant être ingéré par un flux, comme synthétisé ci-dessous. Si des flux excèdent la limite d’ingestion de votre niveau de licence, un message est écrit dans les journaux et un e-mail est envoyé pour vous informer que la limite a été atteinte. Si l’ingestion des données demeure supérieure à la limite pendant plus d’une heure, le flux s’arrête. Le cas échéant, contactez votre représentant Esri ou le Support technique Esri pour découvrir les niveaux de licence Velocity prenant en charge vos processus. Les niveaux de licence sont les suivants :
- Standard : ingestion et traitement des données à 25 ko par seconde (environ 100 événements par seconde).
- Advanced (Avancé) : ingestion et traitement des données à 250 ko par seconde (environ 1 000 événements par seconde).
- Dedicated (Dédié) : ingestion et traitement des données à 2 500 ko par seconde (environ 10 000 événements par seconde).
- Le paramètre URL parameters (Paramètres URL) prend en charge les variables globales de flux. Par défaut, les variables globales de flux sont converties en heure epoch (millisecondes depuis le 1er janvier 1970 UTC). Vous pouvez également convertir ces variables en secondes epoch (secondes depuis le 1er janvier 1970 UTC) dans une chaîne au format de date et heure. Les variables d’analyse de flux et la période qu’elles représentent sont répertoriées ci-dessous. À la première exécution du flux après le démarrage ou le redémarrage, $feed.FeedLastScheduledStartTime est égal à $feed.FeedScheduledStartTime moins la valeur de l’étape Feed Polling Interval (Intervalle d’interrogation de flux). Cela permet au flux de recevoir des données entre l’heure de démarrage ajusté et l’heure actuelle, ce qui empêche l’ingestion d’un important volume de données d’historique.
- $feed.FeedStartTime : heure à laquelle le flux a démarré.
- $feed.FeedScheduledStartTime : heure à laquelle la prochaine récurrence du flux est planifiée.
- $feed.FeedLastScheduledStartTime : heure à laquelle la dernière récurrence du flux était planifiée.
- Le flux Samsara traite automatiquement la réponse JSON à partir de l’API Samsara dans l’objet data renvoyé, puis aplatit le JSON.
- Vous pouvez aplatir les matrices et indiquer des exemptions d’aplatissement de matrice spécifiques. Séparez plusieurs exemptions d’aplatissement de matrice par des virgules.
- Velocity gère automatiquement les réponses paginées à partir de l’API Samsara pour traiter toutes les entités.
- Après avoir configuré les paramètres de connexion au flux, définissez la structure et les paramètres de champs clés.
- Lorsque vous utilisez un flux de la liste déroulante Samsara endpoint (Point de terminaison Samsara), les types peuvent être spécifiés dans URL parameters (Paramètres URL) (par exemple, gps, engineStates) .
Paramètres
Les paramètres du flux sont les suivants :
| Paramètre | Description | Type de données |
|---|---|---|
| Samsara endpoint (Point de terminaison Samsara) | Spécifie l’URL de l’API Samsara. Les points de terminaison Samsara pris en charge sont les suivants :
| URL de l’API Samsara |
| URL (conditionnel) | URL personnalisée de l’API Samsara. Il doit s’agir d’un point d’extrémité de demande GET de l’API Samsara, car le flux extrait les données pour l’ingestion. L’URL, ainsi que les paramètres d’URL fournis, contrôlent les données renvoyées par l’API Samsara. Ce paramètre est disponible lorsque le paramètre Samsara endpoint (Point de terminaison Samsara) est défini sur Others (Autres). En savoir plus sur les points de terminaison de l’API Samsara | Chaîne |
| Clé d’API | Clé d’API Samsara. Indiquez la clé d’API au format suivant : samsara_api_<yourAPIKey>. | Chaîne |
| Load Recent Data Only (Charger uniquement les données récentes) (conditionnel) | Charge uniquement les données récentes après le chargement de données initial. Si ce paramètre est activé, le flux ingère toutes les données lors de la première exécution, et uniquement les mises à jour récentes lors des exécutions suivantes. Ce paramètre est pris en charge uniquement pour les deux points de terminaison Samsara suivants :
| Booléen |
| Paramètres URL (Facultatif) | Paramètres URL à inclure dans l’URL de la requête HTTP envoyée à l’URL Samsara spécifiée. Les paramètres peuvent également être définis dans le paramètre URL, les paramètres URL saisis ici écrasant tout paramètre correspondant spécifié pour le paramètre URL. Les paramètres définis ici sont toujours codés par URL. Ce paramètre prend en charge les variables globales de flux. | Paire clé-valeur |
| Variables globales | Convertissez les variables globales de flux au format date et heure personnalisé. | Chaîne |
| Journalisation supplémentaire (Facultatif) | Activez ce paramètre pour spécifier si vous pouvez consigner les requêtes et réponses HTTP au format brut envoyées par Velocity à l’URL Samsara. Remarque :Activez ce paramètre à des fins de dépannage et désactivez-le à l’issue du dépannage. Une fois le paramètre activé, démarrez le flux. Les journaux de niveau Debug (Débogage) sont disponibles sur la page des journaux du flux. Contactez le Support technique d’Esri pour obtenir de l’aide dans le cadre du dépannage. | Booléen |
Considérations et limitations
Tenez compte des points suivants lorsque vous utilisez le flux :
- Un abonnement et une clé d’API Samsara sont indispensables à l’utilisation de ce type de flux.
- La génération actuelle d’API Samsara utilise le format RFC 3339 pour les horodatages. Pour le configurer, définissez le paramètre Start time (Heure de début) sur le champ contenant cette chaîne et indiquez le format d’horodatage de chaîne yyyy-MM-dd'T'HH:mm:ss'Z'.
- L’API Samsara peut être interrogée toutes les cinq secondes.
- Si les informations d’identification d’utilisateur ne sont pas valides, le flux relance la connexion jusqu’à trois fois. Des erreurs relatives aux informations d’identification non valides apparaissent dans les journaux. Le flux tente automatiquement de redémarrer après un délai d’attente, en fonction du calendrier de récurrence configuré.
Vous avez un commentaire à formuler concernant cette rubrique ?