TR

CAPIT · API & DATA

Veritabanı yapısı

Dünya şehir veritabanı şeması: sütunlar, tanımlayıcılar, türler, kaynaklar ve PostgreSQL geri yükleme.

Ortak hesabımla oturum aç
Abone ol — aylık 3 €’dan başlayan fiyatlarla

Web siteleriniz için araçlar ve veriler, tek abonelikte.

Kullanım örnekleri

AffectionPlus’ta şehirler

Arama ve filtrelerle Madagaskar şehirlerinin haritası ve tablosu.

Madagaskar şehirlerini inceleyin

Kaynaklarıyla birlikte şehir adları, idari bölümler, nüfuslar ve koordinatlar.

Ücretsiz API, bu veritabanı sürümündeki en yüksek population değerine sahip 5.000 şehri sunar. Dünya genelindeki bu seçim sabittir; ülke filtreleri seçimi genişletmez.

AffectionPlus.com sayfalarında gösterilen bileşenler, aboneliği olmayan ziyaretçiler için de tüm veritabanını kullanır. Diğer sitelerde bileşen, site tam erişim sağlayan etkin bir abonelikle oluşturulmuş bir belirteç kullanmadıkça ücretsiz seçimle sınırlıdır.

Veritabanı yapısı

Her şehir, id ile tanımlanan tek bir satırda yer alır. Temel sütunlar villes tablosundadır; ek özellikler aynı id ile bağlı caracteristiques tablosundadır. Eksik bilgiler null kalır ve metin kodlarının başındaki sıfırlar korunur.

Nüfuslar aynı yıla veya coğrafi sınırlara ait olmayabilir. Sıralama tahmini kentsel nüfus yerine population alanını kullanır.

Birden çok şehrin aynı özellikleri caracteristiques_communes tablosunda gruplanır ve profil_id ile bağlanır. Bu profiller ek şehir oluşturmaz.

Dışa aktarım 1.371.405 şehir içerir. Sıkıştırılmış dosya yaklaşık 140 MB, dizinlerle birlikte geri yüklenen veritabanı yaklaşık 1,37 GB yer kaplar. pg_trgm uzantılı PostgreSQL gereklidir.

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

