documentation

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.

Le service autocomplétion de la Géoplateforme est accessible au travers des URLs suivantes :

https://data.geopf.fr/geocodage/completion

GetCapabilities :

https://data.geopf.fr/geocodage/completion/getCapabilities

Pour le service d’autocomplétion de la Géoplateforme, les fonctionnalités et les paramètres de l’API sont les mêmes que celles de la version 2.0 de l’API d’autocomplétion du Géoportail, disponible depuis juillet 2022.

Les paramètres des requêtes (en entrée) ne changent pas, et le contenu des réponses est identique.

Les types de données interrogées (paramètre « type ») restent les mêmes que le service Géoportail :

• StreetAddress pour la recherche par adresse
• PositionOfInterest pour la recherche par lieu et unité administrative

La bascule vers ces nouveaux services sera donc simple.

Différences à noter :

• Changement d’URL :

  • Comme pour les autres géoservices, l’URL d’accès change, l’URL définitive à prendre en compte est celle au-dessus.

    exemple : au lieu de https://wxs.ign.fr/calcul/geoportail/geocodage/rest/0.1/completion nous aurons https://data.geopf.fr/geocodage/completion

• L'appel au nouveau service se fait dans l’esprit Opendata de la Géoplateforme c’est à dire sans clé ou contrôle d’accès.

• Les messages d’erreurs évoluent :

  • autocomplétion sans localisation à rechercher (paramètre text= absent ou vide) retourne maintenant l’erreur "detail" : ["text is a required parameter"] (pour le service Géoportail, l’erreur était "detail" : ["Error: Missing [text] parameter"])