Géotrace et géoforme

Les questions de type géotrace et géoforme permettent de capturer une polyligne ou un polygone figurant sur une carte. Vous pouvez utiliser cette géométrie pour l’entité obtenue dans la couche d’entités à la place d’un point.

Réponse à une question de type géoforme

Contrairement aux questions de type géopoint ou à la capture de localisations sans question relative à la localisation, les questions de type géotrace et géoforme ne font pas appel à la localisation de l’appareil pour renseigner la réponse ; elles utilisent néanmoins la localisation de l’appareil pour centrer la carte.

Si une question de type géotrace ou géoforme est laissée sans réponse et que sa géométrie n’est pas créée à partir d’une valeur par défaut ou d’une expression, l’enregistrement de l’enquête est envoyé à la couche d’entités avec une géométrie nulle.

Remarque :

Vous pouvez ajouter plusieurs questions de type géopoint, géotrace ou géoforme dans une enquête. Toutefois, vous ne pouvez utiliser qu’une seule d’entre elles pour la géométrie de l’enregistrement de l’enquête. Vous pouvez utiliser plusieurs questions de type carte si toutes les questions sauf une ont le champ bind::esri:fieldType défini sur null.

Chaque répétition d’une enquête peut également comporter plusieurs questions de type géopoint, géotrace ou géoforme, mais vous ne pouvez utiliser qu’une seule d’entre elles pour la géométrie de l’enregistrement d’une répétition. Vous pouvez utiliser plusieurs questions de type carte selon la méthode décrite ci-dessus.

Lors de la capture des questions de type géotrace ou géoforme à l’aide d’une carte, toutes les entités de l’application de terrain Survey123 ne sont pas prises en charge dans l’application Web. Les entités suivantes sont prises en charge dans l’application de terrain Survey123, mais pas dans l’application Web :

  • Fonds de carte en mode hors connexion
  • Options de style fournies pour les questions de type géotrace et géoforme
  • Calculs sur des questions de type géotrace et géoforme, y compris la fonction sum()
  • Seuils de précision d’emplacement et expressions relatives à la qualité de l’emplacement

Méthodes de capture

Les données de type géotrace et géoforme ont deux méthodes de capture : Construction et Sommet. La méthode Construction est utilisée par défaut pour les enquêtes créées de toutes pièces et la méthode Sommet est destinée aux enquêtes créées à partir d’une couche d’entités existante. Vous pouvez définir une autre méthode de capture dans l’enquête en saisissant method=sketch ou method=vertex dans la colonne body::esri:style de la question.

Dessin

La méthode Construction capture la géométrie en un seul mouvement, la capture étant terminée dès que l’utilisateur cesse de tracer la ligne unique.

Pour plus d’informations sur l’utilisation de cette méthode, reportez-vous à la section Construction.

Sommet

La méthode Sommet permet une capture géométrique plus précise d’une ligne ou d’une forme en plaçant des sommets reliés les uns aux autres.

Pour plus d’informations sur l’utilisation de cette méthode, reportez-vous à la section Sommet.

Les paramètres qui contrôlent le comportement lors de la capture des sommets sont les suivants :

  • beep ou nobeep : lorsque le paramètre beep est défini, un retour audio est émis chaque fois qu’un sommet est capturé. Lorsque ce paramètre n’est pas inclus, la valeur par défaut est nobeep.
  • haptic ou nohaptic : lorsque le paramètre haptic est défini, un retour haptique est émis chaque fois qu’un sommet est capturé. Ce paramètre est pris en charge uniquement sur le matériel prenant en charge le retour haptique. Lorsque ce paramètre n’est pas inclus, la valeur par défaut est nohaptic.
  • edit ou noedit : lorsque le paramètre noedit est défini, les utilisateurs peuvent uniquement capturer les sommets à leur localisation actuelle, annuler le placement de chaque sommet et remplacer l’intégralité de la ligne ou du polygone. Les utilisateurs ne peuvent pas mettre à jour un sommet individuel. Lorsque ce paramètre n’est pas inclus, la valeur par défaut est edit.
  • streaming ou nostreaming : les polygones linéaires ou surfaciques peuvent être diffusés en continu lors de vos déplacements. Lorsque ce paramètre n’est pas inclus, la valeur par défaut est nostreaming.

L’exemple suivant définit la méthode de capture sur la diffusion en continu des sommets avec un retour sonore :

method=vertex,streaming,beep