ÖzellikTürSQL sütunuAçıklama
admin1stringvilles.admin11. düzey idari bölümün adı (bölge, eyalet, Land, il). Kaynak: GeoNames admin1CodesASCII ve API Géo / INSEE (Fransa).
admin1_codestringvilles.admin1_code1. düzey bileşik idari kod (GeoNames veya INSEE: öneki). Kaynak: GeoNames / INSEE.
admin1_destringcaracteristiques_communes.admin1_deBirinci düzey idari bölümün Almanca adı.
admin1_enstringcaracteristiques_communes.admin1_enBirinci düzey idari bölümün İngilizce adı.
admin1_esstringcaracteristiques_communes.admin1_esBirinci düzey idari bölümün İspanyolca adı.
admin1_frstringcaracteristiques_communes.admin1_frBirinci düzey idari bölümün Fransızca adı.
admin1_geonames_idstringcaracteristiques_communes.admin1_geonames_idBölgenin / 1. düzey bölümün kendi GeoNames tanımlayıcısı. Kaynak: GeoNames admin1CodesASCII.
admin1_iso_codestringcaracteristiques_communes.admin1_iso_codeBölgenin veya federe eyaletin resmî ISO 3166-2 kodu (örn. FR-ARA, US-CA, DE-BY). Kaynak: Wikidata (bölgenin GeoNames ID'siyle ilişkili P300 özelliği).
admin1_itstringcaracteristiques_communes.admin1_itBirinci düzey idari bölümün İtalyanca adı.
admin1_nlstringcaracteristiques_communes.admin1_nlBirinci düzey idari bölümün Felemenkçe adı.
admin1_plstringcaracteristiques_communes.admin1_plBirinci düzey idari bölümün Lehçe adı.
admin1_ptstringcaracteristiques_communes.admin1_ptBirinci düzey idari bölümün Portekizce adı.
admin1_trstringcaracteristiques_communes.admin1_trBirinci düzey idari bölümün Türkçe adı.
admin2stringvilles.admin22. düzey idari bölümün adı (département, kontluk, ilçe). Kaynak: GeoNames admin2Codes ve API Géo / INSEE (Fransa).
admin2_codestringvilles.admin2_code2. düzey bileşik idari kod (GeoNames veya INSEE: öneki). Kaynak: GeoNames / INSEE.
admin2_destringcaracteristiques_communes.admin2_deİkinci düzey idari bölümün Almanca adı.
admin2_enstringcaracteristiques_communes.admin2_enİkinci düzey idari bölümün İngilizce adı.
admin2_esstringcaracteristiques_communes.admin2_esİkinci düzey idari bölümün İspanyolca adı.
admin2_frstringcaracteristiques_communes.admin2_frİkinci düzey idari bölümün Fransızca adı.
admin2_geonames_idstringcaracteristiques_communes.admin2_geonames_idDépartement'ın / 2. düzey bölümün kendi GeoNames tanımlayıcısı. Kaynak: GeoNames admin2Codes.
admin2_itstringcaracteristiques_communes.admin2_itİkinci düzey idari bölümün İtalyanca adı.
admin2_nlstringcaracteristiques_communes.admin2_nlİkinci düzey idari bölümün Felemenkçe adı.
admin2_plstringcaracteristiques_communes.admin2_plİkinci düzey idari bölümün Lehçe adı.
admin2_ptstringcaracteristiques_communes.admin2_ptİkinci düzey idari bölümün Portekizce adı.
admin2_trstringcaracteristiques_communes.admin2_trİkinci düzey idari bölümün Türkçe adı.
administrative_rolestringcaracteristiques_communes.administrative_roleNormalleştirilmiş idari rol (national_capital, admin1_seat, admin2_seat…). Kaynak: GeoNames feature_code değerinden çıkarılmıştır.
administrative_role_destringcaracteristiques_communes.administrative_role_deİdari rol etiketinin Almancası.
administrative_role_enstringcaracteristiques_communes.administrative_role_enİdari rol etiketinin İngilizcesi.
administrative_role_esstringcaracteristiques_communes.administrative_role_esİdari rol etiketinin İspanyolcası.
administrative_role_frstringcaracteristiques_communes.administrative_role_frİdari rol etiketinin Fransızcası.
administrative_role_itstringcaracteristiques_communes.administrative_role_itİdari rol etiketinin İtalyancası.
administrative_role_nlstringcaracteristiques_communes.administrative_role_nlİdari rol etiketinin Felemenkçesi.
administrative_role_plstringcaracteristiques_communes.administrative_role_plİdari rol etiketinin Lehçesi.
administrative_role_ptstringcaracteristiques_communes.administrative_role_ptİdari rol etiketinin Portekizcesi.
administrative_role_trstringcaracteristiques_communes.administrative_role_trİdari rol etiketinin Türkçesi.
alternate_namesjsoncaracteristiques.alternate_namesBilinen yazım varyantlarının, egzonimlerin ve çevriyazıların JSON listesi. Kaynak: GeoNames alternateNamesV2 ve ilk veriler.
area_km2numbercaracteristiques.area_km2Kilometrekare (km²) cinsinden yüzölçümü. Kaynak: API Géo / INSEE (hektarlar km²'ye çevrilmiştir) ve Wikidata (P2046).
area_scopestringcaracteristiques.area_scopeYüzölçümünün kapsadığı tam varlık (commune:<INSEE> veya wikidata_entity:<QID>). Kaynak: API Géo / Wikidata.
area_sourcestringcaracteristiques.area_sourceYüzölçümünü sağlayan referans (geo-fr:<INSEE> veya wd:<QID>). Kaynak: 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_trlang ile istenen dildeki kıta adı; Fransızcaya geri dönülür. Kaynak: BM M49 / CLDR.
continent_codestringcaracteristiques_communes.continent_codeİki harfli kıta kodu (EU, AS, AF, NA, SA, OC, AN). Kaynak: GeoNames countryInfo.txt.
coordinate_match_distance_kmnumbercaracteristiques.coordinate_match_distance_kmKaynak koordinat ile eşleştirilen GeoNames yeri arasındaki kilometre cinsinden mesafe. Kaynak: eşleştirme sırasında jeodezik hesaplama (Haversine formülü).
coordinate_match_statusstringcaracteristiques.coordinate_match_statusKoordinatlara dayalı eşleştirmenin güven durumu (name_agrees, coordinates_unique, coordinates_guess, geonames_direct). Kaynak: AffectionPlus coğrafi kontrol hattı.
coordinate_sourcestringcaracteristiques_communes.coordinate_sourceGPS koordinatlarının kaynağı: boylam ve enlem doldurulmuşsa OpenStreetMap. Kaynak: OpenStreetMap (ODbL lisanslı).
countrystringvilles.countrycountry_code takma adı: ülke veya bölgenin ISO 3166-1 alfa-2 kodu.
country_codestringvilles.countryÜlke veya bölgenin ISO 3166-1 alfa-2 kodu (örn. FR, GB, DK, GL). Kaynak: GeoNames ve doğrulanmış ulusal bağlam.
country_code_iso3stringcaracteristiques_communes.country_code_iso3Üç harfli normalleştirilmiş ISO 3166-1 alfa-3 ülke kodu (örn. FRA, GBR, DNK). Kaynak: 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_trlang ile istenen dildeki ülke adı; Fransızcaya geri dönülür. Kaynak: CLDR / Babel.
country_tldstringcaracteristiques_communes.country_tldUlusal üst düzey internet alan adı ccTLD (örn. .fr, .uk, .dk). Kaynak: GeoNames countryInfo.txt.
currency_codestringcaracteristiques_communes.currency_codeÜlke veya bölgenin resmî ISO 4217 para birimi kodu (örn. EUR, USD, GBP, DKK). Kaynak: GeoNames countryInfo.txt.
data_sourcesstringcaracteristiques.data_sourcesSatırı oluşturmak için kullanılan tüm kaynakların ';' ile ayrılmış listesi. Kaynak: satır başına köken günlüğü (osm, gn, wd, insee-2023, geo-fr, cldr, un-m49, iso-3166-2).
demonym_destringcaracteristiques.demonym_deBelgelenmiş Almanca yer sakini adı.
demonym_enstringcaracteristiques.demonym_enBelgelenmiş İngilizce yer sakini adı.
demonym_esstringcaracteristiques.demonym_esBelgelenmiş İspanyolca yer sakini adı.
demonym_frstringcaracteristiques.demonym_frBelgelenmiş Fransızca yer sakini adı. Kaynak: Wikidata P1549.
demonym_itstringcaracteristiques.demonym_itBelgelenmiş İtalyanca yer sakini adı.
demonym_nlstringcaracteristiques.demonym_nlBelgelenmiş Felemenkçe yer sakini adı.
demonym_plstringcaracteristiques.demonym_plBelgelenmiş Lehçe yer sakini adı.
demonym_ptstringcaracteristiques.demonym_ptBelgelenmiş Portekizce yer sakini adı.
demonym_scopestringcaracteristiques.demonym_scopeYer sakini adının uygulama kapsamı (şehir veya belediye). Kaynak: Wikidata / INSEE.
demonym_sourcestringcaracteristiques.demonym_sourceYer sakini adının kaynağı olan Wikidata varlığının tanımlayıcısı. Kaynak: Wikidata.
demonym_trstringcaracteristiques.demonym_trBelgelenmiş Türkçe yer sakini adı.
demonyms_localjsoncaracteristiques.demonyms_localDil koduna göre belgelenmiş tüm yer sakini adı biçimlerinin JSON nesnesi. Kaynak: Wikidata (P1549).
density_km2numbercaracteristiques.density_km2Km² başına düşen nüfus yoğunluğu (yalnızca tarihli nüfus ile yüzölçümü aynı kapsamdaysa hesaplanır). Kaynak: [population] / [area_km2] üzerinden doğrulanmış hesaplama.
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_trİstenen dilde ikinci düzey idari bölümün adı; yoksa admin2'ye geri dönülür.
duplicate_name_in_countrybooleancaracteristiques_communes.duplicate_name_in_countryAynı ülkedeki birden çok şehrin aynı ASCII adını taşıyıp taşımadığını gösteren Boole değeri (true / false). Kaynak: ülkenin tüm GeoNames tanımlayıcıları üzerinde hesaplama.
elevation_mnumbercaracteristiques.elevation_mMetre cinsinden rakım (yalnızca açık bir ölçüm sağlandığında). Kaynak: GeoNames.
english_namestringcaracteristiques.english_nameBelgelenmiş İngilizce ad.
enrichment_statusstringcaracteristiques_communes.enrichment_statusEşleştirmenin genel sonucu (name_coordinates, unmatched, coordinates_guess, geonames_direct…). Kaynak: AffectionPlus hattı.
feature_codestringcaracteristiques_communes.feature_codeYerleşim yerinin GeoNames sınıflandırma kodu (PPLC, PPLA, PPLA2, PPL…). Kaynak: GeoNames.
geonames_idstringcaracteristiques.geonames_idYerin sayısal GeoNames tanımlayıcısı. Kaynak: GeoNames.
historical_namestringcaracteristiques.historical_name«nom historique» kaynak sütununda korunan özgün ad; mutlaka eski bir yer adını göstermez.
idstringvilles.idŞehrin benzersiz ve kararlı tanımlayıcısı, metin olarak saklanır, ülkeden bağımsızdır.
importance_tiernumbercaracteristiques.importance_tier1'den 5'e hiyerarşik gösterge (1 = ulusal başkent veya ≥ 1 M nüfus; 2 = bölge başkenti veya ≥ 200 bin; 3 = idari merkez veya ≥ 50 bin; 4 = ≥ 10 bin; 5 = yerleşim yeri). Kaynak: [administrative_role], [feature_code] ve [population] üzerinden algoritmik hesaplama.
languages_officialjsoncaracteristiques_communes.languages_officialGeçerli resmî dil kodlarının JSON listesi. Kaynak: Wikidata (P37) ve GeoNames countryInfo.txt.
languages_scopejsoncaracteristiques_communes.languages_scopeDillerin şehre (city) mi ülkeye (country) mi ait olduğunu belirten JSON nesnesi. Kaynak: dil kapsamı üst verisi.
languages_sourcejsoncaracteristiques_communes.languages_sourceResmî ve konuşulan dillerin kaynağını gösteren JSON nesnesi. Kaynak: Wikidata ve GeoNames countryInfo.
languages_spokenjsoncaracteristiques_communes.languages_spokenBelgelenmiş konuşulan veya kullanılan dillerin JSON listesi. Kaynak: Wikidata (P2936) ve GeoNames countryInfo.txt.
languages_yearstringcaracteristiques_communes.languages_yearTarihli olduğunda dil verilerinin referans yılı. Kaynak: Wikidata.
latitudenumbervilles.latitudeOndalık derece cinsinden GPS enlemi (WGS84), yerel azami hassasiyet korunmuştur. Kaynak: OpenStreetMap (ODbL) ve uyumlu GeoNames eşleştirmesi.
local_namesjsoncaracteristiques.local_namesBelgelenmiş yerel varyantlar, JSON biçiminde.
longitudenumbervilles.longitudeOndalık derece cinsinden GPS boylamı (WGS84), yerel azami hassasiyet korunmuştur. Kaynak: OpenStreetMap (ODbL) ve uyumlu GeoNames eşleştirmesi.
municipality_codestringcaracteristiques.municipality_codeBelediyenin resmî kodu (özellikle Fransa'da INSEE kodu). Kaynak: 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_trlang ile istenen dildeki ad; bu varyant yoksa Fransızcaya geri dönülür.
name_asciistringcaracteristiques.name_asciiŞehrin saf ASCII karakterlerle (aksansız) adı; dizinleme ve arama için idealdir. Kaynak: GeoNames asciiname.
name_languagestringlang ← villes.name_languages (bitmask)Döndürülen adın belgelenmiş dili; istenen varyant yoksa fr.
name_local_phoneticstringcaracteristiques.name_local_phoneticLatin olmayan yazılardaki adlar için Latin alfabesiyle okuma yardımı. Kaynak: GeoNames Latin varyantları ve yedek İngilizce ad.
official_websitestringcaracteristiques.official_websiteBelediyenin veya yerleşim yerinin resmî web sitesi. Kaynak: Wikidata (P856).
phone_prefixstringcaracteristiques_communes.phone_prefixÜlke veya bölgenin uluslararası telefon kodu (örn. +33, +44, +1). Kaynak: GeoNames countryInfo.txt.
populationnumbervilles.populationBelgelenmiş nüfus (bilinmiyorsa boş hücre, asla varsayılan 0 değil). Kaynak: [population_source] değerine göre INSEE (2023 belediye nüfusları), Wikidata (P1082) veya GeoNames.
population_propernumbercaracteristiques.population_properKesin belediye nüfusu (belediyenin / yerleşimin idari sınırları içinde). Kaynak: INSEE (2023 belediye nüfusları), Wikidata (P1082 municipal) veya GeoNames.
population_scopestringcaracteristiques.population_scopeNüfusun coğrafi kapsamı (commune, wikidata_entity, geonames_place). Kaynak: zenginleştirme hattının izlenebilirliği.
population_sourcestringcaracteristiques.population_sourceNüfus rakamının tam kaynağı (insee-2023, wd:<QID>, gn:<id>, original_unverified). Kaynak: zenginleştirme hattının izlenebilirliği.
population_urbannumbercaracteristiques.population_urbanŞehre bağlı aglomerasyonun / kentsel alanın / metropolün nüfusu. Kaynak: Wikidata (kentsel ve metropol alanlar P1082) ve GeoNames mekânsal aglomerasyon hesaplaması (PPLX alt mahalleleri hariç).
population_urban_sourcestringcaracteristiques.population_urban_sourceKentsel nüfusun kaynağı (wd:<QID>, gn_agglomeration veya proper_only). Kaynak: AffectionPlus kentsel aglomerasyon izlenebilirliği.
population_yearstringcaracteristiques.population_yearNüfus sayımının veya tahmininin referans yılı. Kaynak: INSEE (2023) veya Wikidata point in time (P585) niteleyicisi.
postal_code_formatstringcaracteristiques_communes.postal_code_formatÜlkenin posta kodlarının resmî biçimi / maskesi (örn. Fransa'da #####). Kaynak: GeoNames countryInfo.txt.
postcodestringcaracteristiques.postcodeNoktalı virgülle (;) ayrılmış bir veya birden çok posta kodu, baştaki sıfırlar korunmuştur. Kaynak: API Géo / La Poste (Fransa), GeoNames Postal Codes, Wikidata veya ilk dosya.
postcode_sourcestringcaracteristiques.postcode_sourcePosta kodlarının kaynağı (geo-fr, gn-postal, wd, original_unverified). Kaynak: posta izlenebilirliği.
postcode_statusstringcaracteristiques.postcode_statusPosta kapsamının kalitesi (commune_codes, documented_not_exhaustive, partial_codes, original_unverified). Kaynak: posta kapsamı tanılaması.
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_trİstenen dilde birinci düzey idari bölümün adı; yoksa admin1'e geri dönülür.
source_idstringvilles.idid takma adı: aynı şehrin tanımlayıcısı.
subregion_code_m49stringcaracteristiques_communes.subregion_code_m49Coğrafi alt bölge için Birleşmiş Milletler'in resmî sayısal M49 kodu (örn. 155, 039). Kaynak: Birleşmiş Milletler — M49 istatistiksel sınıflandırması.
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_trlang ile istenen dildeki BM M49 alt bölge adı; Fransızcaya geri dönülür.
timezonestringcaracteristiques_communes.timezoneIANA saat dilimi tanımlayıcısı (örn. Europe/Paris, America/New_York). Kaynak: GeoNames.
updated_atstringcaracteristiques.updated_atSatırın son zenginleştirme veya doğrulama işleminin tarihi (YYYY-AA-GG). Kaynak: AffectionPlus hattı.
wikidata_idstringcaracteristiques.wikidata_idWikidata varlık tanımlayıcısı (örn. Paris için Q90). Kaynak: Wikidata (P1566 GeoNames ID veya P374 INSEE özelliği aracılığıyla).
wikipedia_languagestringcaracteristiques.wikipedia_languageVerilen Vikipedi URL'sinin dil kodu (örn. fr, en, de). Kaynak: [wikipedia_url] alt alan adından çıkarılır.
wikipedia_urlstringcaracteristiques.wikipedia_urlSeçilen kaynaktan korunan Vikipedi bağlantısı. Bağlantının dili wikipedia_language ile belirtilir; bu bağlantı lang parametresiyle değişmez.

Kaynaklar ve lisanslar

Nüfuslar aynı yıla veya coğrafi sınırlara ait olmayabilir. Sıralama tahmini kentsel nüfus yerine population alanını kullanır.

population_urban_source = gn_agglomeration resmi nüfus sayımını değil, sezgisel bir tahmini belirtir. population_source = original_unverified doğrulanmamış tarihsel bir değeri belirtir. Açık lisanslar satın alınan veriler için de geçerlidir: kaynak gösterme ve ODbL kapsamındaki türetilmiş veritabanları için aynı koşullarla paylaşma. Ödeme hizmetin karşılığıdır; lisansların verdiği yeniden dağıtım haklarını kaldırmaz.

Kullanım koşulları