Action « Géolocaliser »
- être issues des champs « Carte » ou « Fichier » (métadonnées attachées à une photographie)
- être géocodées depuis une adresse.
Géocodage à partir d'une adresse
- dans l'action de workflow choisir « Adresse »
- rentrer en paramètres les données d'une adresse présente dans la demande (cette adresse sera géocodée via une API - Nominatim ou une éventuelle API fournie avec le SIG de la collectivité). Le champ « Adresse » doit donc être complété comme suit : {{form_var_numero}} {{form_var_voie}}, {{form_var_commune}}
Pour optimiser le résultat du géocodage, il est possible d'ajouter le code postal, le n°, voire l'intitulé de la voie, etc. Si certains champs sont facultatifs dans le formulaire, et qu'il ne sont pas remplis par l'usager, il convient d'envoyer à l'API une valeur vide et non "None". Il faut donc filtrer ces données facultatives avec |default : {{form_var_num_rue|default:""}} {{form_var_adresse|default:""}}, {{form_var_code_postal}} {{form_var_ville}}
Géocodage à partir des données « latitude » et « longitude » issues d'un champ « Carte »
Dans ce cas ce sont les données « latitude » et « longitude » issues d'un champ de type « Carte » qui sont récupérées.
- dans l'action de workflow choisir « Nom de la variable carte ».
- Remplir ce paramètre avec une expression de type 'gabarit' faisant référence au champ « Carte ». Exemple : Si la carte concernée a pour identifiant « carte » alors l'expression à indiquer est {{form_var_carte}}.
Géocodage à partir des données « latitude » et « longitude » issues d'une photographie
- dans l'action de workflow choisir « Nom de la variable photo »
- le paramètre est une expression pointant une variable tirée d'un champ de type « Fichier » ; le fichier ainsi pointé doit être une image contenant des métadonnées EXIF géographiques. Le champ « Nom de la variable photo » doit être complété avec l'identifiant du champ concerné comme suit : {{ form_var_photo_raw }}
Écraser la géolocalisation existante
« Écraser la géolocalisation existante » permet de ré-attribuer des coordonnées géographiques en cas de succession de plusieurs actions « Géolocalisation », il faut alors ordonner ces actions de la moins précise à la plus précise.
Exemple : une première action « Géolocalisation » va attribuer des coordonnées géographiques depuis le curseur positionné par l'internaute dans une carte du formulaire (potentiellement un champ obligatoire) puis une deuxième action « Géolocalisation » écrasera ces coordonnées, précédemment enregistrées, avec des coordonnées calculées depuis les méta-données EXIF d'une photographie uploadée avec le formulaire (potentiellement un champ optionnel). Bien évidemment dans ce cas, si aucune photo n'est présente dans le formulaire, les coordonnées restent inchangées, ce seront celles du pointeur sur la carte.