Estructura de la base de datos

Nombres de ciudades, divisiones administrativas, poblaciones y coordenadas con su procedencia.

La API gratuita ofrece las 5.000 ciudades con los valores más altos de population en esta versión de la base. La selección mundial es fija: los filtros por país no la amplían.

Los widgets mostrados en las páginas de AffectionPlus.com consultan toda la base, incluso sin suscripción. En otros sitios, el widget se limita a la selección gratuita, salvo que el sitio utilice un token emitido con una suscripción activa que dé derecho al acceso completo.

Estructura de la base de datos

Cada ciudad tiene una sola fila, identificada por id. Las columnas habituales están en villes; las características adicionales están en caracteristiques, vinculadas por el mismo id. Los datos ausentes son nulos y los códigos de texto conservan los ceros iniciales.

Las poblaciones no comparten siempre año ni delimitación. La clasificación usa population, no una estimación de aglomeración.

Las características idénticas de varias ciudades se agrupan en caracteristiques_communes y se vinculan mediante profil_id. Estos perfiles no crean ciudades adicionales.

La exportación contiene 1.371.405 ciudades. El archivo comprimido ocupa unos 140 MB y la base restaurada, con índices, unos 1,37 GB. Se requiere PostgreSQL con la extensión pg_trgm.

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

