واجهة العناوين
اطّلع وساهم في قاعدة بيانات العناوين التشاركية لـ Oolel. تصفّح العناوين الموثقة، وابحث عن مواقع محددة، وأرسل عناوين جديدة للتحقق. العناوين المقدمة حديثاً تبدأ بحالة "قيد الانتظار" حتى المراجعة.
عرض العناوين
استرجع قائمة مُرقّمة من العناوين. فلتر حسب المدينة أو حالة التحقق لتضييق النتائج.
المعاملات
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
page | number | اختياري | رقم الصفحة للترقيم (الافتراضي: 1)(مثال: 1) |
limit | number | اختياري | عدد النتائج لكل صفحة (1-100، الافتراضي: 20)(مثال: 20) |
city | string | اختياري | فلتر حسب اسم المدينة(مثال: Nouakchott) |
status | string | اختياري | فلتر حسب حالة التحقق: "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
}الحصول على عنوان بالمعرف
استرجع عنواناً واحداً بمعرفه الفريد. يُرجع سجل العنوان الكامل متضمناً جميع المكونات والبيانات الوصفية.
المعاملات
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
id | string | مطلوب | المعرف الفريد للعنوان(مثال: addr_a1b2c3d4) |
إنشاء عنوان
أرسل عنواناً جديداً إلى قاعدة البيانات. جميع العناوين الجديدة تُنشأ بحالة "قيد الانتظار" ويجب التحقق منها من قبل مشرف قبل ظهورها في نتائج البحث. تتطلب نقطة الوصول هذه مصادقة.
جسم الطلب
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
formatted | string | مطلوب | سلسلة العنوان المنسقة الكاملة(مثال: Boutique Chez Ahmed, Ilot K, Nouakchott) |
latitude | number | مطلوب | خط عرض العنوان(مثال: 18.0795) |
longitude | number | مطلوب | خط طول العنوان(مثال: -15.9692) |
type | string | اختياري | نوع العنوان: "residential" أو "commercial" أو "poi" أو "other"(مثال: commercial) |
components | object | اختياري | مكونات العنوان المنظمة (الاسم، الشارع، الحي، المدينة، إلخ) |
مثال على طلب
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"
}