Türkiye Adres Verileri: İl, İlçe, Mahalle, Sokak ve Dış Kapı Yapısı

Bir sipariş yanlış ilçeye gidebilir. Aynı müşteri CRM'de üç farklı adresle görünebilir. "İstanbul" ile "İSTANBUL" raporda iki ayrı satır olarak çıkabilir. Bu sorunların çoğu aynı yerden doğar: adresin tek bir serbest metin kutusunda tutulması. Oysa Türkiye adres verileri belirli bir sırayla iç içe geçen katmanlardan oluşur: il, ilçe, mahalle, cadde/sokak ve dış kapı. Bu yazıda her katmanın ne anlama geldiğini anlatıyoruz. Ardından aynı isimli mahalle ve sokakların neden sorun çıkardığına, dış kapı ile iç kapı arasındaki farka ve bu yapıya uyan bir sistemin raporlamaya katkısına bakıyoruz.

Türkiye adres verilerinin beş katmanı

Adres hiyerarşisi büyükten küçüğe doğru daralır. Her katman, bir üstündeki katmanın içinde yer alır. İş ekipleri için her katmanın karşılığı şöyle özetlenebilir:

Bu sıralama keyfi değildir. Bir sokağı doğru belirlemek için önce mahallesini, mahalleyi doğru belirlemek için de önce ilçesini bilmeniz gerekir. Müşteri yalnız "Moda Caddesi No: 12" yazdığında, bu caddenin hangi şehirde olduğu belirsiz kalır. Üst katman boşsa alt katman tek başına bir şey ifade etmez.

Adres hiyerarşisine neden sırayla uyulmalı?

Adresi katmanlara ayırıp her katmanı ayrı bir alanda tutmanın üç pratik faydası vardır:

• Belirsizlik daralır. İl seçilince ilçe seçenekleri, ilçe seçilince mahalle seçenekleri azalır. Müşteri yüzlerce olasılık yerine yalnız kendi bölgesindeki seçeneklerden birini işaretler.
• Tutarsız kombinasyonlar engellenir. Serbest metinde "İzmir" ile başka bir ile ait bir ilçe adı aynı adreste yan yana yazılabilir. Katman katman seçimde bu kombinasyon hiç oluşmaz.
• Her bilgi kendi yerinde durur. Bazı adlar hem ilçe hem mahalle adı olarak kullanılabilir. Serbest metinde bir adın hangi katmana ait olduğunu anlamak zordur. Ayrı alanlarda tutulduğunda bu bilgi kendiliğinden belli olur.

Bu sırayı müşteri formuna nasıl yansıtacağınızı merak ediyorsanız il, ilçe ve mahalle seçimli adres formu rehberimize göz atabilirsiniz. Bu yazıda formun teknik kurulumuna değil, yapının iş tarafındaki etkisine odaklanıyoruz.

Aynı isimli mahalle ve sokaklar: isim, kimlik değildir

Adres verisiyle çalışan ekiplerin en sık düştüğü tuzak, bir yeri adıyla tanımlamaktır.

Mahallelerde tekrar eden adlar

"Cumhuriyet", "Yeni", "Merkez" gibi mahalle adları Türkiye'nin pek çok ilçesinde tekrar eder. Aynı ad, aynı ilçe içinde farklı yerleşimlere bağlı kayıtlarda da görülebilir. Raporunuzu mahalle adına göre gruplarsanız, birbirinden kilometrelerce uzaktaki iki mahallenin siparişleri tek satırda toplanır. Kurye bölgelerini mahalle adıyla tanımlarsanız, bir sipariş yanlış ekibin listesine düşebilir.

Müşteriye seçim yaptırırken de aynı sorun ortaya çıkar. Listede alt alta iki "Demiroluk" görünüyorsa müşteri hangisinin kendisine ait olduğunu bilemez. API Türkiye'nin mahalle listesi her kaydın bağlı olduğu yerleşimin adını da döndürür. Böylece seçim kutusunda "DEMİROLUK (ÇAVUŞOĞLU)" gibi ayırt edici bir etiket gösterilebilir. Bu ek bilgi kayıtları ayırt etmeye yarar. Resmî bir köy, belde veya şehir sınıflandırması olarak yorumlanmamalıdır.

Sokaklarda tekrar eden adlar

Sokak adlarında tekrar daha da yaygındır. "Atatürk Caddesi" ya da "Cumhuriyet Caddesi" gibi adlar ülkenin dört bir yanında bulunur. Uzun bir cadde birden fazla mahalleden geçebilir. Bu nedenle bir sokak adı ancak il, ilçe ve mahalle bilgisiyle birlikte anlam kazanır.

Karar ölçütü: adı değil, kimliği saklayın

Bu sorunun çözümü, her kaydı adıyla değil kimliğiyle tanımlamaktır. API Türkiye'de her il, ilçe, mahalle, sokak ve dış kapı kaydı, katalog sürümünden bağımsız bir kalıcı kimlik (stableId) taşır. Teknik ekibinizin sistemlere bu kimliği yazması, iş ekiplerinin günlük hayatında şu farkları yaratır:

• Raporlar ada göre değil kimliğe göre gruplanır. Aynı adlı iki mahalle karışmaz.
• Yazım farkları ("Kadikoy", "KADIKÖY", "Kadıköy") kayıtları bölmez.
• Bölge tanımları (kurye bölgesi, satış bölgesi) kimlik listesiyle yapılır ve zamanla bozulmaz.

Ekranda insanlar okunabilir adı görür, sistemler ise arka planda kimliği eşleştirir.

Dış kapı ve iç kapı: karıştırılmaması gereken iki numara

