Guide d’utilisation

Extension de recherche de lieux (géocodage) utilisant l’API de la Base Adresse Nationale de la France https://geo.api.gouv.fr/adresse/.

Cette extension permet d’activer la recherche de lieu par adresse dans la barre de recherche universelle de QGIS (Localisateur).

Utilisation

  1. taper librement une recherche d’adresse dans la barre de recherche (en bas à gauche de la fenêtre QGIS)

  2. Sélectionner un résultat. Double clic ou entrée déplace la carte sur l’adresse retenue

Recherche d'adresse dans QGIS

Notes

Préfixe

Taper le préfixe fra permet de ne rechercher que des adresses fournies par ce service (et évite de rechercher les autres objets indexés par la barre Localisateur).

Zooms prédéfinis

L’API ne renvoie pas d’emprise permettant de zoomer exactement. Les zooms prédéfinis sont pré-définis en fonction du type de résultat :

  • 1/25 000 (ville)

  • 1/5000 (rue)

  • 1/2000 (adresse précise)


Réglages

Les réglages utilisés par le plugin sont intégrés au menu des Préférences de QGIS :

Settings of French Locator Filter

Certaines informations ne sont pas modifiables par l’utilisateur final.

Variables d’environnement

Ces paramètres peuvent être définis via des variables d’environnement. Ceci permet une configuration du plugin directement par la Direction des Systèmes d’Information (DSI).

Le tableau suivant reprend les paramètres disponibles avec la variable d’environnement associée et la valeur par défaut:

Paramètre

Variable d’environnement

Valeur par défaut

URL requête API BAN

QGIS_FRENCH_LOCATOR_REQUEST_URL

https://api-adresse.data.gouv.fr/search/

Paramètre par défaut requête API BAN

QGIS_FRENCH_LOCATOR_REQUEST_URL_QUERY

limit=10&autocomplete=1

URL requête API Photon

QGIS_FRENCH_LOCATOR_REQUEST_PHOTON_URL

https://photon.komoot.io/api/

Paramètre par défaut requête API Photon

QGIS_FRENCH_LOCATOR_REQUEST_PHOTON_URL_QUERY

limit=10&lang=fr