Skip to main content

API Pengayaan Alamat

Geocoding, hirarki lingkungan, dan POI terdekat dalam satu panggilan.

Masukkan alamat. Dapatkan koordinat, hierarki kawasan, dan tempat terdekat dalam satu respons. Semua yang dibutuhkan halaman listing Anda untuk terlihat oleh AI, dalam satu panggilan API.

Cara Kerjanya

Tiga langkah menuju listing yang sepenuhnya diperkaya.

Tidak perlu menggabungkan beberapa layanan. Satu endpoint menangani geocoding, resolusi kawasan, dan pencarian POI dalam satu panggilan.

01

Kirim alamat

Masukkan string alamat mentah, kode pos, atau pasangan koordinat ke GET /v1/geoenrich. Tidak diperlukan pra-pemrosesan atau normalisasi alamat.

02

MapAtlas menyelesaikan lapisan geo lengkap

API melakukan geocoding alamat ke presisi atap, menyelesaikan hierarki kawasan, dan memindai 1 miliar+ POI yang diindeks dalam radius pilihan Anda, mengembalikan rating, jalur transit, jam buka, dan waktu perjalanan.

03

Injeksi ke JSON-LD dan sajikan

Setiap field dalam respons dipetakan langsung ke properti schema.org. Masukkan koordinat ke GeoCoordinates, kawasan ke containedInPlace, dan tempat terdekat ke amenityFeature. Tidak perlu transformasi.

The API

Satu panggilan. Intelijen lokasi lengkap.

Sebagian besar database listing menyimpan apa yang dimasukkan manusia: alamat, harga, kamar tidur. Mereka tidak pernah dirancang untuk menyediakan konteks geografis yang dapat dibaca mesin. GeoEnrich API menjembatani kesenjangan itu dalam satu permintaan, mengembalikan koordinat, analitik kawasan, transit waktu nyata, rating, waktu perjalanan, dan banyak lagi.

  • Masukkan string alamat mentah. Tidak perlu pra-pemrosesan.
  • Terima koordinat, hierarki kawasan lengkap, dan skor profil.
  • Dapatkan tempat terdekat dengan rating, jam buka, dan data transit langsung.
  • Setiap field dipetakan langsung ke properti schema.org.
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

Apa yang dikembalikan satu panggilan

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.

Koordinat Presisi

lat/lng presisi atap dengan elevasi. Langsung mendukung skema GeoCoordinates.

latlngelevation

Intelijen Kawasan

Hierarki lengkap ditambah walkScore, bikeScore, transitScore, tingkat kebisingan, indeks kualitas udara, dan tag karakter. Mendukung containedInPlace dan konteks kawasan.

neighborhooddistrictwalkScorenoiseLevel

Tempat Terdekat yang Kaya

1.328+ POI dengan rating, jam buka, jalur transit, keberangkatan langsung, waktu perjalanan, dan data kesibukan. Mendukung skema amenityFeature.

nametypedistancerealtimerating
GeoEnrich API

Sederhana. Dapat diprediksi. Satu endpoint.

Tidak ada pengaturan rumit. Tidak perlu menggabungkan beberapa panggilan. Masukkan alamat, terima lapisan geo lengkap yang diperlukan untuk mendukung markup schema.org di setiap halaman listing.

  • Satu endpoint menangani geocoding dan pencarian POI bersama
  • Filter radius dan kategori opsional untuk kontrol presisi
  • Respons dipetakan langsung ke JSON-LD tanpa transformasi
  • Jalankan saat build untuk biaya per permintaan yang terus-menerus nol
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"
}
Cocok untuk setiap jenis listing

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.

Sewa Liburan

Buat halaman rental individual muncul dalam kueri AI seperti "villa tepi pantai dekat Faro dengan restoran terdekat".

Real Estat

Tampilkan listing untuk kueri seperti "apartemen di Prenzlauer Berg dekat metro" tanpa entri data manual.

Hotel

Menangkan kutipan AI untuk kueri seperti "hotel butik di Marais, bisa berjalan kaki ke museum".

Pengalaman

Dikutip untuk kueri seperti "kelas memasak di Barcelona dekat Kawasan Gotik".

Segalanya dalam Satu Respons

Satu endpoint mengembalikan lapisan data geo lengkap yang dibutuhkan halaman listing Anda untuk terlihat oleh AI.

Koordinat Presisi

Akurasi empat desimal. Mengisi skema GeoCoordinates di setiap halaman listing agar mesin AI dapat menempatkannya dalam ruang geografis.

Hierarki Kawasan

Kawasan, distrik, kota, dan negara diselesaikan dari alamat. Mendukung rantai containedInPlace untuk pengambilan AI tingkat area.

Tempat Terdekat

Transportasi, pendidikan, rekreasi, dan layanan kesehatan dalam radius yang dapat dikonfigurasi. Setiap tempat dikembalikan dengan jarak dan waktu berjalan kaki untuk skema amenityFeature.

Pembaruan Data Bulanan

Setiap respons menyertakan dataTimestamp yang diperbarui setiap bulan. Petakan ke dateModified di JSON-LD agar mesin AI melihat data yang terverifikasi dan terkini.

Dirancang untuk Pemrosesan Massal

Dirancang untuk database dengan 50.000 listing atau lebih. Jalankan pekerjaan pengayaan sekali pada waktu build, simpan lapisan geo dalam cache, dan sajikan tanpa biaya per permintaan.

Di-host di EU, Patuh GDPR

