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

Geocode, bir adresi yeryüzünde bir noktaya bağlayan koordinattır. İnsanların kullandığı yer adlarıyla ("10 Downing Street, London") makinelerin okuduğu geometri (51.5034, -0.1276) arasında köprü kurar. Tıkladığınız her harita iğnesinin, dokunduğunuz her "buraya teslim et" düğmesinin ve çalıştırdığınız her "yakındakileri göster" sorgusunun arkasında bir yerde bir geocode vardır.

Bu rehber, geocode'un tam olarak ne olduğunu, canlı sistemlerde kullanılan bir coğrafi kodlama (geocoding) API'sinin koordinatın yanında neler döndürdüğünü, eşleşme hassasiyetini ve güven puanını nasıl okuyacağınızı ve sık yapılan hataların nerede gizlendiğini anlatıyor.

Geocode tam olarak nedir

En dar anlamıyla geocode, yeryüzündeki tek bir noktadır. Bilinen bir datumda, neredeyse her zaman WGS84'te, bir enlem ve boylam çifti olarak yazılır. WGS84, telefonunuzun GPS'inin de kullandığı datumdur. Enlem -90 (Güney Kutbu) ile +90 (Kuzey Kutbu) arasındadır. Boylam -180 ile +180 arasındadır, 0 değeri Greenwich meridyenindedir.

Günlük kullanımda "geocode" daha geniş bir anlamda, "bir adresi coğrafi kodlama API'sinden geçirmenin sonucu" için de kullanılır. Bu sonuç genellikle koordinatın yanında bir dizi ek bilgi içerir: standart biçime getirilmiş adres, bir yer kimliği, bir hassasiyet düzeyi, bir güven puanı ve bir sınırlayıcı kutu. Kodda sakladığınız ve kararlarınızı dayandırdığınız şey de bu daha zengin nesnedir.

Koordinat tek başına size yerin nerede olduğunu söyler. Ek bilgiler ise bu konumun doğru olduğundan ne kadar emin olabileceğinizi söyler.

Adresten koordinata, koordinattan adrese

Coğrafi kodlamanın iki yönü vardır ve genellikle ikisini de aynı API uç noktası karşılar.

Normal yönde coğrafi kodlama (forward geocoding) metni koordinata çevirir. Girdi: "Eyfel Kulesi, Paris". Çıktı: 48.8584, 2.2945. Yanında eşleşen yerin türü (bu örnekte simge yapı), idari bölgeler (Paris, Île-de-France, Fransa) ve yerin sınırlayıcı kutusu gelir.

