.. Authors :
.. mviewer team

.. _configsearch:

Configurer - La recherche
=================================

Recherche d'adresse via olscompletion
-------------------------------------

Liens vers service d'autocomplétion et de géocodage d'adresses.

**Syntaxe**

.. code-block:: xml
       :linenos:

	   <olscompletion url="" type="" attribution="" />

**Attributs**

* ``url``: URL du service d'autocomplétion ou de géocodage de l'IGN. Voir les services disponibles :  https://geoservices.ign.fr/services-geoplateforme-geocodage-autocompletion
* ``type``: Option - Type de service utilisé "completion" ou "search". Defaut = "completion"
* ``attribution``: Attribution du service de geocodage.

**Exemple**

.. code-block:: xml
       :linenos:

       <olscompletion url="https://data.geopf.fr/geocodage/search" 
	   type="search" 
	   attribution="La recherche d'adresse est un service de l'IGN via la BAN"/>


Recherche d'entités
--------------------------

2 possibilités sur mviewer :

* ":ref:`configels`"
* ":ref:`configfuse`"

Paramétrage des recherches
--------------------------

Options liées à la recherche d'adresse *(olscompletion)* et/ou à la recherche d'entités *(elasticsearch ou fuse)*.

**Syntaxe**

.. code-block:: xml
       :linenos:

	<searchparameters
              marker=""
              imgurl=""
              imgwidth=""
              svgcolor=""
              bbox=""
              inputlabel=""
              localities=""
              features=""
              static=""
              querymaponclick=""
              closeafterclick=""
              animate=""
              duration=""
              searchmaxzoomlevel=""/>

**Attributs**

* ``localities`` *(optionnel)* : Utilisation du service d'adresse olscompletion : true ou false (defaut = true).
* ``features`` *(optionnel)* : Utilisation du service de recherche d'entités elasticsearch ou fuse : true ou false (defaut = true).
* ``bbox`` *(optionnel)* : Recherche d'adresse et/ou d'entitées limitée à l'emprise de la carte : true ou false (defaut = false). Avec un service olscompletion de type ``completion`` les résultats sont filtrés à l'intérieur de l'emprise ; pour les autres types (``search``/BAN) la bbox sert uniquement à ordonner la réponse.
* ``querymaponclick`` *(optionnel)* : Interroge la carte après sélection d'un résultat dans la liste : true ou false - defaut = false.
* ``marker`` *(optionnel)* : Afficher ou non un icône sur le résultat de la recherche d'adresse : true ou false (defaut = true).
* ``static`` *(optionnel)* : En lien avec le paramètre doctypes. Active ou désactive la recherche associée à des documents requêtés systématiquement, indépendamment des couches affichées : true ou false (defaut = false).
* ``inputlabel`` *(optionnel)* : Texte à utiliser pour le placeholder de la zone de saisie de la barre de recherche. default = "Rechercher".
* ``closeafterclick`` *(optionnel)* : Ferme la liste des résultats de recherche après avoir sélectionné un item : true ou false - defaut = false.
* ``animate`` *(optionnel)* : Active ou désactive l'animation de la vue lorsqu'un résultat de recherche est sélectionné : true ou false (defaut = true).
* ``duration`` *(optionnel)* : Durée en ms de l'animation définie dans l'option 'animate' (defaut = 2000).
* ``imgurl`` *(optionnel)* : Url de l'image PNG / JPEG à afficher à l'emplacement du résultat sélectionné en guise de pointeur.
* ``imgwidth`` *(optionnel)* : Taille de l'image (voir paramètre imgurl) du pointeur représentant le résultat sélectionné.
* ``svgcolor`` *(optionnel)* : Couleur du pointeur représentant la localisation du résultat sélectionné.
* ``searchmaxzoomlevel`` *(optionnel)* : Définit le niveau de zoom maximal appliqué lors d'une recherche ELS ou fuse (valeur par défaut = 15) Pour une géométrie de type polygone ou multi-polygone, le zoom est calculé selon l'étendue.

.. figure:: ../_images/dev/config_search/option-animate.gif
            :alt: activation de l'option animate
            :align: center

            Activation de l'option **animate**.