Skip to main content

Adres Zenginleştirme API'si

Geocoding, mahalle hiyerarşisi ve yakındaki POI'ler tek bir çağrıda.

Bir adres girin. Tek bir yanıtta koordinatlar, mahalle hiyerarşisi ve yakın yerler alın. İlan sayfalarınızın yapay zekaya görünür olması için ihtiyaç duyduğu her şey, tek bir API çağrısında.

Nasıl Çalışır

Tam zenginleştirilmiş bir ilana üç adımda ulaşın.

Birden fazla hizmeti birleştirme yok. Tek uç nokta geocoding, mahalle çözümleme ve POI aramasını tek bir çağrıda işler.

01

Adresi gönderin

GET /v1/geoenrich'e herhangi bir ham adres dizesi, posta kodu veya koordinat çifti gönderin. Ön işlem veya adres normalleştirmesi gerekmez.

02

MapAtlas tam coğrafi katmanı çözer

API adresi çatı hassasiyetiyle geocode eder, mahalle hiyerarşisini çözer ve seçtiğiniz yarıçap içinde 1B+ dizinlenmiş POI'yi tarayarak puanlar, toplu taşıma hatları, açılış saatleri ve seyahat süreleri döndürür.

03

JSON-LD'ye enjekte edin ve sunun

Yanıttaki her alan doğrudan bir schema.org özelliğiyle eşleşir. Koordinatları GeoCoordinates'e, mahalleyi containedInPlace'e, yakın yerleri amenityFeature'a yerleştirin. Dönüşüm gerekmez.

The API

Tek çağrı. Tam konum zekası.

Çoğu ilan veritabanı insanların girdiği şeyleri saklar: adres, fiyat, yatak odası sayısı. Makine tarafından okunabilir coğrafi bağlam sağlamak için hiçbir zaman tasarlanmadılar. GeoEnrich API bu boşluğu tek bir istekle kapatır: koordinatlar, mahalle analitiği, gerçek zamanlı toplu taşıma, puanlar, seyahat süreleri ve daha fazlasını döndürür.

  • Ham adres dizesini girin. Ön işlem gerekmez.
  • Koordinatlar, tam mahalle hiyerarşisi ve profil puanları alın.
  • Puanlar, açılış saatleri ve canlı toplu taşıma verileriyle yakın yerleri alın.
  • Her alan doğrudan bir schema.org özelliğiyle eşleşir.
RequestGET
GET https://api.mapatlas.eu/v1/geoenrich
  ?address=Kollwitzstraße 65, Berlin
  &radius=600
  &categories=transit,education,leisure,supermarket
  &include=neighborhoodProfile,realtime,busyness
  &key=YOUR_API_KEY
