Premières requêtes
Sans compte ni clé : l'URL suffit.
curl 'https://api.wymmo.dev/geocodage/search?q=8+rue+des+jardins+metz&limit=3'
curl 'https://api.wymmo.dev/geocodage/reverse?lon=6.1767&lat=49.1208'
curl 'https://api.wymmo.dev/geocodage/completion?text=rue+des+jar&type=StreetAddress'
curl 'https://api.wymmo.dev/geocodage/search?q=metz&limit=2&index=poi'
curl 'https://api.wymmo.dev/geocodage/search?index=parcel&q=57463000240142'
curl -F [email protected] -F columns=adresse 'https://api.wymmo.dev/geocodage/search/csv'
Migrer depuis la Géoplateforme
Seul le domaine change, data.geopf.fr devient api.wymmo.dev : les chemins, /geocodage compris, sont ceux de l'IGN.
| Chez l'IGN | Chez wymmo.dev |
https://data.geopf.fr/geocodage/search?… | https://api.wymmo.dev/geocodage/search?… |
/reverse, /completion, /search/csv, /reverse/csv, /getCapabilities | les mêmes chemins, sous https://api.wymmo.dev/geocodage |
Écarts connus
Pas encore servi : l'API asynchrone /async et les réponses 304 (ETag).
Répond autrement, exprès :
- pendant les quelques secondes qui suivent un redémarrage, une requête peut répondre
503, y compris sur /completion et les fichiers CSV, au lieu d'un 200 en erreur ;
- un fichier CSV trop gros répond
413, un formulaire mal formé 400 ; les colonnes de sortie gardent l'ordre du fichier ;
depcode filtre vraiment en géocodage inverse ; un numéro de rue sans sa voie est écarté au lieu de faire échouer la requête ;
- les paramètres répétés (
q[]=) ne sont pas lus comme des listes ;
- l'ordre des membres d'un objet JSON n'est pas promis, et un très petit nombre peut s'écrire avec un exposant : la même valeur, que tout lecteur JSON relit ;
getCapabilities décrit wymmo.dev et ce qu'il sert.
Limites
Jusqu'à 50 résultats par recherche (20 avec returntruegeometry), 10 par défaut ; un cercle de 500 m au plus en géocodage inverse ; des fichiers CSV de 50 Mio et 200 000 lignes au plus.