L’auteur d’une enquête peut configurer la distance entre des sommets adjacents diffusés en continu. Par défaut, les sommets sont capturés tous les 10 mètres, mais vous pouvez modifier cette valeur à l’aide du paramètre distanceThreshold. Ce paramètre est séparé par un espace dans la colonne body::esri:style. Vous pouvez également inclure d’autres paramètres qui définissent la couleur de la ligne ou de la forme.

L’exemple suivant capture les sommets tous les 25 mètres et crée une ligne rouge :

method=vertex,streaming,beep distanceThreshold=25 lineColor=red

Si la précision de la localisation est importante pour les sommets capturés, la saisie d’une valeur de seuil de précision dans la colonne body::accuracyThreshold de la question de type géotrace ou géoforme empêche la capture des sommets sauf si la condition de seuil est remplie.

Valeurs par défaut et expressions

Vous pouvez définir la géométrie par défaut des questions de type géotrace et géoforme ou utiliser une expression pour créer la géométrie à l’aide des résultats d’autres questions. Les sommets individuels qui constituent la réponse à une question de type géotrace ou géoforme sont des ensembles séparés par des espaces de valeurs de longitude et de latitude (en degrés décimaux), elles-mêmes séparées par un point-virgule. Pour renseigner la réponse à une question de type géotrace ou géoforme, vous devez respecter cette structure pour produire une réponse valide. Pour obtenir des emplacements précis, ces valeurs doivent être élevées. Par exemple, les valeurs suivantes fournies dans la colonne par défaut d’une question de type géoforme trace la forme autour d’un parc de la ville Melbourne en Australie :

-37.842156723211474 144.95942945338243; -37.83554486071995 144.9726235713864; -37.85681405373047 144.98240735651922; -37.85954045531896 144.97715349053766

Conseil :

Les localisations par défaut situées dans l’hémisphère sud génèrent une erreur dans Microsoft Excel. En effet, comme ces valeurs sont précédées d’un signe moins (-), elles sont interprétées comme des formules. Pour y remédier, saisissez une apostrophe avant la première valeur afin qu’elle soit correctement interprétée dans Excel. L’ajout d’une apostrophe ne modifie pas le comportement dans Survey123.

Puisque vous ne pouvez pas insérer directement ces valeurs à partir des questions à choix multiples, il est recommandé d’utiliser la fonction substr() dans la colonne calculation (calcul) pour élaborer une réponse valide. Par exemple, le nom d’une réponse dans une question select_one peut prendre la forme suivante :

+059.38330_+018.66300

Cette réponse utilise un nombre fixe de caractères pour la latitude et la longitude. Elle insère des zéros qui seraient normalement tronqués et un trait de soulignement entre les deux valeurs, car aucun espace n’est autorisé dans la colonne name (nom). Cela a pour effet de créer une valeur pouvant être décomposée par la fonction substr() qui peut renseigner l’exemple suivant de question de type géotrace avec deux sommets :

substr(${previous_question1}, 0, 10) + " " + substr(${previous_question1}, -10) + "; " + substr(${previous_question2}, 0, 10) + " " + substr(${previous_question2}, -10)

Cet exemple prend les dix premiers caractères des deux valeurs (les latitudes) et les dix derniers (les longitudes) et les présente séparées par un espace, un point-virgule séparant les emplacements valides, pour produire que résultat de géotrace valide.

Vous pouvez utiliser la fonction d’agrégation sum() pour assembler un nombre de valeurs de géopoint dans une répétition et les utiliser en tant que sommets pour former la géotrace ou la géoforme. Cela permet aux utilisateurs de capturer les métadonnées de localisation pour chaque sommet de la géométrie. Pour plus d’informations, reportez-vous à la rubrique Fonctions d’agrégation.

Bien qu’une localisation ne soit pas immédiatement capturée par une question de type géotrace ou géoforme, la localisation de l’appareil est utilisée pour centrer la carte lors du chargement de l’enquête. Pour empêcher cela, définissez la valeur par défaut sur null. À la place sont affichées des options d’affichage permettant la capture de l’emplacement, le chargement de la page des cartes pour la détermination manuelle d’un emplacement ou l’actualisation d’un calcul si un calcul est appliqué à la question.

Recherche géographique

Les questions de type géotrace et géoforme incluent une fonction de recherche géographique qui permet aux utilisateurs de rechercher une adresse ou un point d’intérêt, puis d’appliquer un zoom à cet emplacement sur la carte et d’y insérer un sommet.

Par défaut, la fonction de recherche géographique renvoie des résultats en provenance du monde entier et utilise ArcGIS Geocoding service pour rechercher les adresses.

Remarque :
Le géocodage à l’aide de ArcGIS Geocoding service consomme des crédits. Pour plus d'informations, reportez-vous à la rubrique Présentation des crédits.