ResponseJSON
{
  "address": {
    "street":     "Kollwitzstraße 65",
    "postalCode": "10405",
    "city":       "Berlin",
    "country":    "DE"
  },
  "coordinates": {
    "lat":      52.53841,
    "lng":      13.41327,
    "accuracy": "rooftop",
    "elevation": 42
  },
  "adminHierarchy": {
    "subDistrict":  "Kollwitzkiez",
    "neighborhood": "Prenzlauer Berg",
    "district":     "Pankow",
    "city":         "Berlin",
    "state":        "Berlin",
    "country":      "DE",
    "postalCode":   "10405"
  },
  "neighborhoodProfile": {
    "tags":         ["family-friendly", "trendy", "cycling-culture", "cafe-dense"],
    "walkScore":    94,
    "bikeScore":    91,
    "transitScore": 98,
    "noiseLevel":   "moderate",
    "airQualityIndex": 38,
    "greenSpaceCoverage": "18%"
  },
  "dataTimestamp": "2026-03-01T00:00:00Z",
  "radius":   600,
  "poiCount": 1328,
  "nearby": [
    {
      "name":          "Eberswalder Str.",
      "type":          "transit",
      "subtype":       "metro",
      "distance":      140,
      "bearing":       "NW",
      "lines":         ["U2"],
      "destinations":  ["Pankow", "Ruhleben"],
      "frequency":     "every 5 min (peak)",
      "accessibility": "step-free",
      "realtime": {
        "nextDeparture": "in 3 min",
        "direction":     "Pankow",
        "platform":      "platform 1"
      },
      "travel": {
        "walking": { "duration": "2 min", "distance": "140m" },
        "cycling": { "duration": "1 min", "distance": "150m" },
        "driving": { "duration": "1 min", "distance": "180m" }
      }
    },
    {
      "name":         "Bus 142 / N2 at Eberswalder Str.",
      "type":         "transit",
      "subtype":      "bus",
      "distance":     145,
      "bearing":      "NW",
      "lines":        ["142", "N2"],
      "destinations": ["Ostbahnhof", "Zoologischer Garten"],
      "frequency":    "every 10 min (day) / 30 min (night)",
      "realtime": {
        "nextDeparture": "in 7 min",
        "direction":     "Ostbahnhof"
      },
      "travel": {
        "walking": { "duration": "2 min", "distance": "145m" },
        "cycling": { "duration": "1 min", "distance": "155m" },
        "driving": { "duration": "1 min", "distance": "180m" }
      }
    },
    {
      "name":         "Kollwitzplatz",
      "type":         "leisure",
      "subtype":      "park",
      "distance":     210,
      "bearing":      "SE",
      "openingHours": "24/7",
      "size":         "1.2 ha",
      "amenities":    ["playground", "dog-friendly", "benches", "fountain", "market-tue-sat"],
      "rating":       4.6,
      "reviews":      1842,
      "busyness": {
        "now":  "quiet",
        "peak": "Sat 11:00-14:00"
      },
      "travel": {
        "walking": { "duration": "3 min", "distance": "210m" },
        "cycling": { "duration": "1 min", "distance": "225m" },
        "driving": { "duration": "1 min", "distance": "350m" }
      }
    },
    {
      "name":      "Grundschule am Kollwitzplatz",
      "type":      "education",
      "subtype":   "primary_school",
      "distance":  380,
      "bearing":   "E",
      "ageRange":  "6-12",
      "schoolType":"public",
      "capacity":  340,
      "languages": ["German", "English"],
      "rating":    4.2,
      "reviews":   156,
      "travel": {
        "walking": { "duration": "5 min", "distance": "380m" },
        "cycling": { "duration": "2 min", "distance": "410m" },
        "driving": { "duration": "2 min", "distance": "520m" }
      }
    },
    {
      "name":     "REWE Kollwitzstraße",
      "type":     "supermarket",
      "subtype":  "grocery",
      "distance": 490,
      "bearing":  "N",
      "openingHours": {
        "mon-sat": "07:00-22:00",
        "sun":     "08:00-22:00"
      },
      "priceLevel":        "$$",
      "deliveryAvailable": true,
      "paymentMethods":    ["card", "cash", "contactless"],
      "rating":  4.1,
      "reviews": 892,
      "busyness": {
        "now":  "busy",
        "peak": "Mon-Fri 17:00-19:00"
      },
      "travel": {
        "walking": { "duration": "6 min", "distance": "490m" },
        "cycling": { "duration": "2 min", "distance": "510m" },
        "driving": { "duration": "2 min", "distance": "650m" }
      }
    }
    // ... 1,323 more across 18 categories
  ]
}

Data at a scale and speed never available before

1B+

POIs indexed globally

Transit, retail, education & more

180+

Countries covered

Consistent schema everywhere

<200ms

Avg. API response

At any scale, any location

18

Data categories

Per single API call

Surrounding Context

Every nearby place, verified fresh.

