IT

CAPIT · API & DATA

Struttura della banca dati

Schema della banca dati mondiale delle città: colonne, identificatori, tipi, fonti e ripristino PostgreSQL.

Accedi con il mio account condiviso
Abbonati — da 3 €/mese

Strumenti e dati per i tuoi siti web, in un unico abbonamento.

In uso

Città su AffectionPlus

Mappa e tabella delle città del Madagascar, con ricerca e filtri.

Scopri le città del Madagascar

Nomi delle città, suddivisioni amministrative, popolazioni e coordinate con le fonti.

L’API gratuita espone le 5.000 città con i valori population più elevati in questa versione della banca dati. La selezione mondiale è fissa: i filtri per paese non la ampliano.

I widget presenti nelle pagine di AffectionPlus.com consultano tutta la banca dati, anche senza abbonamento. Su altri siti, il widget è limitato alla selezione gratuita, salvo che il sito utilizzi un token emesso con un abbonamento attivo idoneo.

Struttura della banca dati

Ogni città ha una sola riga, identificata da id. Le colonne principali sono in villes; le caratteristiche aggiuntive sono in caracteristiques, collegate dallo stesso id. I dati mancanti restano nulli e i codici testuali conservano gli zeri iniziali.

Le popolazioni non hanno sempre lo stesso anno o perimetro. L’ordinamento usa population, non stime dell’agglomerato.

Le caratteristiche identiche di più città sono raggruppate in caracteristiques_communes e collegate tramite profil_id. Questi profili non creano città aggiuntive.

L’esportazione contiene 1.371.405 città. Il file compresso occupa circa 140 MB e la banca dati ripristinata, indici inclusi, circa 1,37 GB. È richiesto PostgreSQL con l’estensione 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

