واجهة العناوين

اطّلع وساهم في قاعدة بيانات العناوين التشاركية لـ Oolel. تصفّح العناوين الموثقة، وابحث عن مواقع محددة، وأرسل عناوين جديدة للتحقق. العناوين المقدمة حديثاً تبدأ بحالة "قيد الانتظار" حتى المراجعة.

عرض العناوين

استرجع قائمة مُرقّمة من العناوين. فلتر حسب المدينة أو حالة التحقق لتضييق النتائج.

GET/addresses

عرض العناوين مع الترقيم وفلاتر اختيارية حسب المدينة/الحالة

المعاملات

المعاملالنوعمطلوبالوصف
pagenumberاختياريرقم الصفحة للترقيم (الافتراضي: 1)(مثال: 1)
limitnumberاختياريعدد النتائج لكل صفحة (1-100، الافتراضي: 20)(مثال: 20)
citystringاختياريفلتر حسب اسم المدينة(مثال: Nouakchott)
statusstringاختياريفلتر حسب حالة التحقق: "verified" أو "pending" أو "rejected"(مثال: verified)

مثال على طلب

curl -X GET "https://api.oolel.com/addresses?city=Nouakchott&status=verified&limit=2" \
  -H "Authorization: Bearer YOUR_API_KEY"

مثال على استجابة

{
  "results": [
    {
      "id": "addr_a1b2c3d4",
      "formatted": "Pharmacie Centrale, Ave Gamal Abdel Nasser, Tevragh Zeina, Nouakchott",
      "latitude": 18.0862,
      "longitude": -15.9781,
      "type": "commercial",
      "status": "verified",
      "components": {
        "name": "Pharmacie Centrale",
        "street": "Avenue Gamal Abdel Nasser",
        "neighbourhood": "Tevragh Zeina",
        "city": "Nouakchott",
        "adminLevel1": "Nouakchott-Ouest",
        "country": "Mauritania"
      },
      "createdAt": "2025-09-15T10:30:00Z",
      "updatedAt": "2025-11-02T14:22:00Z"
    },
    {
      "id": "addr_e5f6g7h8",
      "formatted": "Mosquee Al-Salam, Ksar, Nouakchott",
      "latitude": 18.0901,
      "longitude": -15.9742,
      "type": "poi",
      "status": "verified",
      "components": {
        "name": "Mosquee Al-Salam",
        "neighbourhood": "Ksar",
        "city": "Nouakchott",
        "adminLevel1": "Nouakchott-Nord",
        "country": "Mauritania"
      },
      "createdAt": "2025-08-22T08:15:00Z",
      "updatedAt": "2025-10-10T11:45:00Z"
    }
  ],
  "page": 1,
  "limit": 2,
  "totalResults": 1847,
  "totalPages": 924
}

الحصول على عنوان بالمعرف

استرجع عنواناً واحداً بمعرفه الفريد. يُرجع سجل العنوان الكامل متضمناً جميع المكونات والبيانات الوصفية.

GET/addresses/:id

استرجاع عنوان محدد بمعرفه الفريد

المعاملات

المعاملالنوعمطلوبالوصف
idstringمطلوبالمعرف الفريد للعنوان(مثال: addr_a1b2c3d4)

إنشاء عنوان

أرسل عنواناً جديداً إلى قاعدة البيانات. جميع العناوين الجديدة تُنشأ بحالة "قيد الانتظار" ويجب التحقق منها من قبل مشرف قبل ظهورها في نتائج البحث. تتطلب نقطة الوصول هذه مصادقة.

POST/addresses

إرسال عنوان تشاركي جديد (يتطلب مصادقة)

جسم الطلب

المعاملالنوعمطلوبالوصف
formattedstringمطلوبسلسلة العنوان المنسقة الكاملة(مثال: Boutique Chez Ahmed, Ilot K, Nouakchott)
latitudenumberمطلوبخط عرض العنوان(مثال: 18.0795)
longitudenumberمطلوبخط طول العنوان(مثال: -15.9692)
typestringاختيارينوع العنوان: "residential" أو "commercial" أو "poi" أو "other"(مثال: commercial)
componentsobjectاختياريمكونات العنوان المنظمة (الاسم، الشارع، الحي، المدينة، إلخ)

مثال على طلب

curl -X POST "https://api.oolel.com/addresses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "formatted": "Boutique Chez Ahmed, Ilot K, Nouakchott",
    "latitude": 18.0795,
    "longitude": -15.9692,
    "type": "commercial",
    "components": {
      "name": "Boutique Chez Ahmed",
      "neighbourhood": "Ilot K",
      "city": "Nouakchott",
      "country": "Mauritania"
    }
  }'

مثال على استجابة

{
  "id": "addr_m3n4o5p6",
  "formatted": "Boutique Chez Ahmed, Ilot K, Nouakchott",
  "latitude": 18.0795,
  "longitude": -15.9692,
  "type": "commercial",
  "status": "pending",
  "components": {
    "name": "Boutique Chez Ahmed",
    "neighbourhood": "Ilot K",
    "city": "Nouakchott",
    "country": "Mauritania"
  },
  "createdAt": "2026-03-05T09:12:34Z",
  "updatedAt": "2026-03-05T09:12:34Z"
}