One call returns every relevant place within your chosen radius, organized by category. Each dataset carries a dataTimestamp so AI engines and search crawlers know exactly how current your location data is.

  • Transit stops, parks, schools, restaurants, all in one response
  • Configurable radius from 100m to 5km
  • Monthly refresh cycle with verified timestamps
  • AI engines cite fresh, timestamped data over stale listings

Kollwitzstraße 65

Prenzlauer Berg · Berlin · DE

Nearby within 600m

Eberswalder Str.U2Pankow ↔ Ruhleben · 5 min freq.
2 min1 min1 min
140m
Bus 142 / N2 at EberswalderBUSOstbhf ↔ Zoo
2 min1 min1 min
145m
Kollwitzplatz 4.6leisure
3 min1 min1 min
210m
Grundschule am Kollwitzplatzeducationages 6–12
5 min2 min2 min
380m
REWE Kollwitzstraße 4.1
Mon–Sat 07:00–22:00 · Sun 08:00–22:00
6 min2 min2 min
490m
+ 1,323 more placesacross 18 categories in full response

Data verified · March 2026

Monthly refresh · dataTimestamp: 2026-03-01

Tek çağrının döndürdükleri

Coordinates. Neighborhood profile. Nearby places.

Every field in the response maps directly to a schema.org property. Coordinates, neighborhood hierarchy, walkScore, transit lines, ratings, opening hours, travel times. No transformation needed.

Hassas Koordinatlar

Yükseklik bilgisiyle çatı hassasiyetinde lat/lng. GeoCoordinates şemasını doğrudan güçlendirir.

latlngelevation

Mahalle Zekası

Tam hiyerarşi artı walkScore, bikeScore, transitScore, gürültü seviyesi, hava kalitesi endeksi ve karakter etiketleri. containedInPlace ve mahalle bağlamını güçlendirir.

neighborhooddistrictwalkScorenoiseLevel

Zengin Yakın Yerler

Puanlar, açılış saatleri, toplu taşıma hatları, canlı hareket, seyahat süreleri ve yoğunluk verileriyle 1.328+ POI. amenityFeature şemasını güçlendirir.

nametypedistancerealtimerating
GeoEnrich API

Basit. Öngörülebilir. Tek uç nokta.

Karmaşık kurulum yok. Birden fazla çağrıyı birleştirmek yok. Bir adres girin, her ilan sayfasında schema.org işaretlemesini desteklemek için gereken tam coğrafi katmanı alın.

  • Tek uç nokta geocoding ve POI aramasını birlikte işler
  • Hassas kontrol için isteğe bağlı yarıçap ve kategori filtreleri
  • Yanıt, dönüştürme gerektirmeden doğrudan JSON-LD ile eşleşir
  • Sıfır devam eden istek başına maliyet için derleme zamanında çalıştırın
Check your listing pages with the AEO Checker
JSON-LD outputschema.org
{
  "@context": "https://schema.org",
  "@type": "Apartment",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 52.5384,
    "longitude": 13.4132
  },
  "containedInPlace": {
    "@type": "Place",
    "name": "Prenzlauer Berg",
    "containedInPlace": { "@type": "City", "name": "Berlin" }
  },
  "amenityFeature": [
    { "@type": "LocationFeatureSpecification",
      "name": "Eberswalder Str.", "value": true,
      "description": "140m nearby" }
  ],
  "dateModified": "2026-03-01T00:00:00Z"
}
Her ilan türü için tasarlandı

One API call. Every listing type.

The GeoEnrich API works for any listing: vacation rentals, real estate, hotels, or experiences. The API call is identical. Only the schema type differs. See how listing portals use this at scale.

Tatil Kiralamaları

Bireysel kiralama sayfalarını 'Faro yakınında yakın restoranlı plaj villası' gibi yapay zeka sorgularında görünür yapın.

Gayrimenkul

Manuel veri girişi olmadan 'Prenzlauer Berg'de metroya yakın daireler' gibi sorgular için ilanları gösterin.

Oteller

