Structure de la base de données

Consultez les villes, leurs noms, subdivisions administratives, populations et coordonnées, avec la provenance des données.

L’API gratuite expose les 5 000 villes dont le champ population est le plus élevé dans cette version de la base. Cette sélection mondiale reste fixe : filtrer par pays ne l’élargit pas.

Sur AffectionPlus.com, les widgets affichés dans les pages consultent toute la base, même sans abonnement. Sur un autre site, le widget est limité à la sélection gratuite, sauf si ce site utilise un jeton émis avec un abonnement éligible actif.

Structure de la base de données

Une seule ligne par ville, identifiée par id. Les colonnes courantes sont dans villes ; les caractéristiques complémentaires sont dans caracteristiques, reliées par le même id. Les informations absentes restent nulles et les codes textuels conservent leurs zéros initiaux.

Les populations n’ont pas toutes la même année ni le même périmètre. Le classement utilise population, sans lui substituer une estimation d’agglomération.

Les caractéristiques identiques partagées par plusieurs villes sont regroupées dans caracteristiques_communes et reliées par profil_id. Les profils ne créent aucune ville supplémentaire.

L’export contient 1 371 405 villes. Comptez environ 140 Mo pour le fichier compressé et 1,37 Go après restauration, index compris. PostgreSQL avec l’extension pg_trgm est requis.

createdb world_cities
gzip -dc world-cities.sql.gz | psql -X -v ON_ERROR_STOP=1 -d world_cities
psql -d world_cities -c 'SELECT count(*) FROM villes;'

villes.id = caracteristiques.id
caracteristiques.profil_id = caracteristiques_communes.id

public_cities · city_search · export_scopes · metadata

