واجهة الترميز الجغرافي

حوّل العناوين وأسماء الأماكن إلى إحداثيات جغرافية (ترميز مباشر) أو حوّل الإحداثيات إلى عناوين مقروءة (ترميز عكسي). يدعم الاستعلامات متعددة اللغات بالفرنسية والعربية والإنجليزية.

الترميز الجغرافي المباشر

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

GET/geocoding/forward

ترميز عنوان أو اسم مكان إلى إحداثيات خط العرض/خط الطول

المعاملات

المعامل	النوع	مطلوب	الوصف
`q`	string	مطلوب	العنوان أو اسم المكان المراد ترميزه جغرافياً(مثال: Marche Capitale Nouakchott)
`language`	string	اختياري	لغة الاستجابة: fr أو ar أو en(مثال: fr)
`limit`	number	اختياري	الحد الأقصى لعدد النتائج (1-10، الافتراضي: 5)(مثال: 3)

مثال على طلب

curl -X GET "https://api.oolel.com/geocoding/forward?q=Marche+Capitale+Nouakchott&language=fr&limit=3" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "results": [
    {
      "formatted": "Marche Capitale, Tevragh Zeina, Nouakchott, Mauritania",
      "latitude": 18.0858,
      "longitude": -15.9785,
      "confidence": 0.92,
      "type": "poi",
      "components": {
        "name": "Marche Capitale",
        "neighbourhood": "Tevragh Zeina",
        "city": "Nouakchott",
        "adminLevel1": "Nouakchott-Ouest",
        "country": "Mauritania",
        "countryCode": "MR"
      }
    },
    {
      "formatted": "Marche Capitale Annexe, Ksar, Nouakchott, Mauritania",
      "latitude": 18.0912,
      "longitude": -15.9734,
      "confidence": 0.74,
      "type": "poi",
      "components": {
        "name": "Marche Capitale Annexe",
        "neighbourhood": "Ksar",
        "city": "Nouakchott",
        "adminLevel1": "Nouakchott-Nord",
        "country": "Mauritania",
        "countryCode": "MR"
      }
    }
  ],
  "query": "Marche Capitale Nouakchott",
  "totalResults": 2
}

الترميز الجغرافي العكسي

حوّل إحداثيات جغرافية إلى عنوان مقروء. يُرجع أقرب عنوان أو مكان معروف للنقطة المحددة، مع المسافة بالأمتار.

GET/geocoding/reverse

ترميز عكسي للإحداثيات إلى أقرب عنوان أو مكان

المعاملات

المعامل	النوع	مطلوب	الوصف
`latitude`	number	مطلوب	خط عرض النقطة المراد ترميزها عكسياً(مثال: 18.0858)
`longitude`	number	مطلوب	خط طول النقطة المراد ترميزها عكسياً(مثال: -15.9785)
`language`	string	اختياري	لغة الاستجابة: fr أو ar أو en(مثال: fr)

مثال على طلب

curl -X GET "https://api.oolel.com/geocoding/reverse?latitude=18.0858&longitude=-15.9785&language=fr" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "result": {
    "formatted": "Marche Capitale, Tevragh Zeina, Nouakchott, Mauritania",
    "latitude": 18.0858,
    "longitude": -15.9785,
    "distance": 12.4,
    "components": {
      "name": "Marche Capitale",
      "neighbourhood": "Tevragh Zeina",
      "city": "Nouakchott",
      "adminLevel1": "Nouakchott-Ouest",
      "country": "Mauritania",
      "countryCode": "MR"
    }
  },
  "query": {
    "latitude": 18.0858,
    "longitude": -15.9785
  }
}