'Marais'de müzelere yürüme mesafesinde butik otel' gibi sorgular için yapay zeka atıfları kazanın.

Deneyimler

'Barselona'da Gotik Çeyrek'e yakın yemek pişirme kursu' gibi sorgular için atıf alın.

Her Şey Tek Yanıtta

Tek bir uç nokta, ilan sayfalarınızın yapay zekaya görünür olması için ihtiyaç duyduğu tam coğrafi veri katmanını döndürür.

Hassas Koordinatlar

Dört ondalık basamak doğruluğu. Her ilan sayfasında GeoCoordinates şemasını doldurarak yapay zeka motorlarının konumu coğrafi uzayda belirlemesini sağlar.

Mahalle Hiyerarşisi

Adresten çözümlenen mahalle, ilçe, şehir ve ülke. AI düzeyinde bölge erişimi için containedInPlace zincirini güçlendirir.

Yakın Yerler

Yapılandırılabilir yarıçap içinde toplu taşıma, eğitim, eğlence ve sağlık hizmetleri. Her yer, amenityFeature şeması için mesafe ve yürüme süresiyle birlikte döndürülür.

Aylık Veri Yenileme

Her yanıt, aylık güncellenen bir dataTimestamp içerir. Yapay zeka motorlarının doğrulanmış, güncel verileri görmesi için bunu JSON-LD'nizdeki dateModified ile eşleyin.

Toplu İşlem İçin Tasarlandı

50.000 veya daha fazla listeli veritabanları için tasarlandı. Derleme zamanında bir kez zenginleştirme işini çalıştırın, coğrafi katmanı önbelleğe alın ve sıfır istek başına maliyetle sunun.

AB'de Barındırılan, GDPR Uyumlu

GDPR uyumluluk belgeleri ve standart sözleşme maddeleriyle tamamen AB'de barındırılmıştır. Avrupa ilan portalları için veri yerleşimi riski yoktur.

Teknik Özellikler

Uç Nokta

Yöntem
GET /v1/geoenrich
Yanıt Formatı
JSON (schema.org-ready)

Parametreler

address
Zorunlu. Ham adres dizesi.
radius
Metre. Varsayılan 600.

Yanıt Alanları

coordinates
lat / lng (4 ondalık basamak)
nearby[]
name, type, distance (metre)

Başlamaya Hazır Mısınız?

MapAtlas ile bugün inşa etmeye başlayın. Ücretsiz kaydolun ve cömert ücretsiz katman limitleriyle tüm haritalama API'lerimize anında erişim elde edin.

GeoEnrich API: sık sorulan sorular

İlk ilanınızı zenginleştirmeden önce bilmeniz gereken her şey.

GeoEnrich API: sık sorulan sorular

İlk ilanınızı zenginleştirmeden önce bilmeniz gereken her şey.