Adresin son kısmı çoğu zaman tek bir kutuya "No: 12 D: 7" şeklinde yazılır. Oysa burada iki ayrı bilgi vardır.

• Dış kapı numarası: Binanın sokak üzerindeki numarasıdır. Kurye binayı bu numarayla bulur. "12" veya "12A" gibi harf içeren değerler de alabilir. Bu yüzden sayı olarak değil, metin olarak düşünülmelidir.
• İç kapı numarası: Binanın içindeki bağımsız bölümün numarasıdır. Daire, ofis veya dükkân numarası bu gruba girer. Kurye binaya girdikten sonra doğru kapıyı bu numarayla bulur.

Bir apartmanda yaşayan otuz müşterinin dış kapı numarası aynıdır, iç kapı numaraları farklıdır. Bu ayrım yapılmazsa iki tür hata sık görülür. Birincisinde müşteri yalnız daire numarasını yazar ve kurye binayı bulamaz. İkincisinde dış kapı ile iç kapı aynı alana karışık yazılır ve sistem hangisinin hangisi olduğunu ayırt edemez.

API Türkiye'nin adres hiyerarşisi dış kapı seviyesinde biter. İç kapı, kat, blok ve adres tarifi gibi bilgileri müşteriden ayrı alanlarda almanızı öneririz. Böylece bina seviyesindeki kısım katalogla eşleşir, bina içindeki ayrıntı da kaybolmaz.

Aynı sokakta aynı dış kapı numarasını taşıyan birden fazla kayıt da görülebilir. Böyle durumlarda seçilen kaydın kimliğini saklamak, sonradan hangi binanın kastedildiğini netleştirir.

Yapılandırılmış adres verisinin raporlamaya katkısı

Adres her katmanı ayrı ve kimlikli olarak tutulduğunda, aynı veri birçok ekibin sorusuna cevap verebilir hâle gelir. Önce farkı küçük bir örnekle görelim:

Soldaki satırı ilçeye göre saymak için metin ayrıştırmak, kısaltmaları tahmin etmek ve yazım farklarını elle düzeltmek gerekir. Sağdaki kayıt ise doğrudan gruplanır. Ekiplere göre etkisi şöyle görünür:

• E-ticaret: Teslim edilemeyen veya iade edilen siparişleri ilçe ve mahalle bazında izleyebilirsiniz. Belirli bir mahallede "adres bulunamadı" kayıtları tekrar ediyorsa sorunun müşteri formunda mı yoksa teslimat tarafında mı olduğunu daha hızlı ayırt edersiniz.
• Lojistik: Kurye ve dağıtım bölgeleri mahalle kimlikleriyle tanımlanabilir. Yeni bir sipariş geldiğinde, elle sınıflandırma yapılmadan doğru bölgeye düşer.
• CRM: Mükerrer müşteri kayıtlarını ayıklamak kolaylaşır. Aynı dış kapı ve aynı iç kapı büyük olasılıkla aynı haneyi gösterir. Aynı dış kapı ama farklı iç kapı ise aynı binada farklı müşterileri işaret eder.
• Satış: Temsilci bölgelerini ilçe kimliğine bağlamak, atamaların yazım farkları yüzünden kaymasını önler. Bölgesel performans tabloları da tek tutarlı listeden üretilir.

Raporların tutarlılığı için bir nokta daha önemlidir: adres kataloğu zamanla güncellenir. Kalıcı kimlik saklamak, geçmiş kayıtlarınızın güncel katalogla bağını korur. Pro ve üzeri paketlerdeki veri seti geçmişi de bir raporun hangi katalog sürümüyle üretildiğini kayıt altına almaya yardımcı olur.

Ekibiniz için kontrol listesi

Mevcut sistemlerinizi değerlendirirken şu soruları sorabilirsiniz:

1. İl, ilçe, mahalle, cadde/sokak ve dış kapı ayrı alanlarda mı tutuluyor?
2. Müşteri ve çalışanlar adresi üstten alta doğru, bir önceki seçime göre daralan listelerden mi seçiyor?
3. Sistemlerde yalnız ad mı saklanıyor, yoksa her katmanın kalıcı kimliği de kaydediliyor mu?
4. Dış kapı ve iç kapı numaraları ayrı alanlarda mı?
5. Adres hatalı olduğunda sorunun hangi katmanda olduğu biliniyor mu? Pro ve üzeri paketlerdeki adres doğrulama, adresin hangi katmanda eşleşmediğini bildirir. Örneğin ilçe katmanında takılan bir adreste müşteriye "Adres bilgilerinizi kontrol eder misiniz?" yerine "İlçe bilginizi kontrol eder misiniz?" gibi net bir soru sorabilirsiniz.
6. Geçmişte serbest metinle toplanmış adresler için bir temizleme ve eşleştirme planı var mı?

Bu sorulardan birine "hayır" yanıtı veriyorsanız, en çok etki yaratacak adımla başlayabilirsiniz. Çoğu ekip için bu adım, yeni kayıtlarda katmanlı seçime geçmek ve kalıcı kimliği saklamaktır.

Sonraki adım

Adres hiyerarşisini sistemlerinize taşımak için teknik ekibinizle API dokümantasyonunu birlikte inceleyebilirsiniz. Formlarda kullanılabilecek hazır yapıları adres seçici bileşen örneklerinde görebilirsiniz. Paketler arasındaki farkları paket karşılaştırması bölümünden inceleyebilirsiniz. Türkiye adres kataloğunu sunan bir Türkiye API'si ile hemen denemeye başlamak isterseniz ücretsiz kayıt olarak Core paketiyle ilk adımı atabilirsiniz.