PL

CAPIT · API & DATA

Struktura bazy danych

Schemat światowej bazy miast: kolumny, identyfikatory, typy, źródła i odtwarzanie PostgreSQL.

Zaloguj się na wspólne konto
Subskrybuj — od 3 €/miesiąc

Narzędzia i dane dla Twoich stron w jednej subskrypcji.

W praktyce

Miasta na AffectionPlus

Mapa i tabela miast Madagaskaru z wyszukiwaniem i filtrami.

Zobacz miasta Madagaskaru

Nazwy miast, podziały administracyjne, liczba ludności i współrzędne wraz ze źródłami.

Bezpłatne API udostępnia 5 000 miast o najwyższej wartości population w tej wersji bazy. Wybór światowy jest stały: filtry kraju go nie rozszerzają.

Widżety wyświetlane na stronach AffectionPlus.com korzystają z całej bazy, również bez abonamentu. W innych witrynach widżet jest ograniczony do bezpłatnej listy, chyba że witryna używa tokenu wydanego w ramach aktywnego abonamentu uprawniającego do pełnego dostępu.

Struktura bazy danych

Każde miasto ma jeden wiersz, identyfikowany przez id. Podstawowe kolumny znajdują się w villes, a dodatkowe cechy w caracteristiques, połączone tym samym id. Brakujące dane pozostają null, a kody tekstowe zachowują zera wiodące.

Dane ludnościowe mogą dotyczyć różnych lat i obszarów. Ranking używa population, a nie szacunkowej ludności aglomeracji.

Identyczne cechy wielu miast są grupowane w caracteristiques_communes i powiązane przez profil_id. Profile te nie tworzą dodatkowych miast.

Eksport zawiera 1 371 405 miast. Plik skompresowany zajmuje około 140 MB, a odtworzona baza wraz z indeksami około 1,37 GB. Wymagany jest PostgreSQL z rozszerzeniem 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

