documentation

Le service de géocodage direct permet de fournir les coordonnées géographiques d’une adresse postale, d’un lieu ou de parcelles cadastrales à partir d’une requête HTTP.

Le service de géocodage inverse a pour but de retourner, à partir d’un ou plusieurs points géographiques indiqués en latitude/longitude, la ou les entités géolocalisées les plus proches correspondantes, parmi les adresses, toponymes, parcelles cadastrales, et/ou unités administratives.

Le service géocodage est disponible au travers des URLs suivantes :

Géocodage direct :

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

Géocodage inverse :

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

GetCapabilities :

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

Pour les services de géocodage direct et inverse Géoplateforme, les fonctionnalités et les paramètres de l’API sont les mêmes que celles de la version 2.0 du service de géocodage du Géoportail, disponible depuis juillet 2022.

Les paramètres des requêtes (en entrée) ne changent pas, seules quelques différences (mineures) sont constatées sur le contenu des réponses, et les géométries utilisées en entrée du géocodage inverse (cf. ci-dessous).

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

• address pour la recherche par adresse
• parcel pour la recherche par parcelle cadastrale
• poi pour la recherche par lieu et unité administrative

La bascule vers ces nouveaux services sera donc assez simple, en particulier pour le géocodage direct.

Différences à noter :

• Changement d’URL :

  • Comme pour les autres géoservices, les URL d’accès changent, les URL définitives à prendre en compte sont celles ci-dessus.

    ex. au lieu de https://wxs.ign.fr/calcul/geoportail/geocodage/rest/0.1/reverse?, on aura https://data.geopf.fr/geocodage/reverse

  • 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.

• Valeurs des paramètres en entrée :

  • Dans le cas d’un géocodage inverse sur une emprise (paramètre « searchgeom ») :
    • La taille maximale de la géométrie est réduite : limite à 1000m pour le plus grand côté du rectangle d’emprise de la géométrie (au lieu de 2000m sur le service Géoportail)

  • La géométrie de type « polygone » doit être décrite dans le sens horaire uniquement

  • Pour des raisons de compatibilité avec l’API de recherche d’adresses, la capacité de recherche d’une parcelle cadastrale sans son préfixe, notamment dans le cas des villes à arrondissements, n’est plus offerte. La recherche de parcelle doit s’effectuer suivant la typologie de dénomination des parcelles de la DGFIP et en précisant le préfixe le cas échéant.
    • Exemple de dénomination de parcelle sans préfixe : 69035000AB0169 (parcelle de la mairie de Cenves 69035)
    • Exemple de dénomination de parcelle avec préfixe : 132088430N0001 (parcelle de la mairie du 08e arrondissement de Marseille)

• Changements constatés dans les réponses retournées :

  • Paramètres de la réponse, pour le géocodage inverse :

    • Lors d’un géocodage inverse d’adresses ou POI, le score est maintenant retourné dans le paramètre « score » (au lieu de « _score » pour le service Géoportail)
    • Lors d’un géocodage inverse sur l’index « poi » (point d’intérêt), les champs « city » et « citycode » ne sont plus présents dans la réponse s’ils sont vides.
    • Lors d’un géocodage inverse de POI, la réponse retourne désormais des paramètres « classification », « territory » et « importance »

  • Valeurs retournées dans la réponse :

    • Lors d’un géocodage direct de parcelles (index=parcel) : le paramètre « _type » retourné n’est plus « cadastral » mais « parcel »
    • Lors d’un géocodage direct d’adresses : le paramètre « _type » retourné n’est plus « ban » mais « address »
    • Lors d’un géocodage inverse, le champ « distance » de la réponse est arrondi au mètre près (et non plus une distance exacte comme c’était le cas pour le service Géoportail)

  • Les messages d’erreurs évoluent :

    • Lors d’un géocodage direct sans localisation à rechercher (paramètre q= absent ou vide) retourne maintenant l’erreur "q is a required parameter" (pour le service Géoportail, l’erreur était "Error: Missing [q] parameter")
    • En cas de valeurs aberrantes de latitude ou longitude en entrée d’un géocodage normal ou inverse, les APIs renvoient maintenant une erreur