Skip to main content

API غنی‌سازی نشانی

ژئوکدینگ، سلسله‌مراتب محله، و POIهای نزدیک در یک فراخوانی.

یک آدرس ارسال کنید. مختصات، سلسله‌مراتب محله و مکان‌های نزدیک را در یک پاسخ دریافت کنید. هر آنچه صفحات فهرست شما برای دیده شدن توسط هوش مصنوعی نیاز دارد، در یک فراخوانی API.

نحوه کار

سه مرحله تا یک فهرست کاملاً غنی‌شده.

بدون ترکیب سرویس‌های متعدد. یک نقطه پایانی geocoding، تشخیص محله و جستجوی POI را در یک فراخوانی مدیریت می‌کند.

01

آدرس را ارسال کنید

هر رشته آدرس خام، کد پستی یا جفت مختصات را به GET /v1/geoenrich ارسال کنید. پردازش اولیه یا نرمال‌سازی آدرس لازم نیست.

02

MapAtlas لایه جغرافیایی کامل را حل می‌کند

API آدرس را با دقت سقف بنا geocode می‌کند، سلسله‌مراتب محله را حل می‌کند و بیش از ۱B POI فهرست‌شده در شعاع انتخابی شما را اسکن می‌کند و امتیازات، خطوط حمل‌ونقل، ساعات کاری و زمان‌های سفر را بازمی‌گرداند.

03

در JSON-LD تزریق و ارائه دهید

هر فیلد در پاسخ مستقیماً به یک ویژگی schema.org نگاشت می‌شود. مختصات را در GeoCoordinates، محله را در containedInPlace و مکان‌های نزدیک را در amenityFeature قرار دهید. تبدیل لازم نیست.

The API

یک فراخوانی. هوش موقعیت کامل.

اکثر پایگاه‌های داده فهرست آنچه انسان‌ها وارد می‌کنند ذخیره می‌کنند: آدرس، قیمت، اتاق خواب. هرگز برای ارائه زمینه جغرافیایی قابل خواندن توسط ماشین طراحی نشده‌اند. GeoEnrich API این شکاف را در یک درخواست پر می‌کند و مختصات، تحلیل محله، حمل‌ونقل عمومی در زمان واقعی، امتیازات، زمان‌های سفر و موارد دیگر را بازمی‌گرداند.

  • رشته آدرس خام را ارسال کنید. پردازش اولیه لازم نیست.
  • مختصات، سلسله‌مراتب کامل محله و امتیازات پروفایل دریافت کنید.
  • مکان‌های نزدیک با امتیازات، ساعات کاری و داده‌های حمل‌ونقل زنده دریافت کنید.
  • هر فیلد مستقیماً به یک ویژگی 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

آنچه یک فراخوانی بازمی‌گرداند

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.

مختصات دقیق

lat/lng با دقت سقف بنا به همراه ارتفاع. مخطط GeoCoordinates را مستقیماً تأمین می‌کند.

latlngelevation

هوش محله

سلسله‌مراتب کامل به علاوه walkScore، bikeScore، transitScore، سطح سروصدا، شاخص کیفیت هوا و برچسب‌های شخصیت. containedInPlace و زمینه محله را تأمین می‌کند.

neighborhooddistrictwalkScorenoiseLevel

مکان‌های نزدیک غنی

بیش از ۱,۳۲۸ POI با امتیازات، ساعات کاری، خطوط حمل‌ونقل، حرکات زنده، زمان‌های سفر و داده‌های شلوغی. مخطط amenityFeature را تأمین می‌کند.

nametypedistancerealtimerating
GeoEnrich API

ساده. قابل پیش‌بینی. یک نقطه پایانی.

بدون راه‌اندازی پیچیده. بدون ترکیب چندین فراخوانی. یک آدرس ارسال کنید، لایه جغرافیایی کامل مورد نیاز برای نشانه‌گذاری schema.org در هر صفحه فهرست را دریافت کنید.

  • یک نقطه پایانی geocoding و جستجوی POI را با هم مدیریت می‌کند
  • فیلترهای اختیاری شعاع و دسته‌بندی برای کنترل دقیق
  • پاسخ مستقیماً بدون نیاز به تبدیل به JSON-LD نگاشت می‌شود
  • در زمان ساخت اجرا کنید تا هزینه جاری هر درخواست صفر شود
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"
}
برای هر نوع فهرست

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.

اجاره تعطیلات

صفحات اجاره فردی را در جستجوهای هوش مصنوعی مانند 'ویلای ساحلی نزدیک فارو با رستوران‌های مجاور' نمایان کنید.

