Cette fonction vous permet de faire une recherche de villes dans notre base de données. Cette base de données villes est sans cesse actualisée et contient environ 259639 codes postaux répartis sur 12 pays. France, Allemagne, Belgique, Luxembourg, Royaume-Uni, Espagne, Portugal, Suisse, Pays-Bas, Danemark, Norvège et Suède. Il arrive parfois qu’il en manque un, dans ce cas généralement un exploitant de l’entreprise nous contacte et nous ajoutons le code postal. Nous essayons d’être super réactifs sur ce point afin d’éviter d’éventuels dévoyés. Les communes nouvelles par exemple peuvent parfois manquer.
Attention il y a une petite particularité sur le Royaume-Uni car les codes postaux anglais peuvent contenir des lettres. De plus il y a tellement de codes postaux pour ce pays que l’on peut dire que c’est la liste la moins complète de toutes.
Cette requête comporte plusieurs possibilités de recherche. Voici le modèle en GET :
{pays=[PAYS]}{&code-postal=[DEP|CODE_POSTAL]}{&ville=[VILLE]}
Il est possible de rechercher soit :
- En indiquant le Pays (FR, GB|UK, DE, BE, PT, LU, ES|SP, CH, SE, NO, DK, NL).
- En indiquant seulement le département. Dans ce cas une recherche par défaut sur la France est exécutée.
- En indiquant un code postal complet. Ce qui va rechercher le code postal exact quel que soit le pays.
- En indiquant le nom de la ville. Sans accent.
- Ou encore avec tous les paramètres en même temps pour une recherche plus fine. Sauf département et code postal qui sont soit l’un soit l’autre.
Attention si la requête est trop imprécise, seuls les 30 premiers résultats sont retournés.
Dans notre système, le « ST » est écrit « SAINT ». Si vous transmettez une offre dans notre système et que la ville n’est pas reconnue, un astérisque « * » est automatiquement ajouté à la fin de son nom. Ce n’est cependant pas une erreur bloquante.
Voici un exemple de valeurs retournées lors d’une recherche :
{
"status": "OK",
"description": "OK",
"results": {
"count": 3,
"villes": [
{
"pays": "FR",
"code_postal": "68200",
"ville": "BOURTZWILLER"
},
{
"pays": "FR",
"code_postal": "68200",
"ville": "DORNACH"
},
{
"pays": "FR",
"code_postal": "68200",
"ville": "MULHOUSE"
}
]
}
}
Voici le modèle en POST :
{
"pays": %text(2)%,
"code_postal": %text(5)%,
"ville": %text%
}
Dernière mise à jour le 12/10/2021.