ProprietàTipoColonna SQLDescrizione
admin1stringvilles.admin1Nome della divisione amministrativa di primo livello (regione, stato, Land, provincia). Fonte: GeoNames admin1CodesASCII e API Géo / INSEE (Francia).
admin1_codestringvilles.admin1_codeCodice amministrativo composito di livello 1 (GeoNames o prefisso INSEE:). Fonte: GeoNames / INSEE.
admin1_destringcaracteristiques_communes.admin1_deNome della divisione amministrativa di primo livello in tedesco.
admin1_enstringcaracteristiques_communes.admin1_enNome della divisione amministrativa di primo livello in inglese.
admin1_esstringcaracteristiques_communes.admin1_esNome della divisione amministrativa di primo livello in spagnolo.
admin1_frstringcaracteristiques_communes.admin1_frNome della divisione amministrativa di primo livello in francese.
admin1_geonames_idstringcaracteristiques_communes.admin1_geonames_idIdentificativo GeoNames proprio della regione / divisione di primo livello. Fonte: GeoNames admin1CodesASCII.
admin1_iso_codestringcaracteristiques_communes.admin1_iso_codeCodice ufficiale ISO 3166-2 della regione o dello stato federato (es. FR-ARA, US-CA, DE-BY). Fonte: Wikidata (proprietà P300 associata al GeoNames ID della regione).
admin1_itstringcaracteristiques_communes.admin1_itNome della divisione amministrativa di primo livello in italiano.
admin1_nlstringcaracteristiques_communes.admin1_nlNome della divisione amministrativa di primo livello in olandese.
admin1_plstringcaracteristiques_communes.admin1_plNome della divisione amministrativa di primo livello in polacco.
admin1_ptstringcaracteristiques_communes.admin1_ptNome della divisione amministrativa di primo livello in portoghese.
admin1_trstringcaracteristiques_communes.admin1_trNome della divisione amministrativa di primo livello in turco.
admin2stringvilles.admin2Nome della divisione amministrativa di secondo livello (contea, distretto, ecc.). Fonte: GeoNames admin2Codes e API Géo / INSEE (Francia).
admin2_codestringvilles.admin2_codeCodice amministrativo composito di livello 2 (GeoNames o prefisso INSEE:). Fonte: GeoNames / INSEE.
admin2_destringcaracteristiques_communes.admin2_deNome della divisione amministrativa di secondo livello in tedesco.
admin2_enstringcaracteristiques_communes.admin2_enNome della divisione amministrativa di secondo livello in inglese.
admin2_esstringcaracteristiques_communes.admin2_esNome della divisione amministrativa di secondo livello in spagnolo.
admin2_frstringcaracteristiques_communes.admin2_frNome della divisione amministrativa di secondo livello in francese.
admin2_geonames_idstringcaracteristiques_communes.admin2_geonames_idIdentificativo GeoNames proprio della divisione di secondo livello. Fonte: GeoNames admin2Codes.
admin2_itstringcaracteristiques_communes.admin2_itNome della divisione amministrativa di secondo livello in italiano.
admin2_nlstringcaracteristiques_communes.admin2_nlNome della divisione amministrativa di secondo livello in olandese.
admin2_plstringcaracteristiques_communes.admin2_plNome della divisione amministrativa di secondo livello in polacco.
admin2_ptstringcaracteristiques_communes.admin2_ptNome della divisione amministrativa di secondo livello in portoghese.
admin2_trstringcaracteristiques_communes.admin2_trNome della divisione amministrativa di secondo livello in turco.
administrative_rolestringcaracteristiques_communes.administrative_roleRuolo amministrativo normalizzato (national_capital, admin1_seat, admin2_seat…). Fonte: Dedotto dal feature_code di GeoNames.
administrative_role_destringcaracteristiques_communes.administrative_role_deDenominazione del ruolo amministrativo in tedesco.
administrative_role_enstringcaracteristiques_communes.administrative_role_enDenominazione del ruolo amministrativo in inglese.
administrative_role_esstringcaracteristiques_communes.administrative_role_esDenominazione del ruolo amministrativo in spagnolo.
administrative_role_frstringcaracteristiques_communes.administrative_role_frDenominazione del ruolo amministrativo in francese.
administrative_role_itstringcaracteristiques_communes.administrative_role_itDenominazione del ruolo amministrativo in italiano.
administrative_role_nlstringcaracteristiques_communes.administrative_role_nlDenominazione del ruolo amministrativo in olandese.
administrative_role_plstringcaracteristiques_communes.administrative_role_plDenominazione del ruolo amministrativo in polacco.
administrative_role_ptstringcaracteristiques_communes.administrative_role_ptDenominazione del ruolo amministrativo in portoghese.
administrative_role_trstringcaracteristiques_communes.administrative_role_trDenominazione del ruolo amministrativo in turco.
alternate_namesjsoncaracteristiques.alternate_namesElenco JSON di varianti ortografiche, esonimi e traslitterazioni noti. Fonte: GeoNames alternateNamesV2 e dati iniziali.
area_km2numbercaracteristiques.area_km2Superficie in chilometri quadrati (km²). Fonte: API Géo / INSEE (ettari convertiti in km²) e Wikidata (P2046).
area_scopestringcaracteristiques.area_scopeEntità esatta coperta dalla superficie (commune:<INSEE> o wikidata_entity:<QID>). Fonte: API Géo / Wikidata.
area_sourcestringcaracteristiques.area_sourceRiferimento che ha fornito la superficie (geo-fr:<INSEE> o wd:<QID>). Fonte: API Géo / Wikidata.
continentstringcaracteristiques_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_trNome del continente nella lingua richiesta da lang; ripiego sul francese. Fonte: ONU M49 / CLDR.
continent_codestringcaracteristiques_communes.continent_codeCodice del continente a due lettere (EU, AS, AF, NA, SA, OC, AN). Fonte: GeoNames countryInfo.txt.
coordinate_match_distance_kmnumbercaracteristiques.coordinate_match_distance_kmDistanza in chilometri tra la coordinata di origine e il luogo GeoNames associato. Fonte: Calcolo geodetico (formula di Haversine) durante l'associazione.
coordinate_match_statusstringcaracteristiques.coordinate_match_statusStato di affidabilità dell'associazione tramite coordinate (name_agrees, coordinates_unique, coordinates_guess, geonames_direct). Fonte: Pipeline di controllo geografico di AffectionPlus.
coordinate_sourcestringcaracteristiques_communes.coordinate_sourceFonte delle coordinate GPS: OpenStreetMap quando longitudine e latitudine sono valorizzate. Fonte: OpenStreetMap (licenza ODbL).
countrystringvilles.countryAlias di country_code: codice ISO 3166-1 alpha-2 del paese o territorio.
country_codestringvilles.countryCodice di paese o territorio ISO 3166-1 alpha-2 (es. FR, GB, DK, GL). Fonte: GeoNames e contesto nazionale verificato.
country_code_iso3stringcaracteristiques_communes.country_code_iso3Codice di paese normalizzato ISO 3166-1 alpha-3 a tre lettere (es. FRA, GBR, DNK). Fonte: GeoNames countryInfo.txt.
country_namestringvilles.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_trNome del paese nella lingua richiesta da lang; ripiego sul francese. Fonte: CLDR / Babel.
country_tldstringcaracteristiques_communes.country_tldDominio Internet nazionale di primo livello ccTLD (es. .fr, .uk, .dk). Fonte: GeoNames countryInfo.txt.
currency_codestringcaracteristiques_communes.currency_codeCodice ufficiale di valuta ISO 4217 del paese o territorio (es. EUR, USD, GBP, DKK). Fonte: GeoNames countryInfo.txt.
data_sourcesstringcaracteristiques.data_sourcesElenco separato da ';' di tutte le fonti utilizzate per costruire la riga. Fonte: Registro di provenienza per riga (osm, gn, wd, insee-2023, geo-fr, cldr, un-m49, iso-3166-2).
demonym_destringcaracteristiques.demonym_deGentilizio attestato in tedesco.
demonym_enstringcaracteristiques.demonym_enGentilizio attestato in inglese.
demonym_esstringcaracteristiques.demonym_esGentilizio attestato in spagnolo.
demonym_frstringcaracteristiques.demonym_frGentilizio attestato in francese. Fonte: Wikidata P1549.
demonym_itstringcaracteristiques.demonym_itGentilizio attestato in italiano.
demonym_nlstringcaracteristiques.demonym_nlGentilizio attestato in olandese.
demonym_plstringcaracteristiques.demonym_plGentilizio attestato in polacco.
demonym_ptstringcaracteristiques.demonym_ptGentilizio attestato in portoghese.
demonym_scopestringcaracteristiques.demonym_scopeAmbito di applicazione del gentilizio (città o comune). Fonte: Wikidata / INSEE.
demonym_sourcestringcaracteristiques.demonym_sourceIdentificativo dell'entità Wikidata fonte del gentilizio. Fonte: Wikidata.
demonym_trstringcaracteristiques.demonym_trGentilizio attestato in turco.
demonyms_localjsoncaracteristiques.demonyms_localOggetto JSON di tutte le forme di gentilizio attestate per codice di lingua. Fonte: Wikidata (P1549).
density_km2numbercaracteristiques.density_km2Densità di abitanti per km² (calcolata solo se la popolazione datata e la superficie hanno lo stesso ambito). Fonte: Calcolo verificato su [population] / [area_km2].
departmentstringvilles.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_trNome della divisione amministrativa di secondo livello nella lingua richiesta; ripiego su admin2.
duplicate_name_in_countrybooleancaracteristiques_communes.duplicate_name_in_countryBooleano (true / false) che segnala se più città dello stesso paese hanno lo stesso nome ASCII. Fonte: Calcolo sull'insieme degli identificativi GeoNames del paese.
elevation_mnumbercaracteristiques.elevation_mAltitudine in metri (solo quando è fornita una misura esplicita). Fonte: GeoNames.
english_namestringcaracteristiques.english_nameNome inglese documentato.
enrichment_statusstringcaracteristiques_communes.enrichment_statusRisultato complessivo dell'associazione (name_coordinates, unmatched, coordinates_guess, geonames_direct…). Fonte: Pipeline di AffectionPlus.
feature_codestringcaracteristiques_communes.feature_codeCodice di classificazione GeoNames del luogo abitato (PPLC, PPLA, PPLA2, PPL…). Fonte: GeoNames.
geonames_idstringcaracteristiques.geonames_idIdentificativo numerico GeoNames del luogo. Fonte: GeoNames.
historical_namestringcaracteristiques.historical_nameNome originale conservato nella colonna di origine «nom historique»; non designa necessariamente un toponimo antico.
idstringvilles.idIdentificativo unico e stabile della città, conservato come testo, indipendente dal paese.
importance_tiernumbercaracteristiques.importance_tierIndice gerarchico da 1 a 5 (1 = capitale nazionale o ≥ 1 M ab.; 2 = capoluogo regionale o ≥ 200 k; 3 = sede amministrativa o ≥ 50 k; 4 = ≥ 10 k; 5 = località). Fonte: Calcolo algoritmico su [administrative_role], [feature_code] e [population].
languages_officialjsoncaracteristiques_communes.languages_officialElenco JSON dei codici delle lingue ufficiali applicabili. Fonte: Wikidata (P37) e GeoNames countryInfo.txt.
languages_scopejsoncaracteristiques_communes.languages_scopeOggetto JSON che precisa se le lingue riguardano la città (city) o il paese (country). Fonte: Metadati sull'ambito linguistico.
languages_sourcejsoncaracteristiques_communes.languages_sourceOggetto JSON che indica la fonte delle lingue ufficiali e parlate. Fonte: Wikidata e GeoNames countryInfo.
languages_spokenjsoncaracteristiques_communes.languages_spokenElenco JSON delle lingue parlate o utilizzate documentate. Fonte: Wikidata (P2936) e GeoNames countryInfo.txt.
languages_yearstringcaracteristiques_communes.languages_yearAnno di riferimento dei dati linguistici quando datati. Fonte: Wikidata.
latitudenumbervilles.latitudeLatitudine GPS in gradi decimali (WGS84), massima precisione locale conservata. Fonte: OpenStreetMap (ODbL) e corrispondenza compatibile con GeoNames.
local_namesjsoncaracteristiques.local_namesVarianti locali documentate, in formato JSON.
longitudenumbervilles.longitudeLongitudine GPS in gradi decimali (WGS84), massima precisione locale conservata. Fonte: OpenStreetMap (ODbL) e corrispondenza compatibile con GeoNames.
municipality_codestringcaracteristiques.municipality_codeCodice ufficiale del comune (in particolare il codice INSEE in Francia). Fonte: API Géo / INSEE.
namestringvilles.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_trNome nella lingua richiesta da lang; ripiego sul francese se questa variante manca.
name_asciistringcaracteristiques.name_asciiNome della città in caratteri ASCII puri (senza accenti), ideale per l'indicizzazione e la ricerca. Fonte: GeoNames asciiname.
name_languagestringlang ← villes.name_languages (bitmask)Lingua attestata del nome restituito; fr quando la variante richiesta manca.
name_local_phoneticstringcaracteristiques.name_local_phoneticAiuto alla lettura in alfabeto latino per i nomi in scritture non latine. Fonte: Varianti latine di GeoNames e nome inglese come ripiego.
official_websitestringcaracteristiques.official_websiteSito web ufficiale del comune o della località. Fonte: Wikidata (P856).
phone_prefixstringcaracteristiques_communes.phone_prefixPrefisso telefonico internazionale del paese o territorio (es. +33, +44, +1). Fonte: GeoNames countryInfo.txt.
populationnumbervilles.populationNumero di abitanti documentato (cella vuota se sconosciuto, mai 0 per impostazione predefinita). Fonte: INSEE (popolazioni comunali 2023), Wikidata (P1082) o GeoNames in base a [population_source].
population_propernumbercaracteristiques.population_properPopolazione comunale stretta (entro i confini amministrativi del comune / della località). Fonte: INSEE (popolazioni comunali 2023), Wikidata (P1082 municipal) o GeoNames.
population_scopestringcaracteristiques.population_scopeAmbito geografico della popolazione (commune, wikidata_entity, geonames_place). Fonte: Tracciabilità della pipeline di arricchimento.
population_sourcestringcaracteristiques.population_sourceFonte esatta del dato di popolazione (insee-2023, wd:<QID>, gn:<id>, original_unverified). Fonte: Tracciabilità della pipeline di arricchimento.
population_urbannumbercaracteristiques.population_urbanPopolazione dell'agglomerato / area urbana / area metropolitana collegata alla città. Fonte: Wikidata (aree urbane e metropolitane P1082) e calcolo spaziale di agglomerazione GeoNames (esclusi i sottoquartieri PPLX).
population_urban_sourcestringcaracteristiques.population_urban_sourceFonte della popolazione urbana (wd:<QID>, gn_agglomeration o proper_only). Fonte: Tracciabilità dell'agglomerato urbano di AffectionPlus.
population_yearstringcaracteristiques.population_yearAnno di riferimento del censimento o della stima della popolazione. Fonte: INSEE (2023) o qualificatore di data (P585) di Wikidata.
postal_code_formatstringcaracteristiques_communes.postal_code_formatFormato / maschera ufficiale dei codici postali del paese (es. ##### in Francia). Fonte: GeoNames countryInfo.txt.
postcodestringcaracteristiques.postcodeUno o più codici postali separati da punto e virgola (;), con gli zeri iniziali preservati. Fonte: API Géo / La Poste (Francia), GeoNames Postal Codes, Wikidata o file iniziale.
postcode_sourcestringcaracteristiques.postcode_sourceFonte dei codici postali (geo-fr, gn-postal, wd, original_unverified). Fonte: Tracciabilità postale.
postcode_statusstringcaracteristiques.postcode_statusQualità della copertura postale (commune_codes, documented_not_exhaustive, partial_codes, original_unverified). Fonte: Diagnostica della copertura postale.
regionstringvilles.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_trNome della divisione amministrativa di primo livello nella lingua richiesta; ripiego su admin1.
source_idstringvilles.idAlias di id: identificativo della stessa città.
subregion_code_m49stringcaracteristiques_communes.subregion_code_m49Codice numerico ufficiale M49 delle Nazioni Unite della sottoregione geografica (es. 155, 039). Fonte: Nazioni Unite — Classificazione statistica M49.
subregion_m49stringcaracteristiques_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_trNome della sottoregione ONU M49 nella lingua richiesta da lang; ripiego sul francese.
timezonestringcaracteristiques_communes.timezoneIdentificativo del fuso orario IANA (es. Europe/Paris, America/New_York). Fonte: GeoNames.
updated_atstringcaracteristiques.updated_atData dell'ultimo trattamento di arricchimento o verifica della riga (AAAA-MM-GG). Fonte: Pipeline di AffectionPlus.
wikidata_idstringcaracteristiques.wikidata_idIdentificativo di entità Wikidata (es. Q90 per Parigi). Fonte: Wikidata (tramite la proprietà P1566 GeoNames ID o P374 INSEE).
wikipedia_languagestringcaracteristiques.wikipedia_languageCodice della lingua dell'URL di Wikipedia fornito (es. fr, en, de). Fonte: Estratto dal sottodominio di [wikipedia_url].
wikipedia_urlstringcaracteristiques.wikipedia_urlCollegamento a Wikipedia conservato dalla fonte selezionata. La lingua del collegamento è indicata da wikipedia_language; questo collegamento non cambia con il parametro lang.

Fonti e licenze

Le popolazioni non hanno sempre lo stesso anno o perimetro. L’ordinamento usa population, non stime dell’agglomerato.

population_urban_source = gn_agglomeration indica una stima euristica, non un censimento ufficiale. population_source = original_unverified indica un valore storico non confermato. Le licenze aperte valgono anche per i dati acquistati: attribuzione e, per una banca dati derivata soggetta a ODbL, condivisione con la stessa licenza. Il pagamento remunera il servizio e non elimina i diritti di ridistribuzione concessi dalle licenze.

Condizioni d’uso