Widget Ma localisation (bêta)

Le widget My Location (beta) (Ma localisation [bêta]) vous permet d’afficher et d’enregistrer votre position et vos déplacements. Le widget peut extraire la position de votre appareil et créer des points individuels (appelés localisations) ou enregistrer des points en continu et créer des lignes (ou chemins). Outre la latitude et la longitude, le widget enregistre la date et l’heure, l’altitude, la vitesse, l’orientation et la précision. Les localisations et les chemins deviennent des sources de données en sortie, ce qui vous permet d’utiliser les données que vous créez avec le widget My Location (beta) (Ma localisation [bêta]) avec d’autres widgets, tels que le widget Table et le widget List (Liste).

Experience Builder stocke les données extraites à l’aide du widget My Location (beta) (Ma localisation [bêta]) dans le navigateur de votre appareil. Si vous actualisez la page ou fermez la fenêtre du navigateur, les données sont perdues. Pour enregistrer les données définitivement, vous pouvez activer l’action de données Export (Exporter) dans les paramètres Action du widget et les exporter au format JSON, CSV, GeoJSON ou vers un élément ArcGIS.

Exemples

Utilisez ce widget pour prendre en charge les exigences de conception d’application, telles que les suivantes :

• Vous voulez que les équipes d’intervention d’urgence marquent les localisations des lignes à haute tension qui sont tombées après une tempête.
• Vous voulez créer des entités linéaires en marchant le long d’un nouveau sentier et en enregistrant votre position en continu.
• Vous voulez suivre un camion tout au long de son itinéraire de livraison.

Remarques sur l’utilisation

Ce widget exige une connexion à un widget Map (Carte).

Lorsque vous intégrez ce widget dans une application avec la disposition Panel (Volet), le volet fournit aux utilisateurs les options suivantes :

• Get location (Obtenir la localisation) : récupérez un nouveau point. Ce bouton apparaît si le paramètre Watch location (Observer la localisation) est désactivé dans les paramètres du widget.
• Start watching (Commencer l’observation) : commencez à extraire des localisations en continu. Ce bouton apparaît si le paramètre Watch location (Observer la localisation) est activé dans les paramètres du widget.
• End watching (Terminer l’observation) : terminez l’extraction des localisations. Cette opération génère un chemin.
• Trace a path (Tracer un chemin) : créez un chemin manuellement. Cette opération est possible pendant que l’observation s’exécute.
• Show from the Map (Afficher sur la carte) ou Hide from the Map (Masquer sur la carte) : affichez ou masquez les symboles des localisations sur la carte.
• Vous pouvez supprimer chaque enregistrement à l’aide du bouton Delete the record (Supprimer l’enregistrement) ou supprimer tous les enregistrements à l’aide du bouton Clear results (Effacer les résultats).

  Remarque :

  La suppression des localisations peut entraîner la régénération des chemins associés. La suppression des chemins peut provoquer la suppression des localisations associées.

Lorsque vous intégrez ce widget dans une application avec la disposition Bar (Barre), la barre d’outils fournit aux utilisateurs les mêmes options, à l’exception des actions Données qui sont indisponibles.

La table suivante répertorie les champs attributaires que le widget My Location (beta) (Ma localisation [bêta]) peut enregistrer pour les localisations et les chemins :

Terrain	Type	Description
ObjectID	Nombre	Champ d'ID géré par le système.
Date	Date	Date et heure d’enregistrement du point.
Longitude	Nombre	Longitude du point enregistré.
Latitude	Nombre	Latitude du point enregistré.
LineID	Nombre	Identifiant qui indique la ligne à laquelle le point appartient.
Altitude	Nombre	Altitude de l’appareil d’enregistrement, mesurée en mètres au-dessus du niveau moyen de la mer (MSL).
Orientation	Nombre	Orientation de l’appareil d’enregistrement.
Vitesse	Nombre	Vitesse de l’appareil d’enregistrement en mètres par seconde.
Précision	Nombre	Précision de la localisation enregistrée, mesurée en mètres.

Le widget My Location (beta) (Ma localisation [bêta]) génère des sources de données en sortie que d’autres widgets peuvent utiliser. Vous pouvez par exemple afficher des localisations dans un widget Table. Pour ce faire, ajoutez un widget Table à votre application et cliquez sur New sheet (Nouvelle feuille) dans les paramètres du widget. Cliquez sur Outputs (Sorties), puis sélectionnez Locations output view (Vue en sortie des localisations) ou Paths output view (Vue en sortie des chemins).

Paramètres

Le widget My Location (beta) (Ma localisation [bêta]) inclut les paramètres suivants :

• Select a Map widget (Sélectionner un widget cartographique) : permet de sélectionner un widget Map (Carte).
• Arrangement (Disposition) : choisissez un style d’interface utilisateur pour le widget, Panel (Volet) ou Bar (Barre).
• General settings (Paramètres généraux) : configurez les paramètres généraux.
  • Highlight location (Mettre en surbrillance la localisation) : affichez les localisations extraites et la position actuelle de l’utilisateur sur la carte connectée.
    • Symbol color (Couleur de symbole) : modifiez la couleur des symboles de localisation sur la carte.
    • Show compass orientation (Afficher l’orientation de la boussole) : ajoutez un symbole de triangle à la position actuelle de l’utilisateur qui illustre l’orientation de l’appareil.
    • Show location accuracy (Afficher la précision de la localisation) : ajoutez une zone tampon à la position actuelle des utilisateurs qui illustre la précision de la localisation.
  • Zoom scale (Échelle de zoom) : spécifiez une échelle de zoom pour le moment où l’utilisateur extrait ou sélectionne un enregistrement et où la carte zoome sur l’enregistrement en question.
  • Timeout (second) (Délai d’expiration [secondes]) : limite temporelle maximale pour extraire une localisation ponctuelle. Si le widget dépasse le délai imparti pour extraire un point, le message The location cannot be retrieved (Impossible de récupérer la localisation) apparaît.
  • Select fields (Sélectionner des champs) : cochez la case en regard de chaque champ pour l’inclure dans les données générées.
  • Watch location (Observer la localisation) : extrayez des localisations de manière automatique et continue. L’activation de cette option génère des chemins.
    • Streaming (Mode continu) : sélectionnez la fréquence à laquelle le widget extrait un nouveau point, en temps ou en distance.

      Remarque :

      L’intervalle que vous configurez est l’intervalle minimal possible entre l’extraction des points. Cependant, les performances réelles peuvent varier selon le navigateur et d’autres parties de votre environnement Web.

    • Manual path tracing (Traçage manuel du chemin) : incluez le bouton Trace a path (Tracer un chemin) dans le volet du widget au moment de l’exécution. Ce bouton permet à l’utilisateur de générer manuellement un chemin à tout moment au cours du processus d’observation.
  • Default activation (Activation par défaut) : si vous activez ce paramètre, le widget commence à extraire des points dès que l’application se charge au moment de l’exécution. Si vous désactivez ce paramètre, le widget commence à extraire des points uniquement lorsque l’utilisateur clique sur le bouton Start watching (Commencer l’observation).

Options d’interaction

Ce widget prend en charge les actions, que vous pouvez configurer sur l’onglet Action dans les paramètres du widget.

Activez les actions Données pour ajouter des boutons à l’interface utilisateur du widget et réaliser des tâches de traitement de données, comme l’exportation, le zoom sur des localisations et l’affichage d’enregistrements dans une table. Pour utiliser des actions Données au moment de l’exécution, cliquez sur Actions et sélectionnez une action Données dans le menu déroulant qui apparaît.