Propiedad	Tipo	Columna SQL	Descripción
`admin1`	`string`	`villes.admin1`	Nombre de la división administrativa de primer nivel (región, estado, Land, provincia). Fuente: GeoNames admin1CodesASCII y API Géo / INSEE (Francia).
`admin1_code`	`string`	`villes.admin1_code`	Código administrativo compuesto de nivel 1 (GeoNames o prefijo INSEE:). Fuente: GeoNames / INSEE.
`admin1_de`	`string`	`caracteristiques_communes.admin1_de`	Nombre de la división administrativa de primer nivel en alemán.
`admin1_en`	`string`	`caracteristiques_communes.admin1_en`	Nombre de la división administrativa de primer nivel en inglés.
`admin1_es`	`string`	`caracteristiques_communes.admin1_es`	Nombre de la división administrativa de primer nivel en español.
`admin1_fr`	`string`	`caracteristiques_communes.admin1_fr`	Nombre de la división administrativa de primer nivel en francés.
`admin1_geonames_id`	`string`	`caracteristiques_communes.admin1_geonames_id`	Identificador de GeoNames propio de la región / división de primer nivel. Fuente: GeoNames admin1CodesASCII.
`admin1_iso_code`	`string`	`caracteristiques_communes.admin1_iso_code`	Código oficial ISO 3166-2 de la región o del estado federado (p. ej. FR-ARA, US-CA, DE-BY). Fuente: Wikidata (propiedad P300 asociada al GeoNames ID de la región).
`admin1_it`	`string`	`caracteristiques_communes.admin1_it`	Nombre de la división administrativa de primer nivel en italiano.
`admin1_nl`	`string`	`caracteristiques_communes.admin1_nl`	Nombre de la división administrativa de primer nivel en neerlandés.
`admin1_pl`	`string`	`caracteristiques_communes.admin1_pl`	Nombre de la división administrativa de primer nivel en polaco.
`admin1_pt`	`string`	`caracteristiques_communes.admin1_pt`	Nombre de la división administrativa de primer nivel en portugués.
`admin1_tr`	`string`	`caracteristiques_communes.admin1_tr`	Nombre de la división administrativa de primer nivel en turco.
`admin2`	`string`	`villes.admin2`	Nombre de la división administrativa de segundo nivel (condado, distrito, etc.). Fuente: GeoNames admin2Codes y API Géo / INSEE (Francia).
`admin2_code`	`string`	`villes.admin2_code`	Código administrativo compuesto de nivel 2 (GeoNames o prefijo INSEE:). Fuente: GeoNames / INSEE.
`admin2_de`	`string`	`caracteristiques_communes.admin2_de`	Nombre de la división administrativa de segundo nivel en alemán.
`admin2_en`	`string`	`caracteristiques_communes.admin2_en`	Nombre de la división administrativa de segundo nivel en inglés.
`admin2_es`	`string`	`caracteristiques_communes.admin2_es`	Nombre de la división administrativa de segundo nivel en español.
`admin2_fr`	`string`	`caracteristiques_communes.admin2_fr`	Nombre de la división administrativa de segundo nivel en francés.
`admin2_geonames_id`	`string`	`caracteristiques_communes.admin2_geonames_id`	Identificador de GeoNames propio de la división de segundo nivel. Fuente: GeoNames admin2Codes.
`admin2_it`	`string`	`caracteristiques_communes.admin2_it`	Nombre de la división administrativa de segundo nivel en italiano.
`admin2_nl`	`string`	`caracteristiques_communes.admin2_nl`	Nombre de la división administrativa de segundo nivel en neerlandés.
`admin2_pl`	`string`	`caracteristiques_communes.admin2_pl`	Nombre de la división administrativa de segundo nivel en polaco.
`admin2_pt`	`string`	`caracteristiques_communes.admin2_pt`	Nombre de la división administrativa de segundo nivel en portugués.
`admin2_tr`	`string`	`caracteristiques_communes.admin2_tr`	Nombre de la división administrativa de segundo nivel en turco.
`administrative_role`	`string`	`caracteristiques_communes.administrative_role`	Función administrativa normalizada (national_capital, admin1_seat, admin2_seat…). Fuente: Deducido del feature_code de GeoNames.
`administrative_role_de`	`string`	`caracteristiques_communes.administrative_role_de`	Denominación de la función administrativa en alemán.
`administrative_role_en`	`string`	`caracteristiques_communes.administrative_role_en`	Denominación de la función administrativa en inglés.
`administrative_role_es`	`string`	`caracteristiques_communes.administrative_role_es`	Denominación de la función administrativa en español.
`administrative_role_fr`	`string`	`caracteristiques_communes.administrative_role_fr`	Denominación de la función administrativa en francés.
`administrative_role_it`	`string`	`caracteristiques_communes.administrative_role_it`	Denominación de la función administrativa en italiano.
`administrative_role_nl`	`string`	`caracteristiques_communes.administrative_role_nl`	Denominación de la función administrativa en neerlandés.
`administrative_role_pl`	`string`	`caracteristiques_communes.administrative_role_pl`	Denominación de la función administrativa en polaco.
`administrative_role_pt`	`string`	`caracteristiques_communes.administrative_role_pt`	Denominación de la función administrativa en portugués.
`administrative_role_tr`	`string`	`caracteristiques_communes.administrative_role_tr`	Denominación de la función administrativa en turco.
`alternate_names`	`json`	`caracteristiques.alternate_names`	Lista JSON de variantes ortográficas, exónimos y transliteraciones conocidos. Fuente: GeoNames alternateNamesV2 y datos iniciales.
`area_km2`	`number`	`caracteristiques.area_km2`	Superficie en kilómetros cuadrados (km²). Fuente: API Géo / INSEE (hectáreas convertidas a km²) y Wikidata (P2046).
`area_scope`	`string`	`caracteristiques.area_scope`	Entidad exacta cubierta por la superficie (commune:<INSEE> o wikidata_entity:<QID>). Fuente: API Géo / Wikidata.
`area_source`	`string`	`caracteristiques.area_source`	Referencial que proporcionó la superficie (geo-fr:<INSEE> o wd:<QID>). Fuente: 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`	Nombre del continente en el idioma solicitado por lang; se recurre al francés. Fuente: ONU M49 / CLDR.
`continent_code`	`string`	`caracteristiques_communes.continent_code`	Código del continente de dos letras (EU, AS, AF, NA, SA, OC, AN). Fuente: GeoNames countryInfo.txt.
`coordinate_match_distance_km`	`number`	`caracteristiques.coordinate_match_distance_km`	Distancia en kilómetros entre la coordenada de origen y el lugar de GeoNames emparejado. Fuente: Cálculo geodésico (fórmula de Haversine) durante el emparejamiento.
`coordinate_match_status`	`string`	`caracteristiques.coordinate_match_status`	Estado de confianza del emparejamiento por coordenadas (name_agrees, coordinates_unique, coordinates_guess, geonames_direct). Fuente: Pipeline de control geográfico de AffectionPlus.
`coordinate_source`	`string`	`caracteristiques_communes.coordinate_source`	Fuente de las coordenadas GPS: OpenStreetMap cuando se proporcionan longitud y latitud. Fuente: OpenStreetMap (licencia ODbL).
`country`	`string`	`villes.country`	Alias de country_code: código ISO 3166-1 alpha-2 del país o territorio.
`country_code`	`string`	`villes.country`	Código de país o territorio ISO 3166-1 alpha-2 (p. ej. FR, GB, DK, GL). Fuente: GeoNames y contexto nacional verificado.
`country_code_iso3`	`string`	`caracteristiques_communes.country_code_iso3`	Código de país normalizado ISO 3166-1 alpha-3 de tres letras (p. ej. FRA, GBR, DNK). Fuente: 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`	Nombre del país en el idioma solicitado por lang; se recurre al francés. Fuente: CLDR / Babel.
`country_tld`	`string`	`caracteristiques_communes.country_tld`	Dominio de Internet nacional de primer nivel ccTLD (p. ej. .fr, .uk, .dk). Fuente: GeoNames countryInfo.txt.
`currency_code`	`string`	`caracteristiques_communes.currency_code`	Código oficial de divisa ISO 4217 del país o territorio (p. ej. EUR, USD, GBP, DKK). Fuente: GeoNames countryInfo.txt.
`data_sources`	`string`	`caracteristiques.data_sources`	Lista separada por ';' de todas las fuentes utilizadas para construir la fila. Fuente: Registro de procedencia por fila (osm, gn, wd, insee-2023, geo-fr, cldr, un-m49, iso-3166-2).
`demonym_de`	`string`	`caracteristiques.demonym_de`	Gentilicio atestiguado en alemán.
`demonym_en`	`string`	`caracteristiques.demonym_en`	Gentilicio atestiguado en inglés.
`demonym_es`	`string`	`caracteristiques.demonym_es`	Gentilicio atestiguado en español.
`demonym_fr`	`string`	`caracteristiques.demonym_fr`	Gentilicio atestiguado en francés. Fuente: Wikidata P1549.
`demonym_it`	`string`	`caracteristiques.demonym_it`	Gentilicio atestiguado en italiano.
`demonym_nl`	`string`	`caracteristiques.demonym_nl`	Gentilicio atestiguado en neerlandés.
`demonym_pl`	`string`	`caracteristiques.demonym_pl`	Gentilicio atestiguado en polaco.
`demonym_pt`	`string`	`caracteristiques.demonym_pt`	Gentilicio atestiguado en portugués.
`demonym_scope`	`string`	`caracteristiques.demonym_scope`	Ámbito de aplicación del gentilicio (ciudad o municipio). Fuente: Wikidata / INSEE.
`demonym_source`	`string`	`caracteristiques.demonym_source`	Identificador de la entidad de Wikidata fuente del gentilicio. Fuente: Wikidata.
`demonym_tr`	`string`	`caracteristiques.demonym_tr`	Gentilicio atestiguado en turco.
`demonyms_local`	`json`	`caracteristiques.demonyms_local`	Objeto JSON con todas las formas de gentilicio atestiguadas por código de idioma. Fuente: Wikidata (P1549).
`density_km2`	`number`	`caracteristiques.density_km2`	Densidad de habitantes por km² (calculada solo si la población fechada y la superficie tienen el mismo ámbito). Fuente: Cálculo verificado a partir de [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`	Nombre de la división administrativa de segundo nivel en el idioma solicitado; se recurre a admin2.
`duplicate_name_in_country`	`boolean`	`caracteristiques_communes.duplicate_name_in_country`	Booleano (true / false) que indica si varias ciudades del mismo país comparten el mismo nombre ASCII. Fuente: Cálculo sobre el conjunto de identificadores de GeoNames del país.
`elevation_m`	`number`	`caracteristiques.elevation_m`	Altitud en metros (solo cuando se proporciona una medición explícita). Fuente: GeoNames.
`english_name`	`string`	`caracteristiques.english_name`	Nombre inglés documentado.
`enrichment_status`	`string`	`caracteristiques_communes.enrichment_status`	Resultado global del emparejamiento (name_coordinates, unmatched, coordinates_guess, geonames_direct…). Fuente: Pipeline de AffectionPlus.
`feature_code`	`string`	`caracteristiques_communes.feature_code`	Código de clasificación de GeoNames del lugar habitado (PPLC, PPLA, PPLA2, PPL…). Fuente: GeoNames.
`geonames_id`	`string`	`caracteristiques.geonames_id`	Identificador numérico de GeoNames del lugar. Fuente: GeoNames.
`historical_name`	`string`	`caracteristiques.historical_name`	Nombre original conservado en la columna de origen «nom historique»; no designa necesariamente un topónimo antiguo.
`id`	`string`	`villes.id`	Identificador único y estable de la ciudad, conservado como texto, independiente del país.
`importance_tier`	`number`	`caracteristiques.importance_tier`	Índice jerárquico de 1 a 5 (1 = capital nacional o ≥ 1 M hab.; 2 = capital regional o ≥ 200 k; 3 = cabecera administrativa o ≥ 50 k; 4 = ≥ 10 k; 5 = localidad). Fuente: Cálculo algorítmico a partir de [administrative_role], [feature_code] y [population].
`languages_official`	`json`	`caracteristiques_communes.languages_official`	Lista JSON de los códigos de idiomas oficiales aplicables. Fuente: Wikidata (P37) y GeoNames countryInfo.txt.
`languages_scope`	`json`	`caracteristiques_communes.languages_scope`	Objeto JSON que indica si los idiomas corresponden a la ciudad (city) o al país (country). Fuente: Metadatos del ámbito lingüístico.
`languages_source`	`json`	`caracteristiques_communes.languages_source`	Objeto JSON que indica la fuente de los idiomas oficiales y hablados. Fuente: Wikidata y GeoNames countryInfo.
`languages_spoken`	`json`	`caracteristiques_communes.languages_spoken`	Lista JSON de los idiomas hablados o utilizados documentados. Fuente: Wikidata (P2936) y GeoNames countryInfo.txt.
`languages_year`	`string`	`caracteristiques_communes.languages_year`	Año de referencia de los datos lingüísticos cuando están fechados. Fuente: Wikidata.
`latitude`	`number`	`villes.latitude`	Latitud GPS en grados decimales (WGS84), se conserva la máxima precisión local. Fuente: OpenStreetMap (ODbL) y correspondencia compatible con GeoNames.
`local_names`	`json`	`caracteristiques.local_names`	Variantes locales documentadas, en formato JSON.
`longitude`	`number`	`villes.longitude`	Longitud GPS en grados decimales (WGS84), se conserva la máxima precisión local. Fuente: OpenStreetMap (ODbL) y correspondencia compatible con GeoNames.
`municipality_code`	`string`	`caracteristiques.municipality_code`	Código oficial del municipio (en particular el código INSEE en Francia). Fuente: 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`	Nombre en el idioma solicitado por lang; se recurre al francés si falta esta variante.
`name_ascii`	`string`	`caracteristiques.name_ascii`	Nombre de la ciudad en caracteres ASCII puros (sin acentos), ideal para la indexación y la búsqueda. Fuente: GeoNames asciiname.
`name_language`	`string`	`lang ← villes.name_languages (bitmask)`	Idioma atestiguado del nombre devuelto; fr cuando falta la variante solicitada.
`name_local_phonetic`	`string`	`caracteristiques.name_local_phonetic`	Ayuda de lectura en alfabeto latino para los nombres en escrituras no latinas. Fuente: Variantes latinas de GeoNames y nombre inglés como alternativa.
`official_website`	`string`	`caracteristiques.official_website`	Sitio web oficial del municipio o localidad. Fuente: Wikidata (P856).
`phone_prefix`	`string`	`caracteristiques_communes.phone_prefix`	Prefijo telefónico internacional del país o territorio (p. ej. +33, +44, +1). Fuente: GeoNames countryInfo.txt.
`population`	`number`	`villes.population`	Número de habitantes documentado (celda vacía si se desconoce, nunca 0 por defecto). Fuente: INSEE (poblaciones municipales 2023), Wikidata (P1082) o GeoNames según [population_source].
`population_proper`	`number`	`caracteristiques.population_proper`	Población municipal estricta (dentro de los límites administrativos del municipio / localidad). Fuente: INSEE (poblaciones municipales 2023), Wikidata (P1082 municipal) o GeoNames.
`population_scope`	`string`	`caracteristiques.population_scope`	Ámbito geográfico de la población (commune, wikidata_entity, geonames_place). Fuente: Trazabilidad del pipeline de enriquecimiento.
`population_source`	`string`	`caracteristiques.population_source`	Fuente exacta de la cifra de población (insee-2023, wd:<QID>, gn:<id>, original_unverified). Fuente: Trazabilidad del pipeline de enriquecimiento.
`population_urban`	`number`	`caracteristiques.population_urban`	Población de la aglomeración / área urbana / metrópoli vinculada a la ciudad. Fuente: Wikidata (áreas urbanas y metropolitanas P1082) y cálculo espacial de aglomeración de GeoNames (excluidos los subbarrios PPLX).
`population_urban_source`	`string`	`caracteristiques.population_urban_source`	Fuente de la población urbana (wd:<QID>, gn_agglomeration o proper_only). Fuente: Trazabilidad de la aglomeración urbana de AffectionPlus.
`population_year`	`string`	`caracteristiques.population_year`	Año de referencia del censo o de la estimación de población. Fuente: INSEE (2023) o calificador de fecha (P585) de Wikidata.
`postal_code_format`	`string`	`caracteristiques_communes.postal_code_format`	Formato / máscara oficial de los códigos postales del país (p. ej. ##### en Francia). Fuente: GeoNames countryInfo.txt.
`postcode`	`string`	`caracteristiques.postcode`	Uno o varios códigos postales separados por punto y coma (;), con los ceros iniciales conservados. Fuente: API Géo / La Poste (Francia), GeoNames Postal Codes, Wikidata o archivo inicial.
`postcode_source`	`string`	`caracteristiques.postcode_source`	Fuente de los códigos postales (geo-fr, gn-postal, wd, original_unverified). Fuente: Trazabilidad postal.
`postcode_status`	`string`	`caracteristiques.postcode_status`	Calidad de cobertura postal (commune_codes, documented_not_exhaustive, partial_codes, original_unverified). Fuente: Diagnóstico de cobertura postal.
`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`	Nombre de la división administrativa de primer nivel en el idioma solicitado; se recurre a admin1.
`source_id`	`string`	`villes.id`	Alias de id: identificador de la misma ciudad.
`subregion_code_m49`	`string`	`caracteristiques_communes.subregion_code_m49`	Código numérico oficial M49 de las Naciones Unidas de la subregión geográfica (p. ej. 155, 039). Fuente: Naciones Unidas — Clasificación estadística 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`	Nombre de la subregión ONU M49 en el idioma solicitado por lang; se recurre al francés.
`timezone`	`string`	`caracteristiques_communes.timezone`	Identificador de zona horaria IANA (p. ej. Europe/Paris, America/New_York). Fuente: GeoNames.
`updated_at`	`string`	`caracteristiques.updated_at`	Fecha del último tratamiento de enriquecimiento o verificación de la fila (AAAA-MM-DD). Fuente: Pipeline de AffectionPlus.
`wikidata_id`	`string`	`caracteristiques.wikidata_id`	Identificador de entidad de Wikidata (p. ej. Q90 para París). Fuente: Wikidata (mediante la propiedad P1566 GeoNames ID o P374 INSEE).
`wikipedia_language`	`string`	`caracteristiques.wikipedia_language`	Código de idioma de la URL de Wikipedia proporcionada (p. ej. fr, en, de). Fuente: Extraído del subdominio de [wikipedia_url].
`wikipedia_url`	`string`	`caracteristiques.wikipedia_url`	Enlace de Wikipedia conservado de la fuente seleccionada. El idioma del enlace lo indica wikipedia_language; este enlace no cambia con el parámetro lang.

Fuentes y licencias

Las poblaciones no comparten siempre año ni delimitación. La clasificación usa population, no una estimación de aglomeración.

population_urban_source = gn_agglomeration indica una estimación heurística, no un censo oficial. population_source = original_unverified indica un valor histórico no corroborado. Las licencias abiertas también se aplican a los datos comprados: atribución y, para una base derivada bajo ODbL, compartir bajo la misma licencia. El pago remunera el servicio y no elimina los derechos de redistribución otorgados por esas licencias.

Condiciones de uso

Estructura de la base de datos

Ciudades en AffectionPlus

Estructura de la base de datos

Fuentes y licencias