GeoEnrich API hangi verileri döndürür?
Tek bir çağrı şunları döndürür: çatı hassasiyetinde koordinatlar (lat/lng), tam mahalle hiyerarşisi (alt ilçe, mahalle, ilçe, şehir, eyalet, ülke, posta kodu) ve seçtiğiniz yarıçap içindeki yakın yerlerin listesi. Her yakın yer; ad, tür, mesafe, yön, yaya, bisiklet ve araçla seyahat süreleri ile toplu taşıma hattı varış noktaları, açılış saatleri, puanlar ve canlı yoğunluk verileri gibi zengin ayrıntılar içerir. Yanıt ayrıca walkScore, bikeScore, transitScore, hava kalitesi endeksi ve gürültü seviyesi içeren bir neighborhoodProfile de içerir.
GeoEnrich API ile Geocoding API arasındaki fark nedir?
Bir geocoding API adresi koordinatlara dönüştürür. GeoEnrich API çok daha ileri gider: tek bir çağrıda geocoding'i mahalle çözümleme ve tam POI aramasıyla birleştirir. Bir lat/lng çifti döndürmek yerine, GeoCoordinates, containedInPlace ve amenityFeature için schema.org'a hazır alanlar dahil olmak üzere bir ilan sayfasının yapay zekaya görünür olması için ihtiyaç duyduğu her şeyi döndürür.
Konum verileri ne sıklıkla güncellenir?
POI verileri, toplu taşıma programları, puanlar ve açılış saatleri aylık döngüde yenilenir. Her yanıt bir dataTimestamp alanı içerir, böylece yenileme tarihini JSON-LD'nizdeki dateModified olarak gösterebilirsiniz. Yapay zeka motorları ve arama robotları, taze zaman damgalı verileri daha güvenilir olarak değerlendirerek atıf oranlarını iyileştirir.
GeoEnrich API tüm ülkelerde çalışıyor mu?
Evet. API, her yerde aynı JSON çıktısı ve schema.org alan eşlemesiyle 180+ ülkeyi kapsar. Kapsam derinliği bölgeye göre değişir: Avrupa şehirleri en ayrıntılı POI ve toplu taşıma verilerine sahipken, küresel kapsam koordinatlar, mahalle hiyerarşisi ve birincil POI kategorilerini içerir.
GeoEnrich'i büyük bir ilan veritabanında çalıştırabilir miyim?
API özellikle toplu kullanım için tasarlanmıştır. Zenginleştirme işini derleme zamanında bir kez çalıştırın, coğrafi katmanı ilan başına önbelleğe alın ve sıfır devam eden istek başına maliyetle sunun. Ücretsiz kademe ayda 50.000 zenginleştirme içerir. Daha büyük planlar, toplu uç nokta desteğiyle daha yüksek işlem hacmini destekler.
Konum verileri ilan sayfalarının yapay zeka aramasında sıralanmasına nasıl yardımcı olur?
Perplexity, ChatGPT ve Google AI Overviews gibi yapay zeka arama motorları, 'Prenzlauer Berg'de metroya yakın daireler' gibi sorguları HTML'nizdeki yapılandırılmış verileri okuyarak yanıtlar. GeoCoordinates, containedInPlace ve amenityFeature için schema.org işaretlemesi olmadan ilanlarınız bu motorlara görünmez. GeoEnrich, bu işaretlemeyi ölçekte doldurmak için gereken tam coğrafi verileri sağlar.
GeoEnrich API GDPR uyumlu mu?
Evet. Tüm işlemler AB'de barındırılan altyapıda gerçekleşir. Adresler ve koordinatlar, istek yaşam döngüsü dışında saklanmaz. MapAtlas, Avrupa ilan portalları ve veri işleyicileri için standart sözleşme maddeleri ve GDPR uyumluluk belgeleri sağlar.
GeoEnrich API bir IP adresinin coğrafi konumunu döndürebilir mi?
Evet. Bir IP adresi gönderdiğinizde GeoEnrich, ülke, bölge, şehir ve koordinatlar dahil olmak üzere yaklaşık coğrafi konumunu döndürür. IP tabanlı konum belirleme; haritayı varsayılan olarak ortalamak, sahtekarlık sinyalleri üretmek ve kullanıcı kesin konumunu paylaşmadan önce içeriği yerelleştirmek için kullanışlıdır. Tüm sorgular AB'de barındırılan altyapıda çalışır.
IP tabanlı konum belirleme, GPS koordinatlarına kıyasla ne kadar doğrudur?
IP tabanlı konum belirleme, GPS'in sokak düzeyindeki hassasiyetine değil, şehir veya bölge düzeyine kadar çözümlenir. Kaba varsayılanlar ve analizler için IP konumunu kullanın; kesin bir adrese veya noktaya ihtiyaç duyduğunuzda Geocoding API'yi ya da cihaz GPS'ini kullanın. GeoEnrich, her ikisini tek bir zenginleştirme çağrısında birleştirmenize olanak tanır.