IGN

Géoservices IGN

Autocomplétion

Dernière mise à jour : 1 Mars 2017

Table des matières

Généralités

Le service d’autocomplétion a pour but de suggérer des localisants probables au fur et à mesure de la saisie d’adresses ou de noms de lieux.

Les données de référence utilisées au sein du service d’autocomplétion proviennent de la base de données IGN BD ADRESSE® pour les suggestions d’adresses, du thème Toponymes de la base de données IGN BD TOPO® pour les suggestions de noms de lieux.

Connexion au service d’autocomplétion du Géoportail

Le service d’autocomplétion est accessible à l’adresse suivante :

http(s)://wxs.ign.fr/CLEF/ols/apis/completion?

Le paramètre CLEF doit être remplacé par votre clef d’accès à la plateforme Géoportail

Chaque type d’autocomplétion est associé à une ressource à laquelle la clef d’accès doit être associée. La liste des ressources est disponible ici.

Requête d’autocomplétion

Les requêtes sont des requêtes HTTP / GET. Elles peuvent comprendre les paramètres suivants :

Exemple de requête:

Autocomplétion par adresse :

http://wxs.ign.fr/VOTRE_LICENCE/ols/apis/completion?text=2%2C%20avenue%20pasteur%20saint%20m&type=StreetAddress&maximumResponses=5

Réponse

La réponse du service est, en cas de succès, au format JSON:

{"status":"OK",
 "results":[{"country":"StreetAddress",
             "city":"Saint-Malo",
             "x":-2.004141,
             "y":48.655722,
             "zipcode":"35400",
             "street":"2 av pasteur",
             "classification":7,
             "kind":"",
             "fulltext":"2 av pasteur,35400 Saint-Malo"},
             ...
           ]
}

où :

En cas d’erreur du service (code HTTP différent de 200), la réponse est au format JSON. Par exemple :

{"status":"ERROR","results":[]}

NB : les suggestions retournées sont associées à des coordonnées géographiques. Le service d’autocomplétion peut aussi être utilisé pour faire du Géocodage. Cependant, il est moins performant en terme de pertinence des résultats que le service de Géocodage du Géoportail.