Geocode Nedir? Bir Adres Nasıl Koordinata Dönüşür

Geocode, bir adresi yeryüzünde tek bir noktaya sabitleyen koordinattır. İnsan diliyle yazılmış yer adları ("10 Downing Street, London") ile makinece okunabilir geometri (51.5034, -0.1276) arasındaki köprüdür. Şimdiye kadar tıkladığınız her harita iğnesi, dokunduğunuz her "buraya teslim et" düğmesi ve çalıştırdığınız her "yakındakileri göster" sorgusu, yığının bir yerinde bir geocode tarafından besleniyordu.

Bu kılavuz, geocode'un gerçekte ne olduğunu, üretim seviyesinde bir geocoding API'sinin koordinatın yanında neler döndürdüğünü, eşleşme hassasiyeti ile confidence değerinin nasıl okunacağını ve sık karşılaşılan tuzakların nerede saklandığını anlatıyor.

Geocode Aslında Nedir

En dar anlamıyla geocode, yeryüzünde tek bir noktadır ve bilinen bir datumda (neredeyse her zaman WGS84, telefonunuzun GPS'inin kullandığı datumun aynısı) bir enlem ve boylam çifti olarak ifade edilir. Enlem -90'dan (Güney Kutbu) +90'a (Kuzey Kutbu) kadar uzanır. Boylam -180 ile +180 arasındadır ve 0, Greenwich meridyenindedir.

Bu dar tanımın dışında "geocode" terimi gevşek biçimde "bir adresi geocoding API'sinden geçirmenin sonucu" anlamında da kullanılır; bu sonuç genellikle koordinatın yanına bir dizi ilgili meta veri ekler: normalleştirilmiş adres, bir yer kimliği, hassasiyet kademesi, güven puanı ve sınırlayıcı kutu. Üretim kodunda gerçekten saklayıp üzerinde işlem yaptığınız nesne işte bu zengin nesnedir.

Tek başına bir koordinat size nerede olduğunu söyler. Meta veri ise o "nere"ye ne kadar güvenmeniz gerektiğini söyler.

Forward ve Reverse Geocoding

İki yön vardır ve aynı API endpoint'i genellikle ikisini de işler.

Forward geocoding metni koordinata çevirir. Girdi: "Eyfel Kulesi, Paris". Çıktı: 48.8584, 2.2945, eşleşen yer türü (bu örnekte landmark), idari kırılım (Paris, Île-de-France, Fransa) ve özelliğin sınırlayıcı kutusu.

Reverse geocoding koordinatı metne çevirir. Girdi: 48.8584, 2.2945. Çıktı: yapılandırılmış bir adres (Avenue Gustave Eiffel, 75007 Paris, Fransa), yer türü ve genellikle yakındaki ilgi noktalarının bir listesi.

Forward, ödeme adımındaki otomatik tamamlamayı, mağaza bulucuları ve CSV-haritaya aktarım hatlarını besler. Reverse ise "Yakınımdan teslim al" düğmelerini, geotag'lı fotoğrafları ve kullanıcının haritada bir iğne bıraktığı, uygulamanın da o iğneye bir ad bulması gereken her özelliği besler. Sonraki bölümler forward yanıtını ele alıyor; reverse geocoding aşağıda kendi bölümünde anlatılıyor.

Bir Geocoding API Ne Döner

Tek başına bir koordinat, bir özelliği yayına almaya yetmez. Ciddi bir geocoding API, kodda karar vermenizi sağlayan yapılandırılmış bir nesne döner. Önemli alanlar:

• latitude / longitude WGS84 datumunda
• formatted_address: gösterim için normalleştirilmiş, kanonik adres metni
• place_id: saklayıp daha sonra yeniden çözebileceğiniz kararlı bir tanımlayıcı
• precision (bazen match_type veya accuracy): rooftop, sokak, mahalle, posta kodu, yerleşim yeri ya da ülke. İş kararları verirken en kritik tek alandır
• confidence: API'nin ne kadar emin olduğunu gösteren sayısal puan (genellikle 0 ile 1 arası)
• bbox: eşleşen özelliğin sınırlayıcı kutusu, haritayı sonuca sığdırmak için faydalıdır
• address_components: adresin yapılandırılmış parçalara ayrılmış hali (sokak, numara, şehir, bölge, ülke, posta kodu)
• country_code: ISO 3166-1 alpha-2 formatında

İki gerçek kaydın hassasiyeti birbirinden çok farklı olur. Bir teslimat göndermeden önce konut adresi için rooftop eşleşmesi istersiniz. "Bana en yakın mağazayı göster" için posta kodu seviyesindeki bir eşleşme yeterlidir. Bir locality eşleşmesi yalnızca şehri bildiğiniz anlamına gelir; bu da onay almadan harekete geçmek için neredeyse hiçbir zaman yeterli değildir.

Geocode'lar Nerede Kullanılır

Geocode'lar, konum bilinçli ürün özelliklerinin çoğunun altında sessizce çalışır.

• Adres otomatik tamamlama: ödeme formundaki her tuş vuruşu, sıralanmış aday eşleşmeleri döndüren bir forward geocode tetikler
• Mağaza ve mekan bulucular: kullanıcının mevcut konumu (bir geocode), saklı konum listesiyle (yine geocode'lar) eşleştirilir ve haversine mesafesine göre sıralanır
• Teslimat ve sevkiyat: müşterinin adresinin forward geocode'u, sürücü uygulamasına rota oluşturacağı kesin bir koordinat verir
• İlanlar ve envanter: gayrimenkul, tatil kiralama ve otel platformları her ilanı veri girişinde bir kez geocode eder, koordinatı saklar ve "bu bölgede" aramaları için kullanır
• Analitik ve dashboard'lar: gelen kayıtlar (siparişler, destek talepleri, IoT olayları) bölgeye göre toplulaştırılabilsin ya da haritada görselleştirilebilsin diye geocode'lanır
• AI ajanları ve asistanlar: bir LLM'e "yakınımda bir restoran bul" dendiğinde, geocoding adımı kullanıcının konumunu ve aday yerleri koordinatlara çevirir, böylece model mesafe üzerine akıl yürütebilir

Bunların hepsinde geocode, birleştirici anahtardır. Aynı yere ait iki kaydın, adres metinleri "Sokak" mı yoksa "Sk." mi diye anlaşamadığında bile aynı haritada yan yana durmasını sağlayan şey budur.

Reverse geocoding ayrıntılı

Reverse geocoding bir WGS84 koordinatını alır ve en yakın anlamlı yeri döner. Asıl iş "anlamlı" kelimesinde saklı. Bir otoparkın ortasındaki noktanın kendi sokak adresi yoktur. Kıyıdan on metre açıktaki bir GPS konumu karada bile değildir. Reverse geocoder, kullanıcının büyük olasılıkla neyi kastettiğine karar vermek zorundadır: önündeki bina mı, üzerinde sürdüğü yol mu, yoksa az önce girdiği park mı.

Bu karar, her şeyden önce okumanız gereken iki alanda görünür:

• Yer türü (bazen layer veya match_type): bina ya da adres, sokak, mahalle, yerleşim yeri, park, su. Noktanın neye çözümlendiğini söyler.
• Mesafe: eşleşen özelliğin sorgu noktasına ne kadar uzak olduğu. Üç metre ötedeki bir adres eşleşmesi sağlamdır. Yetmiş metre ötedeki bir sokak eşleşmesi genellikle iğnenin bir tarlaya düştüğü anlamına gelir.

Yanıtın geri kalanı forward geocoding ile aynıdır: istenen dilde formatlanmış adres, yer kimliği, adres bileşenleri ve ISO ülke kodu.

Reverse geocoding nerede kullanılır

Her durumda önce cihaz veya kullanıcı bir nokta üretir, adres bu noktadan türetilir:

• İğneyle ödeme adımı: kullanıcı iğneyi tam kapısının önüne kaydırır, uygulama da adresi ona geri onaylatır
• Geotag'lı fotoğraflar: bir EXIF koordinatı iki sayı yerine "Paris, Fransa" olur, eski arşivlerin toplu olarak işlenmesi de buna dahil
• "Yakınımda" düğmeleri: cihaz konumu bir aramayı başlatan bir yerleşim yerine çözümlenir
• Filo ve IoT telemetrisi: yolculuk başlangıçları, duraklar ve sensör olayları koordinat olarak gelir ve veri girişinde bir kez etiketlenir, böylece panolar sokak adlarını gösterir

Burada kaynak gerçek (source of truth) koordinat olduğu için onu saklayın, çözümlenen adresi ise yenilenebilir bir gösterim değeri olarak ele alın.

Reverse geocoding tuzakları

Kıyıdaki ve sudaki noktalar. GPS gürültüsü iğneleri düzenli olarak bir nehre ya da birkaç metre açığa düşürür. Bazı API'ler hiçbir şey dönmez, bazıları en yakın yola atlar, bazıları su kütlesini döner. Her yanıtı sokak adresi gibi ele almak yerine arayüzün su eşleşmesini nasıl göstereceğine önceden karar verin.

Yalnızca posta kodu eşleşmeleri. Yoğun bölgelerin dışında en yakın sonuç, birkaç kilometrekarelik bir posta kodu alanı olabilir. Geçerli görünür ama işlem yapmaya yetmez; doğrulanmış adres olarak göstermeden önce yer türünü kontrol edin.

Dil. Tokyo'daki bir nokta, istek diline göre kanji, romaji veya İngilizce dönebilir. Kullanıcılara yerelleştirilmiş adları gösterin, iç logları tek bir standart dilde tutun.

Büyük tesislerin içindeki noktalar. Parklar, kampüsler ve alışveriş merkezleri poligondur. İçerideki herhangi bir iğne yalnızca en yakın yola değil tesisin kendisine çözümlenmelidir; bu yüzden merkezden uzak noktalarla test edin.

Gürültülü GPS izleri. Araç verisinde izi önce map matching ile yol ağına oturtun, ardından oturtulmuş noktaları reverse geocoding'den geçirin. Aksi halde otoyoldaki bir araç, yolun yanındaki bir evin adresiyle etiketlenebilir.

Koordinattan adres bulma

"Koordinattan adres bulma" ya da "koordinat ile adres bulma", reverse geocoding'in gündelik adıdır. Elinizdeki koordinat sayısına göre üç yol var.

Tek koordinat, elle. Enlem ve boylamı koordinat aracına yapıştırın; araç en yakın adresi haritada gösterir. Haritaya tıklayabilir veya iğneyi sürükleyebilirsiniz de.

Çok sayıda koordinat, kodla. Bir reverse geocoding endpoint'ini noktayla çağırın ve tek bir sonuç isteyin:

curl "https://gateway.mapmetrics-atlas.net/reverse-geocode/?point.lat=52.3905&point.lon=4.829&size=1&token=YOUR_API_KEY"

Yanıt bir GeoJSON FeatureCollection'dır. İlk okunacak alanlar, kısaltılmış haliyle:

{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [4.82924, 52.39044] },
  "properties": {
    "layer": "address",
    "label": "Rhôneweg 20, Amsterdam",
    "accuracy": "point",
    "country_code": "NL"
  }
}

layer, noktanın neye çözümlendiğini söyler. address kapı numaralı bir adres demektir; street veya locality sonucu ise yeterince yakın bir adres olmadığını gösterir.

Herhangi bir şeyi çağırmadan önce girdiyi kontrol edin. Koordinat hatalarının çoğu sorgudan önce oluşur:

• Sıra. Harita uygulamaları ve çoğu form enlemi önce yazar (52.3905, 4.829). GeoJSON ve birçok API boylamı önce yazar. İkisini karıştırırsanız Amsterdam'daki bir nokta Somali açıklarında, Hint Okyanusu'na düşer.
• Format. 52°23'25.8"N 4°49'44.4"E, derece, dakika ve saniye cinsinden aynı noktadır. Göndermeden önce ondalık dereceye çevirin (52.3905, 4.8290).
• Ondalık virgül. Türkçede ondalık ayırıcı virgüldür, yani "52,3905" doğal yazımdır. Birçok API ve URL parametresi ise ondalık nokta bekler ve "52,3905" ifadesini iki sayı olarak okur. Çağırmadan önce virgülü noktaya çevirin.

Koordinat ne kadar hassas olmalı

Reverse geocoder noktaya en yakın adresi döner, dolayısıyla yanıt ancak koordinat kadar iyidir. Üç yoğun şehir merkezinde adreslerin birbirinden ne kadar uzak olduğunu, 1 km'ye 1 km'lik bir kare içindeki tüm OpenStreetMap adres noktalarıyla ölçtük ve bunu her ondalık basamağın yerdeki karşılığıyla karşılaştırdık:

Buradan üç sonuç çıkıyor:

• Dört ondalık basamak bir ev için yetmez. Dört ondalık basamağa yuvarlamak Amsterdam'da bir noktayı 6,5 metreye kadar, yuvarlamak yerine basamakları kesmek ise 13 metreye kadar kaydırır. Bu, bir ya da iki kanal evi veya Madrid'de bir sonraki kapı demektir. Adres düzeyindeki her şey için beş veya altı ondalık basamak kullanın.
• Telefon konumu sokağı bulur, kapıyı her zaman bulmaz. GPS.gov'a göre GPS'li akıllı telefonlar açık gökyüzü altında genellikle 4,9 metre içinde doğrudur, yüksek binalar arasında daha az. Berlin'de bu çoğunlukla doğru kapı numarasına denk gelir. Kanal kuşağında komşuya düşebilir. Teslimat adresi için sonucu gösterin ve kullanıcının onaylamasına veya iğneyi kaydırmasına izin verin.
• Tek bir nokta birçok adres taşıyabilir. Amsterdam'daki 9.227 adres noktası 4.113 kapı numarasını paylaşıyor, çünkü her dairenin neredeyse aynı konumda kendi adresi var (Keizersgracht 123-1, 123-2 gibi). Hiçbir koordinat bunlar arasında seçim yapamaz; daireyi kullanıcıya sorun.

Yöntem ve ham veriler scripts/seo/blog-keyword-research/what-is-a-geocode-address-spacing.mjs ve docs/blog-keyword-research/what-is-a-geocode-address-spacing-2026-09-30.json dosyalarında; yerdeki karşılıklar ve yuvarlama hataları aynı klasördeki what-is-geojson.mjs dosyasından geliyor. Adres verisi © OpenStreetMap contributors (ODbL), 30 Eylül 2026'da sorgulandı.

Üretimdeki Tuzaklar

Geocoding, ilk gün kolay görünen ama her hafta biraz daha zorlaşan bir problemdir.

Adres belirsizliği. ABD Jeolojik Araştırmalar Kurumu (U.S. Geological Survey), ABD'de Springfield adını taşıyan 93 yerleşim yeri sayıyor. Ülke, bölge veya posta kodu bağlamı olmadan forward geocode bir yazı tura atışıdır. Elinizde olan tüm bağlamı, ülke kodunu da bias parametresi olarak ekleyerek her zaman gönderin.

Bayatlamış koordinatlar. Sokak numaraları yeniden düzenlenir, mahalle adları değişir, yeni binalar ortaya çıkar. İki yıl önce sakladığınız bir geocode artık aynı binayı göstermiyor olabilir. Tazeliğin önemli olduğu kayıtlar için (teslimat, sevkiyat, regüle sektörler) periyodik olarak yeniden geocode edip saklı koordinatla karşılaştırın.

Hassasiyet aklama. Saf bir UI, hassasiyet locality olduğunda bile geocode sonucunu "✓ Adres bulundu" olarak gösterir. Kullanıcı yeşil tiki görür ve adresin doğrulandığını sanır; oysa API yalnızca şehri eşleştirmiştir. Ödeme veya KYC gibi yüksek riskli akışlarda hassasiyet kademesini her zaman UI'da görünür kılın.

Kota ve hız limitleri. Geocoding API'leri istek başına ücretlendirilir ve saniyede sınırlanır. Toplu işlemler batch'leme, kullanıcıya dönük otomatik tamamlama ise istemci tarafında debounce gerektirir.

Gizlilik. Bir koordinat artı bir zaman damgası kişisel veridir. Geocode'ları diğer her PII gibi davranın: depolamayı kilitleyin, erişimi loglayın ve faaliyet gösterdiğiniz bölgenin GDPR kurallarına uyun.

MapAtlas'ta Geocoding

MapAtlas Geocoding API, forward ve reverse geocoding'i tek bir endpoint'ten işler. Yukarıda sayılan standart alanları (formatlanmış adres, place ID, hassasiyet, güven, sınırlayıcı kutu, adres bileşenleri) döner ve milyonlarca satır işlemesi gereken veri girişi hatları için batch geocoding'i destekler. Ülke ve dil bias parametreleri, her yerel için ayrı istek atmaya gerek bırakmadan sonuçların Avrupa ve global hedef kitleler için alakalı kalmasını sağlar.

Geocoding'i seyahat süresi analiziyle birleştiren iş yükleri için Geocoding API, Isochrone API ve Distance Matrix API ile bir arada çalışır; böylece tek bir adres sorgusu doğrudan "15 dakika içindeki her şeyi göster" veya "bu adayları sürüş süresine göre sırala" akışına bağlanabilir.

Geocode gösterişli değildir. Sadece bir koordinattır. Ama bir metin parçasını, uygulamanın üzerine akıl yürütebileceği bir yere dönüştüren koordinat odur ve o tek veriyi doğru almak, gerçek anlamda konum bilinçli bir özelliği yanlış kıtaya iliştirilmiş bir iğneden ayıran şeydir.