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

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

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

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

GET/geocoding/forward

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

المعاملات

المعاملالنوعمطلوبالوصف
qstringمطلوبالعنوان أو اسم المكان المراد ترميزه جغرافياً(مثال: Marche Capitale Nouakchott)
languagestringاختياريلغة الاستجابة: fr أو ar أو en(مثال: fr)
limitnumberاختياريالحد الأقصى لعدد النتائج (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

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

المعاملات

المعاملالنوعمطلوبالوصف
latitudenumberمطلوبخط عرض النقطة المراد ترميزها عكسياً(مثال: 18.0858)
longitudenumberمطلوبخط طول النقطة المراد ترميزها عكسياً(مثال: -15.9785)
languagestringاختياريلغة الاستجابة: 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
  }
}