Ters coğrafi kodlama (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 çoğu zaman yakındaki ilgi noktalarının bir listesi.

Normal yön; ödeme formundaki otomatik tamamlamayı, mağaza bulucuları ve CSV dosyalarını haritaya aktaran işlemleri çalıştırır. Ters yön ise "Yakınımdan teslim al" düğmelerini, konum etiketli fotoğrafları ve kullanıcının haritaya iğne bıraktığı, uygulamanın da o iğneye bir ad bulması gereken her özelliği çalıştırır. Sonraki bölümler normal yöndeki yanıtı anlatıyor. Ters coğrafi kodlamanın kendi bölümü aşağıda.

Bir coğrafi kodlama API'si ne döndürür

Tek başına bir koordinat, bir özelliği yayına almak için yetmez. İyi bir coğrafi kodlama API'si, kodda karar vermenizi sağlayan yapılandırılmış bir nesne döndürür. Önemli alanlar şunlar:

• latitude / longitude: WGS84'te enlem ve boylam
• formatted_address: ekranda gösterilecek, standart biçime getirilmiş adres
• place_id: saklayıp daha sonra yeniden sorgulayabileceğiniz, değişmeyen bir kimlik
• precision (bazen match_type ya da accuracy): bina (rooftop), sokak, mahalle, posta kodu, yerleşim yeri ya da ülke. İş kararları için en önemli alan budur
• confidence: API'nin sonuçtan ne kadar emin olduğunu gösteren bir puan (çoğunlukla 0 ile 1 arası)
• bbox: eşleşen yerin sınırlayıcı kutusu, haritayı sonuca göre yakınlaştırmak için işe yarar
• address_components: parçalarına ayrılmış adres (sokak, numara, şehir, bölge, ülke, posta kodu)
• country_code: ISO 3166-1 alpha-2 biçiminde ülke kodu

İki gerçek kaydın hassasiyeti birbirinden çok farklı olabilir. Bir konut adresine teslimat göndermeden önce bina düzeyinde bir eşleşme istersiniz. "En yakın mağazayı göster" için posta kodu düzeyi yeterlidir. Yerleşim yeri düzeyinde bir eşleşme ise yalnızca şehri bildiğiniz anlamına gelir. Onay almadan buna göre işlem yapmak nadiren doğru olur.

Geocode nerelerde kullanılır

Konuma dayalı ürün özelliklerinin çoğunun altında sessizce geocode'lar çalışır.

• Adres otomatik tamamlama: Ödeme formunda basılan her tuş, olası eşleşmeleri sıralı döndüren bir coğrafi kodlama isteği gönderir
• Mağaza ve mekân bulucular: Kullanıcının o anki konumu (bir geocode) kayıtlı konumların listesiyle (onlar da geocode) karşılaştırılır ve haversine mesafesine göre sıralanır
• Teslimat ve sevkiyat: Müşteri adresinin geocode'u, sürücü uygulamasına rota çizebileceği kesin bir koordinat verir
• İlanlar ve stok: Gayrimenkul, tatil evi ve otel platformları her ilanın koordinatını sisteme girerken bir kez bulur, saklar ve "bu bölgede" aramalarında kullanır
• Analiz ve paneller: Gelen kayıtlar (siparişler, destek talepleri, IoT olayları) bölgeye göre toplanabilsin ya da haritada gösterilebilsin diye coğrafi kodlamadan geçirilir
• Yapay zeka ajanları ve asistanları: Bir büyük dil modeline "yakınımda bir restoran bul" dendiğinde, coğrafi kodlama adımı kullanıcının konumunu ve aday yerleri koordinata çevirir. Model mesafe üzerinden ancak böyle düşünebilir

Bütün bu örneklerde geocode, kayıtları birbirine bağlayan anahtardır. Aynı yere ait iki kaydın adresleri "Sokak" ile "Sk." konusunda anlaşamasa bile aynı haritada yan yana durabilmesi geocode sayesindedir.

Ters coğrafi kodlamaya yakından bakış

Ters coğrafi kodlama bir WGS84 koordinatı alır ve en yakın anlamlı yeri döndürür. Asıl iş "anlamlı" kelimesinde. Bir otoparkın ortasındaki noktanın kendine ait bir sokak adresi yoktur. Kıyıdan on metre açıktaki bir GPS konumu karada bile değildir. Ters coğrafi kodlama, kullanıcının büyük olasılıkla neyi kastettiğine karar vermek zorundadır: önündeki binayı mı, üzerinde sürdüğü yolu 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 ya da match_type): bina ya da adres, sokak, mahalle, yerleşim yeri, park, su. Noktanın neyle eşleştiğini söyler.
• Uzaklık: eşleşen yerin sorgulanan noktaya ne kadar uzak olduğu. Üç metre ötedeki bir adres eşleşmesi sağlamdır. Yetmiş metre ötedeki bir sokak eşleşmesi ise genellikle iğnenin bir tarlaya düştüğünü gösterir.

Yanıtın geri kalanı normal yöndekiyle aynıdır: istenen dilde biçimlendirilmiş bir adres, bir yer kimliği, adres bileşenleri ve ISO ülke kodu.

Ters coğrafi kodlama nerelerde kullanılır

Bu örneklerin hepsinde önce cihaz ya da kullanıcı bir nokta üretir, adres bu noktadan bulunur:

• İğneyle adres seçilen ödeme ekranı: Kullanıcı iğneyi tam kapısının önüne kaydırır, uygulama da adresi ona onaylatır
• Konum etiketli fotoğraflar: Fotoğraftaki EXIF koordinatı iki sayı yerine "Paris, Fransa" olarak görünür. Eski arşivlerin topluca etiketlenmesi de buna dahildir
• "Yakınımda" düğmeleri: Cihazın konumu bir yerleşim yerine çevrilir ve arama oradan başlar
• Filo ve IoT verisi: Yolculuk başlangıçları, duraklar ve sensör olayları koordinat olarak gelir ve sisteme girerken bir kez adlandırılır. Böylece paneller sokak adlarını gösterir