WłaściwośćTypKolumna SQLOpis
admin1stringvilles.admin1Nazwa jednostki podziału administracyjnego 1. poziomu (region, stan, Land, prowincja). Źródło: GeoNames admin1CodesASCII i API Géo / INSEE (Francja).
admin1_codestringvilles.admin1_codeZłożony kod administracyjny poziomu 1 (GeoNames lub prefiks INSEE:). Źródło: GeoNames / INSEE.
admin1_destringcaracteristiques_communes.admin1_deNazwa jednostki podziału administracyjnego pierwszego poziomu po niemiecku.
admin1_enstringcaracteristiques_communes.admin1_enNazwa jednostki podziału administracyjnego pierwszego poziomu po angielsku.
admin1_esstringcaracteristiques_communes.admin1_esNazwa jednostki podziału administracyjnego pierwszego poziomu po hiszpańsku.
admin1_frstringcaracteristiques_communes.admin1_frNazwa jednostki podziału administracyjnego pierwszego poziomu po francusku.
admin1_geonames_idstringcaracteristiques_communes.admin1_geonames_idWłasny identyfikator GeoNames regionu / jednostki 1. poziomu. Źródło: GeoNames admin1CodesASCII.
admin1_iso_codestringcaracteristiques_communes.admin1_iso_codeOficjalny kod ISO 3166-2 regionu lub stanu federalnego (np. FR-ARA, US-CA, DE-BY). Źródło: Wikidata (właściwość P300 powiązana z GeoNames ID regionu).
admin1_itstringcaracteristiques_communes.admin1_itNazwa jednostki podziału administracyjnego pierwszego poziomu po włosku.
admin1_nlstringcaracteristiques_communes.admin1_nlNazwa jednostki podziału administracyjnego pierwszego poziomu po niderlandzku.
admin1_plstringcaracteristiques_communes.admin1_plNazwa jednostki podziału administracyjnego pierwszego poziomu po polsku.
admin1_ptstringcaracteristiques_communes.admin1_ptNazwa jednostki podziału administracyjnego pierwszego poziomu po portugalsku.
admin1_trstringcaracteristiques_communes.admin1_trNazwa jednostki podziału administracyjnego pierwszego poziomu po turecku.
admin2stringvilles.admin2Nazwa jednostki podziału administracyjnego 2. poziomu (departament, hrabstwo, dystrykt). Źródło: GeoNames admin2Codes i API Géo / INSEE (Francja).
admin2_codestringvilles.admin2_codeZłożony kod administracyjny poziomu 2 (GeoNames lub prefiks INSEE:). Źródło: GeoNames / INSEE.
admin2_destringcaracteristiques_communes.admin2_deNazwa jednostki podziału administracyjnego drugiego poziomu po niemiecku.
admin2_enstringcaracteristiques_communes.admin2_enNazwa jednostki podziału administracyjnego drugiego poziomu po angielsku.
admin2_esstringcaracteristiques_communes.admin2_esNazwa jednostki podziału administracyjnego drugiego poziomu po hiszpańsku.
admin2_frstringcaracteristiques_communes.admin2_frNazwa jednostki podziału administracyjnego drugiego poziomu po francusku.
admin2_geonames_idstringcaracteristiques_communes.admin2_geonames_idWłasny identyfikator GeoNames departamentu / jednostki 2. poziomu. Źródło: GeoNames admin2Codes.
admin2_itstringcaracteristiques_communes.admin2_itNazwa jednostki podziału administracyjnego drugiego poziomu po włosku.
admin2_nlstringcaracteristiques_communes.admin2_nlNazwa jednostki podziału administracyjnego drugiego poziomu po niderlandzku.
admin2_plstringcaracteristiques_communes.admin2_plNazwa jednostki podziału administracyjnego drugiego poziomu po polsku.
admin2_ptstringcaracteristiques_communes.admin2_ptNazwa jednostki podziału administracyjnego drugiego poziomu po portugalsku.
admin2_trstringcaracteristiques_communes.admin2_trNazwa jednostki podziału administracyjnego drugiego poziomu po turecku.
administrative_rolestringcaracteristiques_communes.administrative_roleZnormalizowana rola administracyjna (national_capital, admin1_seat, admin2_seat…). Źródło: wywnioskowana z feature_code GeoNames.
administrative_role_destringcaracteristiques_communes.administrative_role_deNazwa roli administracyjnej po niemiecku.
administrative_role_enstringcaracteristiques_communes.administrative_role_enNazwa roli administracyjnej po angielsku.
administrative_role_esstringcaracteristiques_communes.administrative_role_esNazwa roli administracyjnej po hiszpańsku.
administrative_role_frstringcaracteristiques_communes.administrative_role_frNazwa roli administracyjnej po francusku.
administrative_role_itstringcaracteristiques_communes.administrative_role_itNazwa roli administracyjnej po włosku.
administrative_role_nlstringcaracteristiques_communes.administrative_role_nlNazwa roli administracyjnej po niderlandzku.
administrative_role_plstringcaracteristiques_communes.administrative_role_plNazwa roli administracyjnej po polsku.
administrative_role_ptstringcaracteristiques_communes.administrative_role_ptNazwa roli administracyjnej po portugalsku.
administrative_role_trstringcaracteristiques_communes.administrative_role_trNazwa roli administracyjnej po turecku.
alternate_namesjsoncaracteristiques.alternate_namesLista JSON znanych wariantów pisowni, egzonimów i transliteracji. Źródło: GeoNames alternateNamesV2 i dane początkowe.
area_km2numbercaracteristiques.area_km2Powierzchnia w kilometrach kwadratowych (km²). Źródło: API Géo / INSEE (hektary przeliczone na km²) i Wikidata (P2046).
area_scopestringcaracteristiques.area_scopeDokładna jednostka objęta powierzchnią (commune:<INSEE> lub wikidata_entity:<QID>). Źródło: API Géo / Wikidata.
area_sourcestringcaracteristiques.area_sourceZbiór referencyjny, który dostarczył powierzchnię (geo-fr:<INSEE> lub wd:<QID>). Źródło: 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_trNazwa kontynentu w języku żądanym przez lang; w razie braku używany jest francuski. Źródło: ONZ M49 / CLDR.
continent_codestringcaracteristiques_communes.continent_codeDwuliterowy kod kontynentu (EU, AS, AF, NA, SA, OC, AN). Źródło: GeoNames countryInfo.txt.
coordinate_match_distance_kmnumbercaracteristiques.coordinate_match_distance_kmOdległość w kilometrach między współrzędną źródłową a dopasowanym miejscem GeoNames. Źródło: obliczenie geodezyjne (wzór haversine) podczas dopasowania.
coordinate_match_statusstringcaracteristiques.coordinate_match_statusStatus wiarygodności dopasowania według współrzędnych (name_agrees, coordinates_unique, coordinates_guess, geonames_direct). Źródło: potok kontroli geograficznej AffectionPlus.
coordinate_sourcestringcaracteristiques_communes.coordinate_sourceŹródło współrzędnych GPS: OpenStreetMap, gdy podano długość i szerokość geograficzną. Źródło: OpenStreetMap (na licencji ODbL).
countrystringvilles.countryAlias country_code: kod ISO 3166-1 alfa-2 kraju lub terytorium.
country_codestringvilles.countryKod ISO 3166-1 alfa-2 kraju lub terytorium (np. FR, GB, DK, GL). Źródło: GeoNames i zweryfikowany kontekst krajowy.
country_code_iso3stringcaracteristiques_communes.country_code_iso3Znormalizowany trzyliterowy kod kraju ISO 3166-1 alfa-3 (np. FRA, GBR, DNK). Źródło: 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_trNazwa kraju w języku żądanym przez lang; w razie braku używany jest francuski. Źródło: CLDR / Babel.
country_tldstringcaracteristiques_communes.country_tldKrajowa domena internetowa najwyższego poziomu ccTLD (np. .fr, .uk, .dk). Źródło: GeoNames countryInfo.txt.
currency_codestringcaracteristiques_communes.currency_codeOficjalny kod waluty ISO 4217 kraju lub terytorium (np. EUR, USD, GBP, DKK). Źródło: GeoNames countryInfo.txt.
data_sourcesstringcaracteristiques.data_sourcesLista rozdzielona znakiem ';' wszystkich źródeł użytych do zbudowania wiersza. Źródło: dziennik pochodzenia dla każdego wiersza (osm, gn, wd, insee-2023, geo-fr, cldr, un-m49, iso-3166-2).
demonym_destringcaracteristiques.demonym_dePoświadczona nazwa mieszkańców po niemiecku.
demonym_enstringcaracteristiques.demonym_enPoświadczona nazwa mieszkańców po angielsku.
demonym_esstringcaracteristiques.demonym_esPoświadczona nazwa mieszkańców po hiszpańsku.
demonym_frstringcaracteristiques.demonym_frPoświadczona nazwa mieszkańców po francusku. Źródło: Wikidata P1549.
demonym_itstringcaracteristiques.demonym_itPoświadczona nazwa mieszkańców po włosku.
demonym_nlstringcaracteristiques.demonym_nlPoświadczona nazwa mieszkańców po niderlandzku.
demonym_plstringcaracteristiques.demonym_plPoświadczona nazwa mieszkańców po polsku.
demonym_ptstringcaracteristiques.demonym_ptPoświadczona nazwa mieszkańców po portugalsku.
demonym_scopestringcaracteristiques.demonym_scopeZakres stosowania nazwy mieszkańców (miasto lub gmina). Źródło: Wikidata / INSEE.
demonym_sourcestringcaracteristiques.demonym_sourceIdentyfikator encji Wikidata będącej źródłem nazwy mieszkańców. Źródło: Wikidata.
demonym_trstringcaracteristiques.demonym_trPoświadczona nazwa mieszkańców po turecku.
demonyms_localjsoncaracteristiques.demonyms_localObiekt JSON wszystkich poświadczonych form nazw mieszkańców według kodu języka. Źródło: Wikidata (P1549).
density_km2numbercaracteristiques.density_km2Gęstość zaludnienia w mieszkańcach na km² (obliczana tylko wtedy, gdy datowana liczba ludności i powierzchnia mają ten sam zakres). Źródło: zweryfikowane obliczenie [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_trNazwa jednostki podziału administracyjnego drugiego poziomu w żądanym języku; w razie braku używane jest admin2.
duplicate_name_in_countrybooleancaracteristiques_communes.duplicate_name_in_countryWartość logiczna (true / false) sygnalizująca, czy kilka miast w tym samym kraju ma tę samą nazwę ASCII. Źródło: obliczenie na zbiorze identyfikatorów GeoNames kraju.
elevation_mnumbercaracteristiques.elevation_mWysokość n.p.m. w metrach (tylko gdy podano jawny pomiar). Źródło: GeoNames.
english_namestringcaracteristiques.english_nameUdokumentowana nazwa angielska.
enrichment_statusstringcaracteristiques_communes.enrichment_statusOgólny wynik dopasowania (name_coordinates, unmatched, coordinates_guess, geonames_direct…). Źródło: potok AffectionPlus.
feature_codestringcaracteristiques_communes.feature_codeKod klasyfikacji GeoNames miejscowości zamieszkanej (PPLC, PPLA, PPLA2, PPL…). Źródło: GeoNames.
geonames_idstringcaracteristiques.geonames_idNumeryczny identyfikator GeoNames miejsca. Źródło: GeoNames.
historical_namestringcaracteristiques.historical_nameNazwa oryginalna zachowana w kolumnie źródłowej «nom historique»; niekoniecznie oznacza dawną nazwę miejscowości.
idstringvilles.idUnikalny i stały identyfikator miasta, przechowywany jako tekst, niezależny od kraju.
importance_tiernumbercaracteristiques.importance_tierWskaźnik hierarchiczny od 1 do 5 (1 = stolica kraju lub ≥ 1 mln mieszk.; 2 = stolica regionu lub ≥ 200 tys.; 3 = siedziba władz lub ≥ 50 tys.; 4 = ≥ 10 tys.; 5 = miejscowość). Źródło: obliczenie algorytmiczne na podstawie [administrative_role], [feature_code] i [population].
languages_officialjsoncaracteristiques_communes.languages_officialLista JSON kodów obowiązujących języków urzędowych. Źródło: Wikidata (P37) i GeoNames countryInfo.txt.
languages_scopejsoncaracteristiques_communes.languages_scopeObiekt JSON określający, czy języki dotyczą miasta (city), czy kraju (country). Źródło: metadane zakresu językowego.
languages_sourcejsoncaracteristiques_communes.languages_sourceObiekt JSON wskazujący źródło języków urzędowych i mówionych. Źródło: Wikidata i GeoNames countryInfo.
languages_spokenjsoncaracteristiques_communes.languages_spokenLista JSON udokumentowanych języków mówionych lub używanych. Źródło: Wikidata (P2936) i GeoNames countryInfo.txt.
languages_yearstringcaracteristiques_communes.languages_yearRok odniesienia danych językowych, jeśli są datowane. Źródło: Wikidata.
latitudenumbervilles.latitudeSzerokość geograficzna GPS w stopniach dziesiętnych (WGS84), z zachowaną maksymalną lokalną dokładnością. Źródło: OpenStreetMap (ODbL) i zgodne dopasowanie GeoNames.
local_namesjsoncaracteristiques.local_namesUdokumentowane warianty lokalne w formacie JSON.
longitudenumbervilles.longitudeDługość geograficzna GPS w stopniach dziesiętnych (WGS84), z zachowaną maksymalną lokalną dokładnością. Źródło: OpenStreetMap (ODbL) i zgodne dopasowanie GeoNames.
municipality_codestringcaracteristiques.municipality_codeOficjalny kod gminy (w szczególności kod INSEE we Francji). Źródło: 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_trNazwa w języku żądanym przez lang; w razie braku tego wariantu używany jest francuski.
name_asciistringcaracteristiques.name_asciiNazwa miasta czystymi znakami ASCII (bez znaków diakrytycznych), idealna do indeksowania i wyszukiwania. Źródło: GeoNames asciiname.
name_languagestringlang ← villes.name_languages (bitmask)Poświadczony język zwróconej nazwy; fr, gdy żądany wariant nie istnieje.
name_local_phoneticstringcaracteristiques.name_local_phoneticPomoc w odczytaniu alfabetem łacińskim nazw w pismach nielacińskich. Źródło: warianty łacińskie GeoNames i zastępcza nazwa angielska.
official_websitestringcaracteristiques.official_websiteOficjalna strona internetowa gminy lub miejscowości. Źródło: Wikidata (P856).
phone_prefixstringcaracteristiques_communes.phone_prefixMiędzynarodowy numer kierunkowy kraju lub terytorium (np. +33, +44, +1). Źródło: GeoNames countryInfo.txt.
populationnumbervilles.populationUdokumentowana liczba mieszkańców (pusta komórka, jeśli nieznana; nigdy domyślne 0). Źródło: INSEE (ludność gmin 2023), Wikidata (P1082) lub GeoNames, zależnie od [population_source].
population_propernumbercaracteristiques.population_properŚcisła liczba ludności gminy (w granicach administracyjnych gminy / miejscowości). Źródło: INSEE (ludność gmin 2023), Wikidata (P1082 municipal) lub GeoNames.
population_scopestringcaracteristiques.population_scopeZakres geograficzny liczby ludności (commune, wikidata_entity, geonames_place). Źródło: identyfikowalność potoku wzbogacania danych.
population_sourcestringcaracteristiques.population_sourceDokładne źródło liczby ludności (insee-2023, wd:<QID>, gn:<id>, original_unverified). Źródło: identyfikowalność potoku wzbogacania danych.
population_urbannumbercaracteristiques.population_urbanLiczba ludności aglomeracji / obszaru miejskiego / metropolii powiązanej z miastem. Źródło: Wikidata (obszary miejskie i metropolitalne P1082) oraz przestrzenne obliczenie aglomeracji GeoNames (z pominięciem podosiedli PPLX).
population_urban_sourcestringcaracteristiques.population_urban_sourceŹródło liczby ludności miejskiej (wd:<QID>, gn_agglomeration lub proper_only). Źródło: identyfikowalność aglomeracji miejskiej AffectionPlus.
population_yearstringcaracteristiques.population_yearRok odniesienia spisu lub szacunku liczby ludności. Źródło: INSEE (2023) lub kwalifikator point in time (P585) z Wikidata.
postal_code_formatstringcaracteristiques_communes.postal_code_formatOficjalny format / maska kodów pocztowych kraju (np. ##### we Francji). Źródło: GeoNames countryInfo.txt.
postcodestringcaracteristiques.postcodeJeden lub kilka kodów pocztowych oddzielonych średnikiem (;), z zachowanymi zerami wiodącymi. Źródło: API Géo / La Poste (Francja), GeoNames Postal Codes, Wikidata lub plik początkowy.
postcode_sourcestringcaracteristiques.postcode_sourceŹródło kodów pocztowych (geo-fr, gn-postal, wd, original_unverified). Źródło: identyfikowalność danych pocztowych.
postcode_statusstringcaracteristiques.postcode_statusJakość pokrycia pocztowego (commune_codes, documented_not_exhaustive, partial_codes, original_unverified). Źródło: diagnostyka pokrycia pocztowego.
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_trNazwa jednostki podziału administracyjnego pierwszego poziomu w żądanym języku; w razie braku używane jest admin1.
source_idstringvilles.idAlias id: identyfikator tego samego miasta.
subregion_code_m49stringcaracteristiques_communes.subregion_code_m49Oficjalny numeryczny kod M49 Organizacji Narodów Zjednoczonych dla podregionu geograficznego (np. 155, 039). Źródło: Organizacja Narodów Zjednoczonych — klasyfikacja statystyczna 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_trNazwa podregionu ONZ M49 w języku żądanym przez lang; w razie braku używany jest francuski.
timezonestringcaracteristiques_communes.timezoneIdentyfikator strefy czasowej IANA (np. Europe/Paris, America/New_York). Źródło: GeoNames.
updated_atstringcaracteristiques.updated_atData ostatniego przetwarzania wzbogacającego lub weryfikacji wiersza (RRRR-MM-DD). Źródło: potok AffectionPlus.
wikidata_idstringcaracteristiques.wikidata_idIdentyfikator encji Wikidata (np. Q90 dla Paryża). Źródło: Wikidata (przez właściwość P1566 GeoNames ID lub P374 INSEE).
wikipedia_languagestringcaracteristiques.wikipedia_languageKod języka podanego adresu URL Wikipedii (np. fr, en, de). Źródło: wyodrębniony z subdomeny [wikipedia_url].
wikipedia_urlstringcaracteristiques.wikipedia_urlZachowany link do Wikipedii z wybranego źródła. Język linku wskazuje wikipedia_language; ten link nie zmienia się wraz z parametrem lang.

Źródła i licencje

Dane ludnościowe mogą dotyczyć różnych lat i obszarów. Ranking używa population, a nie szacunkowej ludności aglomeracji.

population_urban_source = gn_agglomeration oznacza szacunek heurystyczny, a nie oficjalny spis. population_source = original_unverified oznacza niepotwierdzoną wartość historyczną. Otwarte licencje dotyczą również kupionych danych: wskazanie źródła oraz udostępnianie na tych samych warunkach w przypadku bazy pochodnej objętej ODbL. Opłata wynagradza usługę i nie usuwa praw do redystrybucji przyznanych przez licencje.

Warunki użytkowania