Samsara

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 utilisent le flux Samsara :

• 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

Gardez ce qui suit à l’esprit lorsque vous utilisez le flux Samsara :

• 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 intervient à 8:05, la suivante à 8:10, et ainsi de suite.
• Les niveaux de licence d’abonnement ArcGIS Velocity présentent des limites quant au volume de données pouvant être ingéré par un flux, comme l’indique le résumé 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. Pour plus d’informations relatives aux licences ArcGIS Velocity, voir Licensing (Licences). Le cas échéant, contactez votre représentant Esri ou le support technique Esri pour identifier les niveaux de licence Velocity qui prennent en charge vos processus. Les niveaux de licence sont les suivants :
  • Standard : ingestion et traitement des données à 25 Ko/seconde (environ 100 événements par seconde).
  • Avancé : ingestion et traitement des données à 250 Ko/seconde (environ 1 000 événements par seconde).
  • Dédié : ingestion et traitement des données à 2 500 Ko/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. Vous trouverez ci-après les variables d’analyse de flux et leur signification. À la première exécution du flux après le démarrage ou le redémarrage, l’heure $feed.FeedLastScheduledStart sera l’heure d’exécution actuelle moins cinq minutes.
  • $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 de flux, voir Configurer les données en entrée pour apprendre à définir le schéma et les paramètres de champs de clé.

Paramètres

Les paramètres du flux Samsara sont présentés ci-après :

Paramètre	Description	Type de données
URL	URL 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. Pour trouver l’URL de point d’extrémité de l’API Samsara, voir Samsara API Overview (Présentation 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
Paramètres URL	Paramètres URL facultatifs à inclure dans l’URL de la demande HTTP envoyée à l’URL Samsara spécifiée. Les paramètres peuvent également être définis dans le paramètre URL (URL), mais les paramètres URL saisis ici écrasent tout paramètre correspondant spécifié pour le paramètre URL (URL). Les paramètres définis ici seront 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/heure personnalisé. Ce paramètre est facultatif. Pour obtenir plus d’informations sur la définition d’un format de date (millisecondes epoch, secondes epoch et format de type chaîne), consultez la rubrique Paramètres de date et d’heure.	Chaîne
Journalisation supplémentaire	Spécifie si la journalisation des requêtes et réponses HTTP au format brut envoyées par Velocity à l’URL Samsara sera activée. Ce paramètre est facultatif. Remarque : Activez ce paramètre dans le cadre d’un dépannage uniquement et désactivez-le à l’issue du dépannage. Une fois activé, lancez le flux. Les journaux de niveau débogage sont disponibles sur la page des journaux du flux. Le cas échéant, contactez le support technique Esri pour obtenir de l’aide dans le cadre du dépannage.	Booléen

Considérations et limitations

Voici les considérations et limitations lors de l’utilisation du flux Samsara :

• 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 configurer, définissez le paramètre Start Time (Heure de début) sur le champ avec cette date/heure de chaîne et indiquez le format de date/heure de chaîne de yyyy-MM-dd'T'HH:mm:ss'Z'.
• L’API Samsara peut être interrogée toutes les cinq secondes.