Samdesk

Le flux Samdesk dans ArcGIS Velocity se connecte à l’API Samdesk pour ingérer des alertes de crise et d’événements en temps réel depuis la plateforme mondiale de détection d’événement Samdesk. Samdesk surveille les réseaux sociaux, les informations et d’autres sources ouvertes pour rechercher les incidents émergents (les catastrophes naturelles, les menaces, les incendies et d’autres événements de sécurité publique dans un ou plusieurs lieux géographiques, par exemple).

Exemples

Les exemples suivants illustrent des cas d’utilisation du flux :

  • Un organisme de sécurité publique utilise le flux Samdesk pour surveiller les incidents émergents en temps réel, de manière à permettre aux centres d’opérations d’urgence de trier et de répartir les ressources au fur et à mesure de la survenue des événements.
  • Un opérateur logistique et de chaîne d’approvisionnement utilise le flux Samdesk pour détecter les perturbations à proximité des ports, des centres de distribution et des couloirs de transit.
  • Un organisme de défense ou de renseignement utilise le flux Samdesk pour avoir une connaissance de la situation des événements mondiaux au niveau national ou régional.
  • Un analyste des risques et des assurances utilise le flux Samdesk pour suivre les incidents susceptibles d’avoir des répercussions sur les actifs assurés et les zones d’intérêt.

Remarques sur l’utilisation

Tenez compte des points suivants lorsque vous utilisez ce flux :

  • Samdesk utilise la clé d’API générée pendant la configuration du flux et l’URL de l’élément de flux pour transmettre les données au flux. Enregistrez la clé d’API pour un usage ultérieur. Si la clé est mal placée, générez une nouvelle clé d’API dans la configuration du flux et fournissez-la à Samdesk.
  • Chaque flux Samdesk doit utiliser une clé d’API unique.
  • Vous devez obtenir la valeur du paramètre Search Stream ID (ID de flux de recherche) auprès de Samdesk pour configurer le flux.
  • Velocity gère automatiquement la structure des données. Vous ne pouvez pas ajouter de nouveaux champs, car la structure est prédéterminée par Samdesk. Vous pouvez supprimer ou renommer les champs existants.
  • Les données Samdesk sont au format JSON et le paramètre Location (Localisation) est géré automatiquement lors de l’identification des champs de clé.
  • Velocity gère automatiquement les paramètres de champ de clé pour les sections Date and time (Date et heure) et Tracking (Suivi). Le paramètre Start time (Heure de début) est défini en tant que event_time, et le paramètre Track ID (ID de suivi) en tant que event_id.
  • Velocity construit automatiquement la géométrie des points à partir des champs lat et lng de la localisation d’alerte.
  • L’intervalle minimal d’interrogation dans Velocity est de cinq secondes.
  • La limitation de débit d’API Samdesk par défaut est de cinq demandes par minute et par compte. Cette limite peut être dépassée si les intervalles d’interrogation durent moins de 12 secondes environ ou si plusieurs flux Samdesk sont exécutés avec la même clé d’API. Le cas échéant, contactez Samdesk pour demander une élévation de la limite pour votre compte.

Paramètres

Les paramètres du flux sont les suivants :

ParamètresDescriptionType de données
Version d’API

(obligatoire)

Sélectionnez la version de l’API Samdesk utilisée pour cette connexion.

Actuellement, seule la version 1 est prise en charge.

Numéro de version d’API

Clé d’API

(obligatoire)

Clé d’API permettant d’authentifier les requêtes envoyées à l’API Samdesk.

Par exemple : https://api.samdesk.io/1/search_streams/{SEARCH_STREAM_ID}/alerts?api_key={API_KEY}.

Cliquez sur l’option Generate API Key (Générer une clé d’API) pour générer une clé d’API pour le flux. Fournissez la clé d’API et l’URL de l’élément de flux à Samdesk pour pouvoir recevoir des données.

Type de format Samdesk

ID de flux de recherche

(obligatoire)

Identifiant unique d’un flux de recherche Samdesk. Un flux de recherche enregistre les mots clés, les zones d’intérêt, les types d’événements, les seuils de gravité et les balises utilisées pour déterminer les événements qui génèrent des alertes.

Connectez-vous au tableau de bord Samdesk pour rechercher l’ID du flux de recherche que vous souhaitez interroger.

En savoir plus sur les alertes de flux de recherche

Chaîne

Journalisation supplémentaire

(facultatif)

Indiquez si vous souhaitez consigner les requêtes et réponses HTTP au format brut envoyées par Velocity à Samdesk.

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