Estrutura da base de dados

Nomes de cidades, divisões administrativas, populações e coordenadas com as respetivas fontes.

A API gratuita apresenta as 5 000 cidades com os valores de population mais elevados nesta versão da base. A seleção mundial é fixa: os filtros por país não a ampliam.

Os widgets apresentados nas páginas de AffectionPlus.com consultam toda a base, mesmo sem subscrição. Noutros sites, o widget está limitado à seleção gratuita, salvo se o site utilizar um token emitido com uma subscrição elegível ativa.

Estrutura da base de dados

Cada cidade tem uma única linha, identificada por id. As colunas principais estão em villes; as características adicionais estão em caracteristiques, ligadas pelo mesmo id. Os dados ausentes permanecem nulos e os códigos de texto conservam os zeros iniciais.

As populações nem sempre têm o mesmo ano ou âmbito territorial. A classificação usa population, não estimativas de aglomeração.

As características idênticas de várias cidades são agrupadas em caracteristiques_communes e ligadas por profil_id. Estes perfis não criam cidades adicionais.

A exportação contém 1 371 405 cidades. O ficheiro comprimido ocupa cerca de 140 MB e a base restaurada, incluindo índices, cerca de 1,37 GB. É necessário PostgreSQL com a extensão 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

Propriedade	Tipo	Coluna SQL	Descrição
`admin1`	`string`	`villes.admin1`	Nome da divisão administrativa de 1.º nível (região, estado, Land, província). Fonte: GeoNames admin1CodesASCII e API Géo / INSEE (França).
`admin1_code`	`string`	`villes.admin1_code`	Código administrativo composto de nível 1 (GeoNames ou prefixo INSEE:). Fonte: GeoNames / INSEE.
`admin1_de`	`string`	`caracteristiques_communes.admin1_de`	Nome da divisão administrativa de primeiro nível em alemão.
`admin1_en`	`string`	`caracteristiques_communes.admin1_en`	Nome da divisão administrativa de primeiro nível em inglês.
`admin1_es`	`string`	`caracteristiques_communes.admin1_es`	Nome da divisão administrativa de primeiro nível em espanhol.
`admin1_fr`	`string`	`caracteristiques_communes.admin1_fr`	Nome da divisão administrativa de primeiro nível em francês.
`admin1_geonames_id`	`string`	`caracteristiques_communes.admin1_geonames_id`	Identificador GeoNames próprio da região / divisão de 1.º nível. Fonte: GeoNames admin1CodesASCII.
`admin1_iso_code`	`string`	`caracteristiques_communes.admin1_iso_code`	Código oficial ISO 3166-2 da região ou do estado federado (p. ex. FR-ARA, US-CA, DE-BY). Fonte: Wikidata (propriedade P300 associada ao GeoNames ID da região).
`admin1_it`	`string`	`caracteristiques_communes.admin1_it`	Nome da divisão administrativa de primeiro nível em italiano.
`admin1_nl`	`string`	`caracteristiques_communes.admin1_nl`	Nome da divisão administrativa de primeiro nível em neerlandês.
`admin1_pl`	`string`	`caracteristiques_communes.admin1_pl`	Nome da divisão administrativa de primeiro nível em polaco.
`admin1_pt`	`string`	`caracteristiques_communes.admin1_pt`	Nome da divisão administrativa de primeiro nível em português.
`admin1_tr`	`string`	`caracteristiques_communes.admin1_tr`	Nome da divisão administrativa de primeiro nível em turco.
`admin2`	`string`	`villes.admin2`	Nome da divisão administrativa de 2.º nível (departamento, condado, distrito). Fonte: GeoNames admin2Codes e API Géo / INSEE (França).
`admin2_code`	`string`	`villes.admin2_code`	Código administrativo composto de nível 2 (GeoNames ou prefixo INSEE:). Fonte: GeoNames / INSEE.
`admin2_de`	`string`	`caracteristiques_communes.admin2_de`	Nome da divisão administrativa de segundo nível em alemão.
`admin2_en`	`string`	`caracteristiques_communes.admin2_en`	Nome da divisão administrativa de segundo nível em inglês.
`admin2_es`	`string`	`caracteristiques_communes.admin2_es`	Nome da divisão administrativa de segundo nível em espanhol.
`admin2_fr`	`string`	`caracteristiques_communes.admin2_fr`	Nome da divisão administrativa de segundo nível em francês.
`admin2_geonames_id`	`string`	`caracteristiques_communes.admin2_geonames_id`	Identificador GeoNames próprio do departamento / divisão de 2.º nível. Fonte: GeoNames admin2Codes.
`admin2_it`	`string`	`caracteristiques_communes.admin2_it`	Nome da divisão administrativa de segundo nível em italiano.
`admin2_nl`	`string`	`caracteristiques_communes.admin2_nl`	Nome da divisão administrativa de segundo nível em neerlandês.
`admin2_pl`	`string`	`caracteristiques_communes.admin2_pl`	Nome da divisão administrativa de segundo nível em polaco.
`admin2_pt`	`string`	`caracteristiques_communes.admin2_pt`	Nome da divisão administrativa de segundo nível em português.
`admin2_tr`	`string`	`caracteristiques_communes.admin2_tr`	Nome da divisão administrativa de segundo nível em turco.
`administrative_role`	`string`	`caracteristiques_communes.administrative_role`	Papel administrativo normalizado (national_capital, admin1_seat, admin2_seat…). Fonte: deduzido do feature_code do GeoNames.
`administrative_role_de`	`string`	`caracteristiques_communes.administrative_role_de`	Designação do papel administrativo em alemão.
`administrative_role_en`	`string`	`caracteristiques_communes.administrative_role_en`	Designação do papel administrativo em inglês.
`administrative_role_es`	`string`	`caracteristiques_communes.administrative_role_es`	Designação do papel administrativo em espanhol.
`administrative_role_fr`	`string`	`caracteristiques_communes.administrative_role_fr`	Designação do papel administrativo em francês.
`administrative_role_it`	`string`	`caracteristiques_communes.administrative_role_it`	Designação do papel administrativo em italiano.
`administrative_role_nl`	`string`	`caracteristiques_communes.administrative_role_nl`	Designação do papel administrativo em neerlandês.
`administrative_role_pl`	`string`	`caracteristiques_communes.administrative_role_pl`	Designação do papel administrativo em polaco.
`administrative_role_pt`	`string`	`caracteristiques_communes.administrative_role_pt`	Designação do papel administrativo em português.
`administrative_role_tr`	`string`	`caracteristiques_communes.administrative_role_tr`	Designação do papel administrativo em turco.
`alternate_names`	`json`	`caracteristiques.alternate_names`	Lista JSON das variantes ortográficas, exónimos e transliterações conhecidos. Fonte: GeoNames alternateNamesV2 e dados iniciais.
`area_km2`	`number`	`caracteristiques.area_km2`	Área em quilómetros quadrados (km²). Fonte: API Géo / INSEE (hectares convertidos em km²) e Wikidata (P2046).
`area_scope`	`string`	`caracteristiques.area_scope`	Entidade exata abrangida pela área (commune:<INSEE> ou wikidata_entity:<QID>). Fonte: API Géo / Wikidata.
`area_source`	`string`	`caracteristiques.area_source`	Referencial que forneceu a área (geo-fr:<INSEE> ou wd:<QID>). Fonte: 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`	Nome do continente na língua pedida por lang; recorre ao francês. Fonte: ONU M49 / CLDR.
`continent_code`	`string`	`caracteristiques_communes.continent_code`	Código do continente com duas letras (EU, AS, AF, NA, SA, OC, AN). Fonte: GeoNames countryInfo.txt.
`coordinate_match_distance_km`	`number`	`caracteristiques.coordinate_match_distance_km`	Distância em quilómetros entre a coordenada de origem e o lugar GeoNames correspondido. Fonte: cálculo geodésico (fórmula de Haversine) durante a correspondência.
`coordinate_match_status`	`string`	`caracteristiques.coordinate_match_status`	Estado de confiança da correspondência por coordenadas (name_agrees, coordinates_unique, coordinates_guess, geonames_direct). Fonte: pipeline de controlo geográfico AffectionPlus.
`coordinate_source`	`string`	`caracteristiques_communes.coordinate_source`	Fonte das coordenadas GPS: OpenStreetMap quando longitude e latitude estão preenchidas. Fonte: OpenStreetMap (sob licença ODbL).
`country`	`string`	`villes.country`	Alias de country_code: código ISO 3166-1 alfa-2 do país ou território.
`country_code`	`string`	`villes.country`	Código ISO 3166-1 alfa-2 do país ou território (p. ex. FR, GB, DK, GL). Fonte: GeoNames e contexto nacional verificado.
`country_code_iso3`	`string`	`caracteristiques_communes.country_code_iso3`	Código de país normalizado ISO 3166-1 alfa-3, com três letras (p. ex. FRA, GBR, DNK). Fonte: 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`	Nome do país na língua pedida por lang; recorre ao francês. Fonte: CLDR / Babel.
`country_tld`	`string`	`caracteristiques_communes.country_tld`	Domínio de Internet nacional de topo ccTLD (p. ex. .fr, .uk, .dk). Fonte: GeoNames countryInfo.txt.
`currency_code`	`string`	`caracteristiques_communes.currency_code`	Código oficial de moeda ISO 4217 do país ou território (p. ex. EUR, USD, GBP, DKK). Fonte: GeoNames countryInfo.txt.
`data_sources`	`string`	`caracteristiques.data_sources`	Lista separada por ';' de todas as fontes utilizadas para construir a linha. Fonte: registo de proveniência por linha (osm, gn, wd, insee-2023, geo-fr, cldr, un-m49, iso-3166-2).
`demonym_de`	`string`	`caracteristiques.demonym_de`	Gentílico atestado em alemão.
`demonym_en`	`string`	`caracteristiques.demonym_en`	Gentílico atestado em inglês.
`demonym_es`	`string`	`caracteristiques.demonym_es`	Gentílico atestado em espanhol.
`demonym_fr`	`string`	`caracteristiques.demonym_fr`	Gentílico atestado em francês. Fonte: Wikidata P1549.
`demonym_it`	`string`	`caracteristiques.demonym_it`	Gentílico atestado em italiano.
`demonym_nl`	`string`	`caracteristiques.demonym_nl`	Gentílico atestado em neerlandês.
`demonym_pl`	`string`	`caracteristiques.demonym_pl`	Gentílico atestado em polaco.
`demonym_pt`	`string`	`caracteristiques.demonym_pt`	Gentílico atestado em português.
`demonym_scope`	`string`	`caracteristiques.demonym_scope`	Âmbito de aplicação do gentílico (cidade ou município). Fonte: Wikidata / INSEE.
`demonym_source`	`string`	`caracteristiques.demonym_source`	Identificador da entidade Wikidata que serve de fonte do gentílico. Fonte: Wikidata.
`demonym_tr`	`string`	`caracteristiques.demonym_tr`	Gentílico atestado em turco.
`demonyms_local`	`json`	`caracteristiques.demonyms_local`	Objeto JSON com todas as formas de gentílico atestadas por código de língua. Fonte: Wikidata (P1549).
`density_km2`	`number`	`caracteristiques.density_km2`	Densidade de habitantes por km² (calculada apenas se a população datada e a área tiverem o mesmo âmbito). Fonte: cálculo verificado sobre [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`	Nome da divisão administrativa de segundo nível na língua pedida; recorre a admin2.
`duplicate_name_in_country`	`boolean`	`caracteristiques_communes.duplicate_name_in_country`	Booleano (true / false) que assinala se várias cidades do mesmo país têm o mesmo nome ASCII. Fonte: cálculo sobre o conjunto dos identificadores GeoNames do país.
`elevation_m`	`number`	`caracteristiques.elevation_m`	Altitude em metros (apenas quando é fornecida uma medição explícita). Fonte: GeoNames.
`english_name`	`string`	`caracteristiques.english_name`	Nome inglês documentado.
`enrichment_status`	`string`	`caracteristiques_communes.enrichment_status`	Resultado global da correspondência (name_coordinates, unmatched, coordinates_guess, geonames_direct…). Fonte: pipeline AffectionPlus.
`feature_code`	`string`	`caracteristiques_communes.feature_code`	Código de classificação GeoNames do lugar habitado (PPLC, PPLA, PPLA2, PPL…). Fonte: GeoNames.
`geonames_id`	`string`	`caracteristiques.geonames_id`	Identificador numérico GeoNames do lugar. Fonte: GeoNames.
`historical_name`	`string`	`caracteristiques.historical_name`	Nome original conservado na coluna de origem «nom historique»; não designa necessariamente um topónimo antigo.
`id`	`string`	`villes.id`	Identificador único e estável da cidade, conservado em texto, independente do país.
`importance_tier`	`number`	`caracteristiques.importance_tier`	Índice hierárquico de 1 a 5 (1 = capital nacional ou ≥ 1 M hab.; 2 = capital regional ou ≥ 200 k; 3 = sede administrativa ou ≥ 50 k; 4 = ≥ 10 k; 5 = localidade). Fonte: cálculo algorítmico sobre [administrative_role], [feature_code] e [population].
`languages_official`	`json`	`caracteristiques_communes.languages_official`	Lista JSON dos códigos das línguas oficiais aplicáveis. Fonte: Wikidata (P37) e GeoNames countryInfo.txt.
`languages_scope`	`json`	`caracteristiques_communes.languages_scope`	Objeto JSON que especifica se as línguas dizem respeito à cidade (city) ou ao país (country). Fonte: metadado de âmbito linguístico.
`languages_source`	`json`	`caracteristiques_communes.languages_source`	Objeto JSON que indica a fonte das línguas oficiais e faladas. Fonte: Wikidata e GeoNames countryInfo.
`languages_spoken`	`json`	`caracteristiques_communes.languages_spoken`	Lista JSON das línguas faladas ou utilizadas documentadas. Fonte: Wikidata (P2936) e GeoNames countryInfo.txt.
`languages_year`	`string`	`caracteristiques_communes.languages_year`	Ano de referência dos dados linguísticos, quando datados. Fonte: Wikidata.
`latitude`	`number`	`villes.latitude`	Latitude GPS em graus decimais (WGS84), com a máxima precisão local conservada. Fonte: OpenStreetMap (ODbL) e correspondência GeoNames compatível.
`local_names`	`json`	`caracteristiques.local_names`	Variantes locais documentadas, em formato JSON.
`longitude`	`number`	`villes.longitude`	Longitude GPS em graus decimais (WGS84), com a máxima precisão local conservada. Fonte: OpenStreetMap (ODbL) e correspondência GeoNames compatível.
`municipality_code`	`string`	`caracteristiques.municipality_code`	Código oficial do município (nomeadamente o código INSEE em França). Fonte: 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`	Nome na língua pedida por lang; recorre ao francês se essa variante não existir.
`name_ascii`	`string`	`caracteristiques.name_ascii`	Nome da cidade em caracteres ASCII puros (sem acentos), ideal para indexação e pesquisa. Fonte: GeoNames asciiname.
`name_language`	`string`	`lang ← villes.name_languages (bitmask)`	Língua atestada do nome devolvido; fr quando a variante pedida não existe.
`name_local_phonetic`	`string`	`caracteristiques.name_local_phonetic`	Auxiliar de leitura em alfabeto latino para nomes em escritas não latinas. Fonte: variantes latinas do GeoNames e nome inglês de recurso.
`official_website`	`string`	`caracteristiques.official_website`	Sítio web oficial do município ou localidade. Fonte: Wikidata (P856).
`phone_prefix`	`string`	`caracteristiques_communes.phone_prefix`	Indicativo telefónico internacional do país ou território (p. ex. +33, +44, +1). Fonte: GeoNames countryInfo.txt.
`population`	`number`	`villes.population`	Número de habitantes documentado (célula vazia se desconhecido, nunca 0 por defeito). Fonte: INSEE (populações municipais 2023), Wikidata (P1082) ou GeoNames, consoante [population_source].
`population_proper`	`number`	`caracteristiques.population_proper`	População municipal estrita (dentro dos limites administrativos do município / localidade). Fonte: INSEE (populações municipais 2023), Wikidata (P1082 municipal) ou GeoNames.
`population_scope`	`string`	`caracteristiques.population_scope`	Âmbito geográfico da população (commune, wikidata_entity, geonames_place). Fonte: rastreabilidade do pipeline de enriquecimento.
`population_source`	`string`	`caracteristiques.population_source`	Fonte exata do valor da população (insee-2023, wd:<QID>, gn:<id>, original_unverified). Fonte: rastreabilidade do pipeline de enriquecimento.
`population_urban`	`number`	`caracteristiques.population_urban`	População da aglomeração / área urbana / metrópole associada à cidade. Fonte: Wikidata (áreas urbanas e metropolitanas P1082) e cálculo de aglomeração espacial GeoNames (excluindo subbairros PPLX).
`population_urban_source`	`string`	`caracteristiques.population_urban_source`	Fonte da população urbana (wd:<QID>, gn_agglomeration ou proper_only). Fonte: rastreabilidade da aglomeração urbana AffectionPlus.
`population_year`	`string`	`caracteristiques.population_year`	Ano de referência do recenseamento ou da estimativa da população. Fonte: INSEE (2023) ou qualificador point in time (P585) do Wikidata.
`postal_code_format`	`string`	`caracteristiques_communes.postal_code_format`	Formato / máscara oficial dos códigos postais do país (p. ex. ##### em França). Fonte: GeoNames countryInfo.txt.
`postcode`	`string`	`caracteristiques.postcode`	Um ou mais códigos postais separados por ponto e vírgula (;), com os zeros à esquerda preservados. Fonte: API Géo / La Poste (França), GeoNames Postal Codes, Wikidata ou ficheiro inicial.
`postcode_source`	`string`	`caracteristiques.postcode_source`	Fonte dos códigos postais (geo-fr, gn-postal, wd, original_unverified). Fonte: rastreabilidade postal.
`postcode_status`	`string`	`caracteristiques.postcode_status`	Qualidade da cobertura postal (commune_codes, documented_not_exhaustive, partial_codes, original_unverified). Fonte: 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`	Nome da divisão administrativa de primeiro nível na língua pedida; recorre a admin1.
`source_id`	`string`	`villes.id`	Alias de id: identificador da mesma cidade.
`subregion_code_m49`	`string`	`caracteristiques_communes.subregion_code_m49`	Código numérico oficial M49 das Nações Unidas para a sub-região geográfica (p. ex. 155, 039). Fonte: Nações Unidas — Classificação estatí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`	Nome da sub-região ONU M49 na língua pedida por lang; recorre ao francês.
`timezone`	`string`	`caracteristiques_communes.timezone`	Identificador do fuso horário IANA (p. ex. Europe/Paris, America/New_York). Fonte: GeoNames.
`updated_at`	`string`	`caracteristiques.updated_at`	Data do último tratamento de enriquecimento ou de verificação da linha (AAAA-MM-DD). Fonte: pipeline AffectionPlus.
`wikidata_id`	`string`	`caracteristiques.wikidata_id`	Identificador de entidade Wikidata (p. ex. Q90 para Paris). Fonte: Wikidata (através da propriedade P1566 GeoNames ID ou P374 INSEE).
`wikipedia_language`	`string`	`caracteristiques.wikipedia_language`	Código de língua do URL da Wikipédia fornecido (p. ex. fr, en, de). Fonte: extraído do subdomínio de [wikipedia_url].
`wikipedia_url`	`string`	`caracteristiques.wikipedia_url`	Ligação para a Wikipédia conservada da fonte escolhida. A língua da ligação é indicada por wikipedia_language; esta ligação não muda com o parâmetro lang.

Fontes e licenças

As populações nem sempre têm o mesmo ano ou âmbito territorial. A classificação usa population, não estimativas de aglomeração.

population_urban_source = gn_agglomeration indica uma estimativa heurística, não um recenseamento oficial. population_source = original_unverified indica um valor histórico não corroborado. As licenças abertas também se aplicam aos dados comprados: atribuição e, para uma base derivada abrangida pela ODbL, partilha nos mesmos termos. O pagamento remunera o serviço e não elimina os direitos de redistribuição concedidos pelas licenças.

Condições de utilização

Estrutura da base de dados

Cidades no AffectionPlus

Estrutura da base de dados

Fontes e licenças