Pour définir le localisateur chargé de renvoyer les résultats, indiquez l’ID d’élément du localisateur dans la colonne bind::esri:parameters, par exemple, geocode=36ff9e8c13e042a58cfce4ad87f55d19. Un localisateur utilisé dans une enquête ArcGIS Online doit correspondre à un élément dans ArcGIS Online. Un localisateur utilisé dans une enquête ArcGIS Enterprise doit correspondre à un élément du même portail que l’enquête.

Attributs géométriques

Vous pouvez utiliser les questions de type géotrace et géoforme dans des calculs pour afficher et enregistrer des attributs géométriques tels que la longueur (d’une géotrace), le périmètre et l’aire (d’une géoforme). Les fonctions distance() et area() permettent de construire une expression avec la question géotrace ou géoforme. La fonction distance() renvoie un résultat exprimé en mètres et la fonction area() un résultat en mètres carrés. Consultez les exemples de questions de type géotrace et géoforme dans Survey123 Connect pour avoir des exemples de calcul qui convertissent ces résultats en d’autres unités.

Symbologie de géométrie

Vous pouvez ajouter un style aux questions de type géotrace et géoforme qui apparaissent dans l’enquête. Vous pouvez définir ce style à l’aide des paramètres suivants dans la colonne body::esri:style des questions de type géotrace et géoforme :

  • lineColor
  • lineWidth
  • fillColor

Les couleurs peuvent être spécifiées par leur nom de couleur HTML standard ou leur code de couleur hexadécimale. Vous pouvez utiliser des codes de couleur hexadécimale de huit caractères pour définir l’opacité. Les valeurs multiples sont séparées par un espace. Exemple : lineColor=Black fillColor=#800000FF lineWidth=3.

Remarque :

Les paramètres lineColor et lineWidth sont pris en charge par les questions de type géotrace et géoforme. Le paramètre fillColor n’est pris en charge que par les questions de type géoforme.

Ces options de style s’affichent uniquement dans Survey123 Connect et dans l’application de terrain Survey123.

Les localisations des points provenant de la première question de type géopoint d’une répétition peuvent être affichés sur n’importe quelle carte dans l’enquête. Pour plus d’informations, reportez-vous à la rubrique Superpositions de points sur les cartes.

Style de question

Vous pouvez configurer le fond de carte, les outils cartographiques et la hauteur des questions de type carte.

Il est possible de définir un fond de carte par défaut pour certaines questions de type carte à l’aide du paramètre map figurant dans la colonne body::esri:style. Par exemple, map="World Topography" indique à la question de type carte d’utiliser le fond de carte World Topography. Vous pouvez également définir le paramètre map à l’aide de l’ID d’élément de la carte, par exemple map=de26a3cf4cc9451298ea173c4b324736. Ce paramètre prend en charge les cartes en ligne et les cartes hors connexion, y compris vos propres cartes Web. Pour plus d’informations, reportez-vous à la rubrique Insérer une carte dans une enquête.

La colonne body::esri:style accepte un paramètre mapTools pour contrôler les outils cartographiques qui sont disponibles pour les questions de type carte. Si aucun paramètre d’outil cartographique n’est défini, tous les outils sont affichés. Les valeurs suivantes sont acceptées :

  • mapTools=search
  • mapTools=mapSwitcher
  • mapTools=zoom
  • mapTools=home
  • mapTools=locate

Il est possible de définir plusieurs outils en séparant chaque valeur par une virgule, par exemple mapTools=search,locate.

La colonne body::esri:style accepte un paramètre height pour les questions de type carte.

Il est possible de définir la hauteur d’une question en indiquant un nombre pour le paramètre height et, éventuellement, une unité. L’unité par défaut est lines et fait référence à la hauteur de la police de texte de saisie actuelle. Ainsi, height=5 a pour effet d’afficher les questions sur une hauteur de cinq lignes.

Vous pouvez également définir l’unité sous la forme d’un pourcentage de la hauteur de l’écran, ou d’un nombre de pixels, en l’ajoutant en tant que suffixe à la valeur sans insérer d’espace. Toutes les valeurs suivantes, indiquées à titre d’exemple, sont acceptées :

  • height=5
  • height=5lines
  • height=25%
  • height=250pixels

Il est possible de définir la hauteur et les outils cartographiques en les séparant par un espace, par exemple height=25% mapTools=search,zoom.

Remarque :
Le contrôle de la hauteur et des outils cartographiques des questions n’est pas pris en charge dans l’application Web Survey123.