Sepenuhnya di-host di EU dengan dokumentasi kepatuhan GDPR dan klausul kontrak standar. Tidak ada risiko residensi data untuk portal listing Eropa.

Spesifikasi Teknis

Endpoint

Metode
GET /v1/geoenrich
Format Respons
JSON (schema.org-ready)

Parameter

address
Wajib. String alamat mentah.
radius
Meter. Default 600.

Field Respons

coordinates
lat / lng (4 desimal)
nearby[]
nama, tipe, jarak (meter)

Siap untuk Memulai?

Mulai membangun dengan MapAtlas hari ini. Daftar gratis dan dapatkan akses instan ke semua API pemetaan kami dengan batas tingkat gratis yang murah hati.

GeoEnrich API: pertanyaan umum

Semua yang perlu Anda ketahui sebelum memperkaya listing pertama Anda.

GeoEnrich API: pertanyaan umum

Semua yang perlu Anda ketahui sebelum memperkaya listing pertama Anda.

Data apa yang dikembalikan GeoEnrich API?
Satu panggilan mengembalikan: koordinat presisi atap (lat/lng), hierarki kawasan lengkap (sub-distrik, kawasan, distrik, kota, provinsi, negara, kode pos), dan daftar tempat terdekat dalam radius pilihan Anda. Setiap tempat terdekat menyertakan nama, tipe, jarak, arah, waktu perjalanan dengan berjalan kaki, bersepeda, dan berkendara, ditambah detail lengkap seperti tujuan jalur transit, jam buka, rating, dan data kesibukan langsung. Respons juga menyertakan neighborhoodProfile dengan walkScore, bikeScore, transitScore, indeks kualitas udara, dan tingkat kebisingan.
Apa perbedaan antara GeoEnrich API dan API Geocoding?
API Geocoding mengonversi alamat menjadi koordinat. GeoEnrich API jauh lebih canggih: menggabungkan geocoding dengan resolusi kawasan dan pencarian POI lengkap dalam satu panggilan. Alih-alih hanya mengembalikan pasangan lat/lng, ia mengembalikan semua yang dibutuhkan halaman listing untuk menjadi terlihat oleh AI, termasuk field siap schema.org untuk GeoCoordinates, containedInPlace, dan amenityFeature.
Seberapa sering data lokasi diperbarui?
Data POI, jadwal transit, rating, dan jam buka disegarkan dalam siklus bulanan. Setiap respons menyertakan field dataTimestamp sehingga Anda dapat menampilkan tanggal pembaruan sebagai dateModified di JSON-LD Anda. Mesin AI dan crawler pencarian memperlakukan data dengan stempel waktu baru sebagai lebih andal, yang meningkatkan tingkat kutipan.
Apakah GeoEnrich API berfungsi untuk semua negara?
Ya. API mencakup 180+ negara dengan output JSON yang konsisten dan pemetaan field schema.org yang sama di mana saja. Kedalaman cakupan bervariasi per wilayah: kota-kota Eropa memiliki data POI dan transit paling terperinci, sementara cakupan global mencakup koordinat, hierarki kawasan, dan kategori POI utama.
Bisakah saya menjalankan GeoEnrich pada database listing yang besar?
API dirancang khusus untuk penggunaan massal. Jalankan pekerjaan pengayaan sekali pada waktu build, simpan lapisan geo per listing dalam cache, dan sajikan tanpa biaya per permintaan yang terus-menerus. Tier gratis mencakup 50.000 pengayaan per bulan. Paket lebih besar mendukung throughput lebih tinggi dengan dukungan endpoint batch.
Bagaimana data lokasi membantu halaman listing mendapat peringkat lebih tinggi di pencarian AI?
Mesin pencarian AI seperti Perplexity, ChatGPT, dan Google AI Overviews menjawab kueri seperti "apartemen dekat metro di Prenzlauer Berg" dengan membaca data terstruktur di HTML Anda. Tanpa markup schema.org untuk GeoCoordinates, containedInPlace, dan amenityFeature, listing Anda tidak terlihat oleh mesin-mesin ini. GeoEnrich menyediakan data geo yang tepat untuk mengisi markup tersebut dalam skala besar.
Apakah GeoEnrich API patuh GDPR?
Ya. Semua pemrosesan terjadi di infrastruktur yang di-host di EU. Alamat dan koordinat tidak disimpan melampaui siklus hidup permintaan. MapAtlas menyediakan klausul kontrak standar dan dokumentasi kepatuhan GDPR untuk portal listing Eropa dan pemroses data.
Bisakah GeoEnrich API mengembalikan lokasi geografis dari sebuah alamat IP?
Ya. Kirimkan sebuah alamat IP dan GeoEnrich mengembalikan perkiraan lokasi geografisnya, termasuk negara, wilayah, kota, dan koordinat. IP geolocation berguna untuk memusatkan peta secara default, sinyal deteksi penipuan, dan melokalkan konten sebelum pengguna membagikan lokasi yang presisi. Semua pencarian berjalan di infrastruktur yang di-host di EU.
Seberapa akurat IP geolocation dibandingkan koordinat GPS?
IP geolocation hanya akurat sampai tingkat kota atau wilayah, bukan presisi tingkat jalan seperti GPS. Gunakan untuk nilai default kasar dan analitik, lalu gunakan Geocoding API atau GPS perangkat saat Anda membutuhkan alamat atau titik yang tepat. GeoEnrich memungkinkan Anda menggabungkan keduanya dalam satu panggilan pengayaan.