Configurer l’outil de recherche

La plupart des modèles ArcGIS Instant Apps offrent la possibilité de rechercher des localisations et des entités dans l’application. Un widget de recherche intégré dans l’interface utilisateur de l’application permet à un utilisateur de saisir des termes de recherche. Vous pouvez affiner les options de recherche afin que les utilisateurs de votre application obtiennent les résultats les plus pertinents.

Remarque :

Certains modèles ne prennent pas en charge les outils de recherche. reportez-vous aumatrice des outils d’application (PDF)pour voir quels modèles prennent en charge les outils de recherche.

Par ailleurs, certains modèles prennent en charge les outils de recherche, mais les affichent différemment de ce qui est indiqué dans cette documentation. C’est le cas par exemple des modèles Public Notification (Notification publique), Nearby (À proximité) et Zone Lookup (Recherche de zone).

Les sections ci-dessous expliquent comment configurer l’outil de recherche. Pour affiner les résultats de recherche, vous pouvez mettre à jour les localisateurs disponibles, ajouter un localisateur personnalisé vie une URL ou ajouter une source de recherche à partir des couches sur la carte.

Utiliser les paramètres de configuration de la recherche

Cette section explique comment configurer les paramètres de recherche de votre application. Par défaut, la source est ArcGIS World Geocoding Service.

Toutefois, si votre organisation a inscrit des localisateurs établis, tous les localisateurs établis spécifiés dans les paramètres de l’organisation apparaissent dans la liste des sources de recherche.

Pour ouvrir les paramètres de configuration, procédez comme suit :

1. Cliquez sur la section Interactivity (Interactivité).
2. Cliquez sur Search (Rechercher) pour ouvrir la section Search configuration (Rechercher une configuration).

   Dans la fenêtre des sources, vous voyez les sources actuellement actives pour le widget de recherche de votre application.

Modifier les sources

Dans les paramètres de configuration de la recherche, vous pouvez réorganiser l’ordre d’apparition des sources dans le widget de recherche de votre application. La source en haut de la liste est utilisée comme source par défaut lors du chargement de l’application. Si vous avez plusieurs sources, vous pouvez les trier en plaçant les plus pertinentes pour vos utilisateurs en haut de la liste.

Vous pouvez également supprimer des sources ou activer le bouton bascule All sources (Toutes les sources) pour que votre application effectue une recherche dans toutes les sources simultanément.

Paramètres de la source de recherche

Vous pouvez configurer divers paramètres pour chaque source. Cliquez sur le bouton des options en regard d’une source dans la liste, puis cliquez sur Edit (Mettre à jour) pour accéder aux paramètres pour chaque source de recherche.

Les paramètres des sources de recherche suivants peuvent être configurés :

• Locator name (Nom du localisateur) : attribuez un nom personnalisé à la source de recherche.
• Placeholder text (Texte de l’espace réservé) : spécifiez le texte prédéfini qui apparaît dans la zone de recherche avant la saisie d’une valeur à rechercher. Considérez-le comme une astuce textuelle.
• Zoom Scale (Échelle de zoom) : sélectionnez une échelle pour les résultats de recherche.
• Enable suggestions (Activer les suggestions) : si vous cochez cette case, les résultats potentiels apparaissent dans un menu lors de la saisie d’une valeur de recherche.
  • Maximum suggested characters (Nombre maximal de caractères suggérés) : définissez le nombre de caractères à saisir pour générer un résultat de recherche. La valeur par défaut est 3. Les champs de type entier nécessitent une correspondance parfaite.
  • Maximum suggestions (Nombre maximal de suggestions) : choisissez le nombe total de suggestions. Il est préférable de configurer une valeur inférieure à 5.
