Skip to main content

واجهة إثراء العناوين

ترميز جغرافي، هرمية الأحياء، وأماكن قريبة في استدعاء واحد.

مرّر عنوانًا واحدًا. احصل على الإحداثيات وتسلسل الأحياء والأماكن القريبة في استجابة واحدة. كل ما تحتاجه صفحات إعلاناتك لتصبح مرئية للذكاء الاصطناعي، في استدعاء API واحد.

كيف يعمل

ثلاث خطوات للحصول على إعلان مُثرى بالكامل.

لا حاجة لتجميع خدمات متعددة. نقطة نهاية واحدة تتعامل مع الترميز الجغرافي وتحليل الأحياء والبحث عن POI في استدعاء واحد.

01

أرسل العنوان

مرّر أي سلسلة عنوان خام أو رمز بريدي أو زوج إحداثيات إلى GET /v1/geoenrich. لا حاجة لمعالجة مسبقة أو توحيد العناوين.

02

يحل MapAtlas الطبقة الجغرافية الكاملة

تُرمّز الواجهة البرمجية العنوان بدقة السطح وتحل تسلسل الأحياء وتفحص أكثر من 1B من 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

أماكن قريبة غنية

أكثر من 1,328 POI مع تقييمات وساعات عمل وخطوط مواصلات وبيانات مغادرة حية وأوقات سفر وبيانات الازدحام. يُعزز مخطط amenityFeature.

nametypedistancerealtimerating
GeoEnrich API

بسيط. يمكن التنبؤ به. نقطة نهاية واحدة.

لا إعداد معقد. لا حاجة لتجميع استدعاءات متعددة. مرّر عنوانًا واحصل على الطبقة الجغرافية الكاملة اللازمة لترميز schema.org في كل صفحة إعلان.

  • نقطة نهاية واحدة تتعامل مع الترميز الجغرافي والبحث عن 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 الخاص بك حتى ترى محركات الذكاء الاصطناعي بيانات موثقة وحديثة.

مُصمَّم للمعالجة الضخمة

مُصمَّم لقواعد بيانات تضم 50,000 إعلان أو أكثر. شغّل مهمة الإثراء مرة واحدة عند وقت البناء، وخزّن الطبقة الجغرافية مؤقتًا، وقدّمها بتكلفة صفرية لكل طلب.

مستضاف في الاتحاد الأوروبي، متوافق مع GDPR

مستضاف بالكامل في الاتحاد الأوروبي مع وثائق الامتثال للائحة GDPR والبنود التعاقدية القياسية. لا مخاطر لإقامة البيانات لبوابات الإعلانات الأوروبية.

المواصفات التقنية

نقطة النهاية

الطريقة
GET /v1/geoenrich
تنسيق الاستجابة
JSON (schema.org-ready)

المعاملات

address
مطلوب. سلسلة العنوان الخام.
radius
أمتار. الافتراضي 600.

حقول الاستجابة

coordinates
lat / lng (4 منازل عشرية)
nearby[]
name, type, distance (أمتار)

هل أنت مستعد للبدء؟

ابدأ البناء مع MapAtlas اليوم. سجل مجانًا واحصل على وصول فوري إلى جميع واجهات برمجة التطبيقات الخاصة بالخرائط مع حدود مجانية سخية.

GeoEnrich API: أسئلة شائعة

كل ما تحتاج معرفته قبل إثراء أول إعلان لديك.

GeoEnrich API: أسئلة شائعة

كل ما تحتاج معرفته قبل إثراء أول إعلان لديك.

ما البيانات التي تُعيدها GeoEnrich API؟
يُعيد الاستدعاء الواحد: إحداثيات بدقة السطح (lat/lng) وتسلسل كامل للأحياء (الحي الفرعي والحي والمقاطعة والمدينة والولاية والدولة والرمز البريدي) وقائمة بالأماكن القريبة ضمن نطاقك المختار. تتضمن كل مكان قريب الاسم والنوع والمسافة والاتجاه وأوقات السفر سيرًا وبالدراجة وبالسيارة إضافة إلى تفاصيل غنية مثل وجهات خطوط المواصلات وساعات العمل والتقييمات وبيانات الازدحام الحية. تتضمن الاستجابة أيضًا neighborhoodProfile مع walkScore وbikeScore وtransitScore ومؤشر جودة الهواء ومستوى الضوضاء.
ما الفرق بين GeoEnrich API وGeocoding API؟
تحول واجهة برمجة الترميز الجغرافي العنوان إلى إحداثيات. تذهب GeoEnrich API أبعد من ذلك بكثير: فهي تجمع الترميز الجغرافي مع تحليل الأحياء والبحث الكامل عن POI في استدعاء واحد. بدلًا من إعادة زوج lat/lng، تُعيد كل ما تحتاجه صفحة الإعلان لتصبح مرئية للذكاء الاصطناعي، بما في ذلك الحقول الجاهزة لـ schema.org لـ GeoCoordinates وcontainedInPlace وamenityFeature.
كم مرة يتم تحديث بيانات الموقع؟
تُحدَّث بيانات POI وجداول المواصلات والتقييمات وساعات العمل في دورة شهرية. تحتوي كل استجابة على حقل dataTimestamp حتى تتمكن من عرض تاريخ التحديث كـ dateModified في JSON-LD. تعامل محركات الذكاء الاصطناعي وزواحف البحث البيانات المختومة حديثًا على أنها أكثر موثوقية، مما يحسن معدلات الاستشهاد.
هل تعمل GeoEnrich API في جميع البلدان؟
نعم. تغطي الواجهة البرمجية أكثر من 180 دولة بمخرجات JSON متسقة ونفس تعيين حقول schema.org في كل مكان. يتفاوت عمق التغطية حسب المنطقة: تمتلك المدن الأوروبية أكثر بيانات POI والمواصلات تفصيلًا، بينما تشمل التغطية العالمية الإحداثيات وتسلسل الأحياء وفئات POI الأساسية.
هل يمكنني تشغيل GeoEnrich على قاعدة بيانات ضخمة من الإعلانات؟
الواجهة البرمجية مُصمَّمة خصيصًا للاستخدام الضخم. شغّل مهمة الإثراء مرة واحدة عند وقت البناء وخزّن الطبقة الجغرافية لكل إعلان مؤقتًا وقدّمها بتكلفة صفرية لكل طلب بشكل مستمر. يتضمن المستوى المجاني 50,000 إثراء في الشهر. تدعم الخطط الأكبر إنتاجية أعلى مع دعم نقطة النهاية الدفعية.
كيف تساعد بيانات الموقع صفحات الإعلانات على التصنيف في بحث الذكاء الاصطناعي؟
تُجيب محركات البحث بالذكاء الاصطناعي مثل 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 ذات الصلة