املاک و مستغلات

فهرست‌ها را برای جستجوهای مانند 'آپارتمان در پرنتزلائر برگ نزدیک مترو' بدون ورود دستی داده نشان دهید.

هتل‌ها

برای جستجوهای مانند 'هتل بوتیک در ماره، در فاصله پیاده از موزه‌ها' استناد هوش مصنوعی بگیرید.

تجربیات

برای جستجوهای مانند 'کلاس آشپزی در بارسلون نزدیک محله گوتیک' استناد بگیرید.

همه چیز در یک پاسخ

یک نقطه پایانی لایه کامل داده جغرافیایی مورد نیاز صفحات فهرست شما را برای دیده شدن توسط هوش مصنوعی بازمی‌گرداند.

مختصات دقیق

دقت تا چهار رقم اعشار. مخطط GeoCoordinates را در هر صفحه فهرست پر می‌کند تا موتورهای هوش مصنوعی بتوانند آن را در فضای جغرافیایی قرار دهند.

سلسله‌مراتب محله

محله، ناحیه، شهر و کشور از روی آدرس استخراج می‌شود. زنجیره containedInPlace برای بازیابی هوش مصنوعی در سطح منطقه را تأمین می‌کند.

مکان‌های نزدیک

حمل‌ونقل، آموزش، تفریح و مراقبت‌های بهداشتی در شعاع قابل تنظیم. هر مکان با مسافت و زمان پیاده‌روی برای مخطط amenityFeature بازگردانده می‌شود.

به‌روزرسانی ماهانه داده

هر پاسخ شامل dataTimestamp به‌روزشده به صورت ماهانه است. آن را به dateModified در JSON-LD خود نگاشت کنید تا موتورهای هوش مصنوعی داده‌های تأیید شده و به‌روز را ببینند.

ساخته شده برای پردازش انبوه

طراحی شده برای پایگاه‌های داده با ۵۰,۰۰۰ فهرست یا بیشتر. کار غنی‌سازی را یک بار در زمان ساخت اجرا کنید، لایه جغرافیایی را کش کنید و بدون هزینه هر درخواست ارائه دهید.

میزبانی در اتحادیه اروپا، مطابق با GDPR

میزبانی کامل در اتحادیه اروپا با مستندات انطباق GDPR و بندهای قراردادی استاندارد. بدون ریسک اقامت داده برای پورتال‌های فهرست اروپایی.

مشخصات فنی

نقطه پایانی

روش
GET /v1/geoenrich
فرمت پاسخ
JSON (schema.org-ready)

پارامترها

address
الزامی. رشته آدرس خام.
radius
متر. پیش‌فرض ۶۰۰.

فیلدهای پاسخ

coordinates
lat / lng (۴ رقم اعشار)
nearby[]
name, type, distance (متر)

آماده شروع هستید؟

امروز با MapAtlas شروع به ساخت کنید. رایگان ثبت‌نام کنید و دسترسی فوری به تمام API های نقشه‌برداری ما با محدودیت‌های سخاوتمندانه سطح رایگان دریافت کنید.

GeoEnrich API: سوالات متداول

هر آنچه قبل از غنی‌سازی اولین فهرست خود باید بدانید.

GeoEnrich API: سوالات متداول

هر آنچه قبل از غنی‌سازی اولین فهرست خود باید بدانید.