• Maximum results (Nombre maximal de résultats) : définissez la quantité maximale de résultats à renvoyer.
• Contraindre la recherche dans la carte : cochez cette case pour trouver uniquement les entités comprises dans l'étendue de la carte. Il s'agit de l'étendue enregistrée au niveau de la carte web.
• Country code(s) (Code[s] de pays) : vous pouvez saisir le code ISO 3166 officiel d’un pays ou d’une zone. Cela peut être utile si votre recherche renvoie des résultats qui se superposent dans plusieurs pays ou zones et que vous voulez les configurer de manière à privilégier un pays ou une zone en particulier. Vous pouvez ajouter plusieurs codes.

  Pour rechercher des codes de pays, vous pouvez parcourir la plateforme de recherche en ligne de l’ISO.

Affiner les résultats de la recherche

Les sections suivantes détaillent les options permettant d’affiner les résultats de la recherche.

Ajouter une source de recherche de localisateurs

Vous pouvez personnaliser votre propre localisateur et l’ajouter à votre application en tant que source de recherche. La personnalisation de votre propre localisateur offre davantage de précision dans les résultats de la recherche. Vous pouvez filtrer les types de localisations qui apparaissent, les régions ou les zones dans lesquelles effectuer la recherche, et même vos préférences de renvoi des noms de rue.

Pour ajouter un localisateur personnalisé, procédez comme suit :

1. Dans les paramètres Search configuration (Configuration de la recherche), cliquez sur Add a source (Ajouter une source).
2. Dans la section Search source (Source de recherche), sélectionnez Locator (Localisateur).
3. Dans le menu déroulant Set up source (Configurer une source), sélectionnez From URL (À partir d’une URL).
4. Saisissez l’URL de votre localisateur.

   Remarque :

   Vous la trouverez dans la vue d’ensemble du contenu de votre localisateur. Vous pouvez générer une URL courte pour créer un lien vers la page d’un élément.

5. Cliquez sur Add source (Ajouter une source).

   Le menu Edit (Mettre à jour) s’affiche.

6. Si vous le souhaitez, dans le menu Edit (Mettre à jour), modifiez les paramètres.
7. Cliquez sur Done (Terminé).

Ajouter une source de recherche de couches

Vous pouvez ajouter des sources de recherche supplémentaires, autres que des localisateurs. Vous pouvez utiliser les couches de votre carte comme source de recherche ou les couches de référence d’une URL qui ne sont pas sur la carte pour les utiliser comme source. Cela permet aux utilisateurs de votre application de rechercher une entité spécifique en fonction d’une valeur attributaire.

Remarque :

Si vous ajoutez une source de recherche de couches, seuls les résultats de recherche de couches sont renvoyés dans l’outil de recherche.

Pour configurer la recherche d’entités dans votre application, procédez comme suit :

1. Dans les paramètres Search configuration (Configuration de la recherche), cliquez sur Add a source (Ajouter une source).
2. Dans la section Search source (Source de recherche), sélectionnez Layer (Couche).
3. Dans le menu déroulant Set up source (Configurer une source), sélectionnez Map (Carte).
4. Cliquez sur la couche d’entités à définir comme source de recherche.
5. Sous Add search field (Ajouter un champ de recherche), cliquez sur le champ de recherche à utiliser comme source de la couche.

   Remarque :

   Sélectionnez au moins un champ. Vous pouvez sélectionner davantage de champs ultérieurement.

6. Cliquez sur Add source (Ajouter une source).

   Le menu Edit (Mettre à jour) s’affiche.

7. Configurez la valeur Display field (Champ d’affichage), qui détermine quel champ renseignera les résultats de la recherche.

   Si vous voulez utiliser plusieurs champs de recherche, vous pouvez sélectionner d’autres champs dans le menu déroulant Search fields (Champs de recherche).

8. Apportez d’autres modifications et configurez des options supplémentaires.
9. Cliquez sur Done (Terminé).

Désormais, lorsque l’outil de recherche trouve l’entité, celle-ci est mise en surbrillance sur la carte et une fenêtre contextuelle contenant des détails s’ouvre.