البدء

نظرة عامة

يوفر Oolel Maps واجهة RESTful للترميز الجغرافي والبحث والملاحة وإدارة العناوين في غرب أفريقيا. جميع نقاط الوصول تُرجع JSON وتدعم الفرنسية والعربية والإنجليزية عبر معامل language.

https://api.oolel.com

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

بعد تسجيل الدخول، انتقل إلى قسم مفاتيح API في لوحة التحكم. انقر على "إنشاء مفتاح جديد" وأعطه اسماً وصفياً (مثل "إنتاج" أو "تطوير"). انسخ مفتاحك واحفظه بأمان — لن تتمكن من رؤيته مرة أخرى بعد الإنشاء.

استخدم مفتاح API في ترويسة Authorization مع بادئة Bearer. إليك طلب ترميز جغرافي مباشر بسيط:

curl -X GET "https://api.oolel.com/geocoding/forward?q=Tevragh+Zeina+Nouakchott" \
  -H "Authorization: Bearer YOUR_API_KEY"

المصادقة

يجب أن تتضمن جميع طلبات API مفتاحك في ترويسة Authorization:

Authorization: Bearer YOUR_API_KEY

الطلبات بدون مفتاح API صالح ستتلقى استجابة 401 Unauthorized.

حدود المعدل

تتضمن الطبقة المجانية 10,000 طلب شهرياً. تُطبق حدود المعدل لكل مفتاح API بحد أقصى 100 طلب في الدقيقة. الترويسات التالية مضمنة في كل استجابة:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1709683200

معالجة الأخطاء

تستخدم الواجهة رموز حالة HTTP القياسية. تتضمن استجابات الأخطاء جسم JSON مع رسالة وصفية:

{
  "statusCode": 400,
  "message": "Query parameter 'q' is required",
  "error": "Bad Request"
}