GeoEnrich API چه داده‌هایی بازمی‌گرداند؟
یک فراخوانی بازمی‌گرداند: مختصات با دقت سقف بنا (lat/lng)، سلسله‌مراتب کامل محله (محله فرعی، محله، ناحیه، شهر، استان، کشور، کد پستی) و فهرستی از مکان‌های نزدیک در شعاع انتخابی شما. هر مکان نزدیک شامل نام، نوع، مسافت، جهت، زمان‌های سفر پیاده، دوچرخه و خودرو، به علاوه جزئیات غنی مانند مقصدهای خط حمل‌ونقل، ساعات کاری، امتیازات و داده‌های شلوغی زنده است. پاسخ همچنین شامل neighborhoodProfile با walkScore، bikeScore، transitScore، شاخص کیفیت هوا و سطح سروصدا است.
تفاوت GeoEnrich API با Geocoding API چیست؟
یک geocoding API آدرس را به مختصات تبدیل می‌کند. GeoEnrich API بسیار فراتر می‌رود: geocoding را با تشخیص محله و جستجوی کامل POI در یک فراخوانی ترکیب می‌کند. به جای بازگرداندن یک جفت lat/lng، همه چیزی که یک صفحه فهرست برای دیده شدن توسط هوش مصنوعی نیاز دارد را بازمی‌گرداند، از جمله فیلدهای آماده schema.org برای GeoCoordinates، containedInPlace و amenityFeature.
داده‌های موقعیت چند بار به‌روزرسانی می‌شوند؟
داده‌های POI، برنامه‌های حمل‌ونقل، امتیازات و ساعات کاری در یک چرخه ماهانه تازه‌سازی می‌شوند. هر پاسخ شامل یک فیلد dataTimestamp است تا بتوانید تاریخ تازه‌سازی را به عنوان dateModified در JSON-LD خود نشان دهید. موتورهای هوش مصنوعی و خزنده‌های جستجو داده‌های با مهر زمانی تازه را معتبرتر می‌دانند که نرخ استناد را بهبود می‌بخشد.
آیا GeoEnrich API در همه کشورها کار می‌کند؟
بله. API بیش از ۱۸۰ کشور را با خروجی JSON یکسان و همان نگاشت فیلد schema.org در همه جا پوشش می‌دهد. عمق پوشش بر اساس منطقه متفاوت است: شهرهای اروپایی دارای دقیق‌ترین داده‌های POI و حمل‌ونقل هستند، در حالی که پوشش جهانی شامل مختصات، سلسله‌مراتب محله و دسته‌بندی‌های اصلی POI است.
آیا می‌توانم GeoEnrich را روی یک پایگاه داده بزرگ از فهرست‌ها اجرا کنم؟
API به طور خاص برای استفاده انبوه ساخته شده است. کار غنی‌سازی را یک بار در زمان ساخت اجرا کنید، لایه جغرافیایی را برای هر فهرست کش کنید و بدون هزینه جاری هر درخواست ارائه دهید. سطح رایگان شامل ۵۰,۰۰۰ غنی‌سازی در ماه است. طرح‌های بزرگ‌تر از توان عملیاتی بالاتر با پشتیبانی نقطه پایانی دسته‌ای پشتیبانی می‌کنند.
داده‌های موقعیت چگونه به صفحات فهرست در رتبه‌بندی جستجوی هوش مصنوعی کمک می‌کند؟
موتورهای جستجوی هوش مصنوعی مانند Perplexity، ChatGPT و Google AI Overviews به جستجوهایی مانند 'آپارتمان نزدیک مترو در پرنتزلائر برگ' با خواندن داده‌های ساختاریافته در HTML شما پاسخ می‌دهند. بدون نشانه‌گذاری schema.org برای GeoCoordinates، containedInPlace و amenityFeature، فهرست‌های شما برای این موتورها نامرئی هستند. GeoEnrich دقیقاً داده‌های جغرافیایی مورد نیاز برای پر کردن این نشانه‌گذاری در مقیاس را فراهم می‌کند.
آیا GeoEnrich API با GDPR مطابقت دارد؟
بله. تمام پردازش‌ها بر روی زیرساخت میزبانی شده در اتحادیه اروپا انجام می‌شود. آدرس‌ها و مختصات فراتر از چرخه حیات درخواست ذخیره نمی‌شوند. MapAtlas بندهای قراردادی استاندارد و مستندات انطباق GDPR را برای پورتال‌های فهرست اروپایی و پردازشگران داده فراهم می‌کند.
آیا GeoEnrich API می‌تواند موقعیت جغرافیایی یک آدرس IP را برگرداند؟
بله. یک آدرس IP بدهید و GeoEnrich موقعیت جغرافیایی تقریبی آن را برمی‌گرداند، شامل کشور، استان، شهر و مختصات. مکان‌یابی بر اساس IP برای مرکز کردن پیش‌فرض نقشه، سیگنال‌های تشخیص تقلب و بومی‌سازی محتوا پیش از آنکه کاربر موقعیت دقیق خود را به اشتراک بگذارد مفید است. همه این پرس‌وجوها روی زیرساخت میزبانی‌شده در اتحادیه اروپا اجرا می‌شوند.
مکان‌یابی بر اساس IP در مقایسه با مختصات GPS چقدر دقیق است؟
مکان‌یابی بر اساس IP تا سطح شهر یا استان دقت دارد، نه دقت در سطح خیابان که GPS فراهم می‌کند. از آن برای پیش‌فرض‌های تقریبی و تحلیل داده استفاده کنید و هر جا به آدرس یا نقطه دقیق نیاز داشتید سراغ Geocoding API یا GPS دستگاه بروید. GeoEnrich این امکان را می‌دهد که هر دو را در یک فراخوانی غنی‌سازی کنار هم داشته باشید.

API های مرتبط