Propriété	Type	Colonne SQL	Description
`admin1`	`string`	`villes.admin1`	Nom de la division administrative de 1er niveau (région, État, Land, province). Source : GeoNames admin1CodesASCII et API Géo / INSEE (France).
`admin1_code`	`string`	`villes.admin1_code`	Code administratif composite de niveau 1 (GeoNames ou préfixe INSEE:). Source : GeoNames / INSEE.
`admin1_de`	`string`	`caracteristiques_communes.admin1_de`	Nom de la division administrative de premier niveau en allemand.
`admin1_en`	`string`	`caracteristiques_communes.admin1_en`	Nom de la division administrative de premier niveau en anglais.
`admin1_es`	`string`	`caracteristiques_communes.admin1_es`	Nom de la division administrative de premier niveau en espagnol.
`admin1_fr`	`string`	`caracteristiques_communes.admin1_fr`	Nom de la division administrative de premier niveau en français.
`admin1_geonames_id`	`string`	`caracteristiques_communes.admin1_geonames_id`	Identifiant GeoNames propre à la région / division de 1er niveau. Source : GeoNames admin1CodesASCII.
`admin1_iso_code`	`string`	`caracteristiques_communes.admin1_iso_code`	Code officiel ISO 3166-2 de la région ou de l'État fédéré (ex. FR-ARA, US-CA, DE-BY). Source : Wikidata (propriété P300 associée au GeoNames ID de la région).
`admin1_it`	`string`	`caracteristiques_communes.admin1_it`	Nom de la division administrative de premier niveau en italien.
`admin1_nl`	`string`	`caracteristiques_communes.admin1_nl`	Nom de la division administrative de premier niveau en néerlandais.
`admin1_pl`	`string`	`caracteristiques_communes.admin1_pl`	Nom de la division administrative de premier niveau en polonais.
`admin1_pt`	`string`	`caracteristiques_communes.admin1_pt`	Nom de la division administrative de premier niveau en portugais.
`admin1_tr`	`string`	`caracteristiques_communes.admin1_tr`	Nom de la division administrative de premier niveau en turc.
`admin2`	`string`	`villes.admin2`	Nom de la division administrative de 2e niveau (département, comté, district). Source : GeoNames admin2Codes et API Géo / INSEE (France).
`admin2_code`	`string`	`villes.admin2_code`	Code administratif composite de niveau 2 (GeoNames ou préfixe INSEE:). Source : GeoNames / INSEE.
`admin2_de`	`string`	`caracteristiques_communes.admin2_de`	Nom de la division administrative de deuxième niveau en allemand.
`admin2_en`	`string`	`caracteristiques_communes.admin2_en`	Nom de la division administrative de deuxième niveau en anglais.
`admin2_es`	`string`	`caracteristiques_communes.admin2_es`	Nom de la division administrative de deuxième niveau en espagnol.
`admin2_fr`	`string`	`caracteristiques_communes.admin2_fr`	Nom de la division administrative de deuxième niveau en français.
`admin2_geonames_id`	`string`	`caracteristiques_communes.admin2_geonames_id`	Identifiant GeoNames propre au département / division de 2e niveau. Source : GeoNames admin2Codes.
`admin2_it`	`string`	`caracteristiques_communes.admin2_it`	Nom de la division administrative de deuxième niveau en italien.
`admin2_nl`	`string`	`caracteristiques_communes.admin2_nl`	Nom de la division administrative de deuxième niveau en néerlandais.
`admin2_pl`	`string`	`caracteristiques_communes.admin2_pl`	Nom de la division administrative de deuxième niveau en polonais.
`admin2_pt`	`string`	`caracteristiques_communes.admin2_pt`	Nom de la division administrative de deuxième niveau en portugais.
`admin2_tr`	`string`	`caracteristiques_communes.admin2_tr`	Nom de la division administrative de deuxième niveau en turc.
`administrative_role`	`string`	`caracteristiques_communes.administrative_role`	Rôle administratif normalisé (national_capital, admin1_seat, admin2_seat…). Source : Déduit du feature_code GeoNames.
`administrative_role_de`	`string`	`caracteristiques_communes.administrative_role_de`	Libellé du rôle administratif en allemand.
`administrative_role_en`	`string`	`caracteristiques_communes.administrative_role_en`	Libellé du rôle administratif en anglais.
`administrative_role_es`	`string`	`caracteristiques_communes.administrative_role_es`	Libellé du rôle administratif en espagnol.
`administrative_role_fr`	`string`	`caracteristiques_communes.administrative_role_fr`	Libellé du rôle administratif en français.
`administrative_role_it`	`string`	`caracteristiques_communes.administrative_role_it`	Libellé du rôle administratif en italien.
`administrative_role_nl`	`string`	`caracteristiques_communes.administrative_role_nl`	Libellé du rôle administratif en néerlandais.
`administrative_role_pl`	`string`	`caracteristiques_communes.administrative_role_pl`	Libellé du rôle administratif en polonais.
`administrative_role_pt`	`string`	`caracteristiques_communes.administrative_role_pt`	Libellé du rôle administratif en portugais.
`administrative_role_tr`	`string`	`caracteristiques_communes.administrative_role_tr`	Libellé du rôle administratif en turc.
`alternate_names`	`json`	`caracteristiques.alternate_names`	Liste JSON des variantes orthographiques, exonymes et translittérations connus. Source : GeoNames alternateNamesV2 et données initiales.
`area_km2`	`number`	`caracteristiques.area_km2`	Superficie en kilomètres carrés (km²). Source : API Géo / INSEE (hectares convertis en km²) et Wikidata (P2046).
`area_scope`	`string`	`caracteristiques.area_scope`	Entité exacte couverte par la superficie (commune:<INSEE> ou wikidata_entity:<QID>). Source : API Géo / Wikidata.
`area_source`	`string`	`caracteristiques.area_source`	Référentiel ayant fourni la superficie (geo-fr:<INSEE> ou wd:<QID>). Source : API Géo / Wikidata.
`continent`	`string`	`caracteristiques_communes.continent; lang → caracteristiques_communes.continent_en, caracteristiques_communes.continent_de, caracteristiques_communes.continent_es, caracteristiques_communes.continent_it, caracteristiques_communes.continent_pt, caracteristiques_communes.continent_nl, caracteristiques_communes.continent_pl, caracteristiques_communes.continent_tr`	Nom du continent dans la langue demandée par lang ; repli français. Source : ONU M49 / CLDR.
`continent_code`	`string`	`caracteristiques_communes.continent_code`	Code du continent à deux lettres (EU, AS, AF, NA, SA, OC, AN). Source : GeoNames countryInfo.txt.
`coordinate_match_distance_km`	`number`	`caracteristiques.coordinate_match_distance_km`	Distance en kilomètres entre la coordonnée source et le lieu GeoNames rapproché. Source : Calcul géodésique (formule de Haversine) lors du rapprochement.
`coordinate_match_status`	`string`	`caracteristiques.coordinate_match_status`	Statut de confiance du rapprochement par coordonnées (name_agrees, coordinates_unique, coordinates_guess, geonames_direct). Source : Pipeline de contrôle géographique AffectionPlus.
`coordinate_source`	`string`	`caracteristiques_communes.coordinate_source`	Source des coordonnées GPS : OpenStreetMap lorsque longitude et latitude sont renseignées. Source : OpenStreetMap (sous licence ODbL).
`country`	`string`	`villes.country`	Alias de country_code : code ISO 3166-1 alpha-2 du pays ou territoire.
`country_code`	`string`	`villes.country`	Code pays ou territoire ISO 3166-1 alpha-2 (ex. FR, GB, DK, GL). Source : GeoNames et contexte national vérifié.
`country_code_iso3`	`string`	`caracteristiques_communes.country_code_iso3`	Code pays normalisé ISO 3166-1 alpha-3 à trois lettres (ex. FRA, GBR, DNK). Source : GeoNames countryInfo.txt.
`country_name`	`string`	`villes.country_name; lang → villes.country_name_en, villes.country_name_de, villes.country_name_es, villes.country_name_it, villes.country_name_pt, villes.country_name_nl, villes.country_name_pl, villes.country_name_tr`	Nom du pays dans la langue demandée par lang ; repli français. Source : CLDR / Babel.
`country_tld`	`string`	`caracteristiques_communes.country_tld`	Domaine Internet national de premier niveau ccTLD (ex. .fr, .uk, .dk). Source : GeoNames countryInfo.txt.
`currency_code`	`string`	`caracteristiques_communes.currency_code`	Code devise officiel ISO 4217 du pays ou territoire (ex. EUR, USD, GBP, DKK). Source : GeoNames countryInfo.txt.
`data_sources`	`string`	`caracteristiques.data_sources`	Liste séparée par ';' de toutes les sources mobilisées pour construire la ligne. Source : Journal de provenance par ligne (osm, gn, wd, insee-2023, geo-fr, cldr, un-m49, iso-3166-2).
`demonym_de`	`string`	`caracteristiques.demonym_de`	Gentilé attesté en allemand.
`demonym_en`	`string`	`caracteristiques.demonym_en`	Gentilé attesté en anglais.
`demonym_es`	`string`	`caracteristiques.demonym_es`	Gentilé attesté en espagnol.
`demonym_fr`	`string`	`caracteristiques.demonym_fr`	Gentilé attesté en français. Source : Wikidata P1549.
`demonym_it`	`string`	`caracteristiques.demonym_it`	Gentilé attesté en italien.
`demonym_nl`	`string`	`caracteristiques.demonym_nl`	Gentilé attesté en néerlandais.
`demonym_pl`	`string`	`caracteristiques.demonym_pl`	Gentilé attesté en polonais.
`demonym_pt`	`string`	`caracteristiques.demonym_pt`	Gentilé attesté en portugais.
`demonym_scope`	`string`	`caracteristiques.demonym_scope`	Périmètre d'application du gentilé (ville ou commune). Source : Wikidata / INSEE.
`demonym_source`	`string`	`caracteristiques.demonym_source`	Identifiant de l'entité Wikidata source du gentilé. Source : Wikidata.
`demonym_tr`	`string`	`caracteristiques.demonym_tr`	Gentilé attesté en turc.
`demonyms_local`	`json`	`caracteristiques.demonyms_local`	Objet JSON de toutes les formes de gentilés attestées par code de langue. Source : Wikidata (P1549).
`density_km2`	`number`	`caracteristiques.density_km2`	Densité d'habitants par km² (calculée uniquement si population datée et superficie ont le même périmètre). Source : Calcul vérifié sur [population] / [area_km2].
`department`	`string`	`villes.admin2; lang → caracteristiques_communes.admin2_en, caracteristiques_communes.admin2_de, caracteristiques_communes.admin2_es, caracteristiques_communes.admin2_it, caracteristiques_communes.admin2_pt, caracteristiques_communes.admin2_nl, caracteristiques_communes.admin2_pl, caracteristiques_communes.admin2_tr`	Nom de la division administrative de deuxième niveau dans la langue demandée ; repli sur admin2.
`duplicate_name_in_country`	`boolean`	`caracteristiques_communes.duplicate_name_in_country`	Booléen (true / false) signalant si plusieurs villes du même pays portent le même nom ASCII. Source : Calcul sur l'ensemble des identifiants GeoNames du pays.
`elevation_m`	`number`	`caracteristiques.elevation_m`	Altitude en mètres (uniquement lorsqu'une mesure explicite est fournie). Source : GeoNames.
`english_name`	`string`	`caracteristiques.english_name`	Nom anglais documenté.
`enrichment_status`	`string`	`caracteristiques_communes.enrichment_status`	Résultat global du rapprochement (name_coordinates, unmatched, coordinates_guess, geonames_direct…). Source : Pipeline AffectionPlus.
`feature_code`	`string`	`caracteristiques_communes.feature_code`	Code de classification GeoNames du lieu habité (PPLC, PPLA, PPLA2, PPL…). Source : GeoNames.
`geonames_id`	`string`	`caracteristiques.geonames_id`	Identifiant numérique GeoNames du lieu. Source : GeoNames.
`historical_name`	`string`	`caracteristiques.historical_name`	Nom original conservé dans la colonne source « nom historique » ; il ne désigne pas nécessairement un ancien toponyme.
`id`	`string`	`villes.id`	Identifiant unique et stable de la ville, conservé en texte, indépendant du pays.
`importance_tier`	`number`	`caracteristiques.importance_tier`	Indice hiérarchique de 1 à 5 (1 = capitale nationale ou ≥ 1 M hab. ; 2 = capitale régionale ou ≥ 200 k ; 3 = chef-lieu ou ≥ 50 k ; 4 = ≥ 10 k ; 5 = localité). Source : Calcul algorithmique sur [administrative_role], [feature_code] et [population].
`languages_official`	`json`	`caracteristiques_communes.languages_official`	Liste JSON des codes de langues officielles applicables. Source : Wikidata (P37) et GeoNames countryInfo.txt.
`languages_scope`	`json`	`caracteristiques_communes.languages_scope`	Objet JSON précisant si les langues relèvent de la ville (city) ou du pays (country). Source : Métadonnée de portée linguistique.
`languages_source`	`json`	`caracteristiques_communes.languages_source`	Objet JSON indiquant la source des langues officielles et parlées. Source : Wikidata et GeoNames countryInfo.
`languages_spoken`	`json`	`caracteristiques_communes.languages_spoken`	Liste JSON des langues parlées ou utilisées documentées. Source : Wikidata (P2936) et GeoNames countryInfo.txt.
`languages_year`	`string`	`caracteristiques_communes.languages_year`	Année de référence des données linguistiques lorsque datée. Source : Wikidata.
`latitude`	`number`	`villes.latitude`	Latitude GPS en degrés décimaux (WGS84), précision maximale locale conservée. Source : OpenStreetMap (ODbL) et rapprochement GeoNames compatible.
`local_names`	`json`	`caracteristiques.local_names`	Variantes locales documentées, au format JSON.
`longitude`	`number`	`villes.longitude`	Longitude GPS en degrés décimaux (WGS84), précision maximale locale conservée. Source : OpenStreetMap (ODbL) et rapprochement GeoNames compatible.
`municipality_code`	`string`	`caracteristiques.municipality_code`	Code officiel de la commune (notamment code INSEE en France). Source : API Géo / INSEE.
`name`	`string`	`villes.name; lang → villes.name_en, villes.name_de, villes.name_es, villes.name_it, villes.name_pt, villes.name_nl, villes.name_pl, villes.name_tr`	Nom dans la langue demandée par lang ; repli français si cette variante manque.
`name_ascii`	`string`	`caracteristiques.name_ascii`	Nom de la ville en caractères ASCII purs (sans accents), idéal pour l'indexation et la recherche. Source : GeoNames asciiname.
`name_language`	`string`	`lang ← villes.name_languages (bitmask)`	Langue attestée du nom retourné ; fr lorsque la variante demandée manque.
`name_local_phonetic`	`string`	`caracteristiques.name_local_phonetic`	Aide de lecture en alphabet latin pour les noms en écritures non latines. Source : Variantes latines GeoNames et nom anglais de repli.
`official_website`	`string`	`caracteristiques.official_website`	Site web officiel de la municipalité ou localité. Source : Wikidata (P856).
`phone_prefix`	`string`	`caracteristiques_communes.phone_prefix`	Indicatif téléphonique international du pays ou territoire (ex. +33, +44, +1). Source : GeoNames countryInfo.txt.
`population`	`number`	`villes.population`	Nombre d'habitants documenté (cellule vide si inconnu, jamais 0 par défaut). Source : INSEE (populations municipales 2023), Wikidata (P1082) ou GeoNames selon [population_source].
`population_proper`	`number`	`caracteristiques.population_proper`	Population municipale stricte (dans les limites administratives de la commune / localité). Source : INSEE (populations municipales 2023), Wikidata (P1082 municipal) ou GeoNames.
`population_scope`	`string`	`caracteristiques.population_scope`	Périmètre géographique de la population (commune, wikidata_entity, geonames_place). Source : Traçabilité du pipeline d'enrichissement.
`population_source`	`string`	`caracteristiques.population_source`	Source exacte du chiffre de population (insee-2023, wd:<QID>, gn:<id>, original_unverified). Source : Traçabilité du pipeline d'enrichissement.
`population_urban`	`number`	`caracteristiques.population_urban`	Population de l'agglomération / aire urbaine / métropole rattachée à la ville. Source : Wikidata (aires urbaines et métropolitaines P1082) et calcul d'agglomération spatiale GeoNames (hors sous-quartiers PPLX).
`population_urban_source`	`string`	`caracteristiques.population_urban_source`	Source de la population urbaine (wd:<QID>, gn_agglomeration ou proper_only). Source : Traçabilité de l'agglomération urbaine AffectionPlus.
`population_year`	`string`	`caracteristiques.population_year`	Année de référence du recensement ou de l'estimation de population. Source : INSEE (2023) ou qualificatif point in time (P585) de Wikidata.
`postal_code_format`	`string`	`caracteristiques_communes.postal_code_format`	Format / masque officiel des codes postaux du pays (ex. ##### en France). Source : GeoNames countryInfo.txt.
`postcode`	`string`	`caracteristiques.postcode`	Un ou plusieurs codes postaux séparés par point-virgule (;), zéros initiaux préservés. Source : API Géo / La Poste (France), GeoNames Postal Codes, Wikidata ou fichier initial.
`postcode_source`	`string`	`caracteristiques.postcode_source`	Source des codes postaux (geo-fr, gn-postal, wd, original_unverified). Source : Traçabilité postale.
`postcode_status`	`string`	`caracteristiques.postcode_status`	Qualité de couverture postale (commune_codes, documented_not_exhaustive, partial_codes, original_unverified). Source : Diagnostic de couverture postale.
`region`	`string`	`villes.admin1; lang → caracteristiques_communes.admin1_en, caracteristiques_communes.admin1_de, caracteristiques_communes.admin1_es, caracteristiques_communes.admin1_it, caracteristiques_communes.admin1_pt, caracteristiques_communes.admin1_nl, caracteristiques_communes.admin1_pl, caracteristiques_communes.admin1_tr`	Nom de la division administrative de premier niveau dans la langue demandée ; repli sur admin1.
`source_id`	`string`	`villes.id`	Alias de id : identifiant de la même ville.
`subregion_code_m49`	`string`	`caracteristiques_communes.subregion_code_m49`	Code numérique officiel M49 des Nations Unies pour la sous-région géographique (ex. 155, 039). Source : Nations Unies — Classification statistique M49.
`subregion_m49`	`string`	`caracteristiques_communes.subregion_m49; lang → caracteristiques_communes.subregion_m49_en, caracteristiques_communes.subregion_m49_de, caracteristiques_communes.subregion_m49_es, caracteristiques_communes.subregion_m49_it, caracteristiques_communes.subregion_m49_pt, caracteristiques_communes.subregion_m49_nl, caracteristiques_communes.subregion_m49_pl, caracteristiques_communes.subregion_m49_tr`	Nom de la sous-région ONU M49 dans la langue demandée par lang ; repli français.
`timezone`	`string`	`caracteristiques_communes.timezone`	Identifiant du fuseau horaire IANA (ex. Europe/Paris, America/New_York). Source : GeoNames.
`updated_at`	`string`	`caracteristiques.updated_at`	Date du dernier traitement d'enrichissement ou de vérification de la ligne (AAAA-MM-JJ). Source : Pipeline AffectionPlus.
`wikidata_id`	`string`	`caracteristiques.wikidata_id`	Identifiant d'entité Wikidata (ex. Q90 pour Paris). Source : Wikidata (via propriété P1566 GeoNames ID ou P374 INSEE).
`wikipedia_language`	`string`	`caracteristiques.wikipedia_language`	Code de langue de l'URL Wikipédia fournie (ex. fr, en, de). Source : Extrait du sous-domaine de [wikipedia_url].
`wikipedia_url`	`string`	`caracteristiques.wikipedia_url`	Lien Wikipédia conservé de la source retenue. La langue du lien est indiquée par wikipedia_language ; ce lien ne change pas avec le paramètre lang.

Sources et licences

Les populations n’ont pas toutes la même année ni le même périmètre. Le classement utilise population, sans lui substituer une estimation d’agglomération.

population_urban_source = gn_agglomeration indique une estimation heuristique, pas un recensement officiel. population_source = original_unverified indique une valeur historique non corroborée. Les licences ouvertes s’appliquent aussi aux données achetées : attribution et, pour une base dérivée soumise à l’ODbL, partage à l’identique. Le paiement rémunère le service ; il ne supprime pas les droits de redistribution accordés par ces licences.

Conditions d’utilisation

Structure de la base de données

Villes sur AffectionPlus

Structure de la base de données

Sources et licences