Burada asıl kayıt koordinat olduğu için onu saklayın. Bulunan adresi ise gerektiğinde yenileyebileceğiniz bir gösterim değeri olarak görün.

Ters coğrafi kodlamada sık yapılan hatalar

Kıyıdaki ve sudaki noktalar. GPS sapması iğneleri sık sık bir nehrin içine ya da birkaç metre açığa düşürür. Bazı API'ler hiçbir sonuç döndürmez, bazıları en yakın yolu seçer, bazıları da su kütlesini döndürür. Her yanıtı bir sokak adresi gibi işlemek yerine, arayüzün su eşleşmesini nasıl göstereceğine önceden karar verin.

Yalnızca posta kodu düzeyinde eşleşmeler. Yoğun yerleşim alanlarının dışında en yakın sonuç, birkaç kilometrekarelik bir posta kodu bölgesi olabilir. Geçerli görünür ama işe yaramaz. Doğrulanmış bir adres gibi göstermeden önce yer türünü kontrol edin.

Dil. Tokyo'daki bir nokta, isteğin diline göre kanji, romaji ya da İngilizce dönebilir. Kullanıcılara kendi dillerindeki adları gösterin, iç kayıtları ise tek bir standart dilde tutun.

Büyük tesislerin içindeki noktalar. Parklar, kampüsler ve alışveriş merkezleri birer alandır (poligon). İçlerindeki herhangi bir iğne yalnızca en yakın yolla değil, tesisin kendisiyle eşleşmelidir. Bu yüzden merkezden uzak noktalarla da test edin.

Sapmalı GPS izleri. Araç verisinde önce izi map matching ile yol ağına oturtun, sonra oturtulmuş noktaları ters coğrafi kodlamadan geçirin. Yoksa otoyoldaki bir araç, yolun kenarındaki bir evin adresiyle etiketlenebilir.

Koordinattan adres bulma

"Koordinattan adres bulma" ve "koordinat ile adres bulma", ters coğrafi kodlamanın gündelik adlarıdır. Elinizdeki koordinat sayısına göre üç yol var.

Tek bir koordinat, elle. Enlem ve boylamı Koordinatlar aracına yapıştırın. Araç en yakın adresi haritada gösterir. Haritaya tıklayabilir ya da iğneyi sürükleyebilirsiniz.

Çok sayıda koordinat, kodla. Bir ters coğrafi kodlama uç noktasını 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 okuyacağınız alanlar, kısaltılmış olarak:

{
  "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 neyle eşleştiğini söyler. address kapı numarası olan bir adres demektir. street ya da locality sonucu ise yeterince yakında bir adres bulunmadığını gösterir.

Herhangi bir şey çağırmadan önce girdiyi kontrol edin. Koordinat hatalarının çoğu sorgudan önce yapılır:

• Sıra. Harita uygulamaları ve çoğu form önce enlemi yazar (52.3905, 4.829). GeoJSON ve birçok API ise önce boylamı yazar. İkisini karıştırırsanız Amsterdam'daki bir nokta Somali açıklarında, Hint Okyanusu'na düşer.
• Biçim. 52°23'25.8"N 4°49'44.4"E, derece, dakika ve saniye olarak yazılmış 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 bir yazımdır. Birçok API ve URL parametresi ise ondalık nokta bekler ve "52,3905" ifadesini iki ayrı sayı olarak okur. Göndermeden önce virgülü noktaya çevirin.

Koordinat ne kadar hassas olmalı

Ters coğrafi kodlama noktaya en yakın adresi döndürür. Yani sonuç ancak koordinat kadar iyidir. Üç yoğun şehir merkezinde adreslerin birbirine ne kadar uzak olduğunu ölçtük. Bunun için 1 km'ye 1 km'lik bir karenin içindeki bütün OpenStreetMap adres noktalarını kullandık ve sonucu her ondalık basamağın yerdeki karşılığıyla karşılaştırdık:

Buradan üç sonuç çıkıyor:

• Bir ev için dört ondalık basamak yetmez. Dört basamağa yuvarlamak Amsterdam'da bir noktayı 6,5 metreye kadar kaydırır. Basamakları yuvarlamak yerine keserseniz kayma 13 metreye çıkar. Bu, bir iki kanal evi ya da Madrid'de yandaki kapı demektir. Adres düzeyindeki her iş için beş ya da altı basamak kullanın.
• Telefonun konumu sokağı bulur, kapıyı her zaman bulamaz. GPS.gov'a göre GPS'li akıllı telefonlar açık havada genellikle 4,9 metre içinde doğru sonuç verir. Yüksek binaların arasında bu değer kötüleşir. Berlin'de bu çoğunlukla doğru kapı numarasını bulur. Kanal kuşağında ise komşunun kapısına düşebilir. Teslimat adreslerinde sonucu kullanıcıya gösterin ve onaylamasına ya da iğneyi kaydırmasına izin verin.
• Tek bir noktada birçok adres olabilir. 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. Daire numarasını 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ı.

Canlı sistemlerde sık yapılan hatalar

Coğrafi kodlama ilk gün kolay görünen, ama her hafta biraz daha zorlaşan işlerden biridir.

Belirsiz adresler. ABD Jeoloji Araştırmaları Kurumu (USGS), ABD'de Springfield adlı 93 yerleşim yeri sayıyor. Ülke, bölge ya da posta kodu olmadan coğrafi kodlama yazı turaya döner. Elinizdeki bütün bilgiyi gönderin, ülke kodunu da sonuçları yönlendiren bir parametre olarak ekleyin.

Eskimiş koordinatlar. Sokaklar yeniden numaralandırılır, mahallelerin adı değişir, yeni binalar yapılır. İki yıl önce sakladığınız bir geocode artık aynı binayı göstermiyor olabilir. Güncelliğin önemli olduğu kayıtlarda (teslimat, sevkiyat, düzenlemeye tabi sektörler) adresleri belirli aralıklarla yeniden coğrafi kodlamadan geçirin ve sonucu kayıtlı koordinatla karşılaştırın.

Hassasiyeti gizlemek. Özensiz bir arayüz, hassasiyet locality olsa bile sonucu "✓ Adres bulundu" diye gösterir. Kullanıcı yeşil onay işaretini görür ve adresinin doğrulandığını düşünür. Oysa API yalnızca şehri eşleştirmiştir. Ödeme ya da kimlik doğrulama (KYC) gibi önemli akışlarda hassasiyet düzeyini arayüzde her zaman gösterin.

Kota ve istek sınırları. Coğrafi kodlama API'leri istek başına ücretlendirilir ve saniyedeki istek sayısı sınırlıdır. Toplu işlemlerde istekleri gruplayın. Kullanıcının gördüğü otomatik tamamlamada ise istemci tarafında bir bekleme süresi (debounce) kullanın.

Gizlilik. Bir koordinat ile bir zaman damgası birlikte kişisel veridir. Geocode'ları diğer kişisel veriler gibi koruyun: Saklandıkları yere erişimi kısıtlayın, erişimleri kaydedin ve faaliyet gösterdiğiniz yerdeki GDPR kurallarına uyun.

MapAtlas'ta coğrafi kodlama

MapAtlas Geocoding API hem normal yönde hem ters yönde coğrafi kodlama yapar. Yukarıdaki standart alanları (biçimlendirilmiş adres, yer kimliği, hassasiyet, güven puanı, sınırlayıcı kutu, adres bileşenleri) döndürür. Milyonlarca satırı işlemesi gereken veri aktarımları için toplu coğrafi kodlamayı da destekler. Ülke ve dil parametreleri, her dil için ayrı istek göndermenize gerek kalmadan sonuçları Avrupa'daki ve dünyadaki kullanıcılarınız için doğru tutar.

Coğrafi kodlamayı seyahat süresi analiziyle birleştiren işlerde Geocoding API, Isochrone API ve Distance Matrix API ile birlikte çalışır. Böylece tek bir adres sorgusu doğrudan "15 dakika içindeki her şeyi göster" ya da "bu adayları sürüş süresine göre sırala" adımına geçebilir. GPS izlerini ters coğrafi kodlamadan geçirmeden önce onları Map Matching API ile işleyin. Böylece her nokta, gerçekten kaydedildiği yolun üzerine oturur.

Geocode dikkat çeken bir şey değil, yalnızca bir koordinat. Ama bir metni, uygulamanın üzerinde işlem yapabileceği bir yere çeviren de bu koordinattır. Bu tek veriyi doğru almak, gerçekten konuma dayalı bir özellik ile yanlış kıtaya düşmüş bir iğne arasındaki farkı belirler.