Autocomplétion de commune — Démo interactive
Recherche par nom, code postal ou code INSEE. Tolérante aux fautes, basée sur le COG INSEE officiel.
-
Wimereux
62930Pas-de-Calais (62) · Hauts-de-France · INSEE 62893
- Population
- 6 307 hab. (2022)
- Superficie
- 8 km² · 826 ha
- Altitude
- 0–71.0 m
- Densité INSEE
- 4 Ceintures urbaines
Évolution population : 7 312 (2011) → 6 795 (2016) → 6 307 (2022)
L6 : 62930 WIMEREUX
curl -X GET "https://api.trustydata.app/services/v1/locality/autocomplete?q=wimereux&limit=10" \
-H "Authorization: Bearer VOTRE_CLE_API"import requests
url = "https://api.trustydata.app/services/v1/locality/autocomplete"
headers = {"Authorization": "Bearer VOTRE_CLE_API"}
params = {"q": "wimereux", "limit": 10}
response = requests.get(url, headers=headers, params=params)
print(response.json()){
"choices": [
{
"code_postal": "62930",
"cog": {
"arr": "623",
"can": "6213",
"comparent": "",
"ctcd": "62D",
"insee": "62893",
"libelle": "Wimereux",
"nom_majus": "WIMEREUX",
"nom_riche": "Wimereux",
"type": "COM"
},
"density": {
"code": 4,
"label": "Ceintures urbaines"
},
"departement": {
"chef_lieu": "62041",
"id": "62",
"libelle": "Pas-de-Calais",
"nom_majus": "PAS DE CALAIS",
"nom_riche": "Pas-de-Calais",
"population": [
{
"comptee_a_part": 21303,
"municipale": 1460184,
"periode": 2022,
"totale": 1481487
},
{
"comptee_a_part": 23605,
"municipale": 1470725,
"periode": 2016,
"totale": 1494330
},
{
"comptee_a_part": 27707,
"municipale": 1462807,
"periode": 2011,
"totale": 1490514
}
]
},
"destination": "62930 WIMEREUX",
"elevation": {
"average": 24.0,
"max": 71.0,
"min": 0.0
},
"id": 27238,
"ligne_5": "",
"ligne_6": "WIMEREUX",
"nom_commune": "WIMEREUX",
"population": [
{
"comptee_a_part": 131,
"municipale": 6307,
"periode": 2022,
"totale": 6438
},
{
"comptee_a_part": 178,
"municipale": 6795,
"periode": 2016,
"totale": 6973
},
{
"comptee_a_part": 180,
"municipale": 7312,
"periode": 2011,
"totale": 7492
}
],
"position": {
"lat": 50.78028171139647,
"lon": 1.614473436929318
},
"region": {
"chef_lieu": "59350",
"id": "32",
"libelle": "Hauts-de-France",
"nom_majus": "HAUTS DE FRANCE",
"nom_riche": "Hauts-de-France",
"population": [
{
"comptee_a_part": 90034,
"municipale": 5998916,
"periode": 2022,
"totale": 6088950
},
{
"comptee_a_part": 103718,
"municipale": 6006870,
"periode": 2016,
"totale": 6110588
},
{
"comptee_a_part": 116089,
"municipale": 5960124,
"periode": 2011,
"totale": 6076213
}
]
},
"score": 1.0,
"surface": {
"hectare": 826,
"km2": 8
}
}
],
"count": 1,
"message": "Search completed successfully",
"status": "OK"
}Comprendre la réponse
L'API /locality/autocomplete renvoie les communes correspondant à votre saisie, classées
par pertinence. Chaque résultat comprend plusieurs blocs de données officielles :
- Identifiants : code INSEE (
code_insee), code postal, nom complet et nom riche (avec article et particule, ex. « La Seyne-sur-Mer »). - Rattachement administratif : département (code + nom), région (code + nom). Utile pour filtrer vos données ou produire des tableaux de bord géographiques.
- Population : effectif municipal récent (INSEE) et 2–3 millésimes historiques pour identifier les tendances démographiques.
- Superficie : en km² et en hectares, pratique pour calculer la densité ou pondérer des indicateurs socio-économiques.
- Altitude : min et max sur le territoire communal.
- Grille de densité INSEE : code de 1 (très densément peuplée) à 7 (commune rurale à habitat très dispersé). Utilisée par l'INSEE pour publier des indicateurs territoriaux.
- Ligne 6 postale (
destination) : dénomination officielle à inscrire sur l'enveloppe, qui peut différer dunom_communeen cas de commune déléguée ou de Cedex.
Cas pluri-résultats : un code postal peut couvrir plusieurs communes (ex. 95690
pour Nesles-la-Vallée et voisines). L'API renvoie alors la liste complète, à vous de proposer le bon choix.