واجهة الملاحة

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

الحصول على الاتجاهات

احسب مساراً بين نقطة انطلاق ووجهة. تتضمن الاستجابة هندسة GeoJSON LineString لعرض الخريطة، والمسافة والمدة الإجمالية، وتعليمات ملاحة خطوة بخطوة.

GET/navigation/directions

حساب اتجاهات المسار مع تعليمات خطوة بخطوة بين نقطتين

المعاملات

المعاملالنوعمطلوبالوصف
originLatitudenumberمطلوبخط عرض نقطة الانطلاق(مثال: 18.0858)
originLongitudenumberمطلوبخط طول نقطة الانطلاق(مثال: -15.9785)
destinationLatitudenumberمطلوبخط عرض الوجهة(مثال: 18.1012)
destinationLongitudenumberمطلوبخط طول الوجهة(مثال: -15.9507)
profilestringاختياريملف التوجيه: "driving-traffic" (افتراضي) أو "walking" أو "cycling"(مثال: driving-traffic)
languagestringاختياريلغة تعليمات الملاحة: fr أو ar أو en(مثال: fr)
alternatesnumberاختياريعدد المسارات البديلة (0-3، الافتراضي: 0)(مثال: 2)

ملفات التوجيه

driving-traffic

مسارات السيارة مع بيانات حركة المرور الحية. الملف الافتراضي.

walking

مسارات المشاة باستخدام الممرات والأرصفة.

cycling

مسارات الدراجات مع تفضيل الطرق الملائمة للدراجات.

مثال على طلب

curl -X GET "https://api.oolel.com/navigation/directions?\
originLatitude=18.0858&\
originLongitude=-15.9785&\
destinationLatitude=18.1012&\
destinationLongitude=-15.9507&\
profile=driving-traffic&\
language=fr&\
alternates=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

{
  "routes": [
    {
      "distance": 4250,
      "duration": 612,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [-15.9785, 18.0858],
          [-15.9762, 18.0871],
          [-15.9701, 18.0923],
          [-15.9598, 18.0967],
          [-15.9507, 18.1012]
        ]
      },
      "legs": [
        {
          "distance": 4250,
          "duration": 612,
          "steps": [
            {
              "instruction": "Dirigez-vous vers le nord-est sur Avenue Gamal Abdel Nasser",
              "distance": 850,
              "duration": 124,
              "maneuver": {
                "type": "depart",
                "modifier": "right",
                "location": [-15.9785, 18.0858]
              }
            },
            {
              "instruction": "Tournez a droite sur Route de l'Ambassade",
              "distance": 1200,
              "duration": 185,
              "maneuver": {
                "type": "turn",
                "modifier": "right",
                "location": [-15.9762, 18.0871]
              }
            },
            {
              "instruction": "Continuez tout droit pendant 1.4 km",
              "distance": 1400,
              "duration": 203,
              "maneuver": {
                "type": "continue",
                "modifier": "straight",
                "location": [-15.9701, 18.0923]
              }
            },
            {
              "instruction": "Vous etes arrive a destination",
              "distance": 0,
              "duration": 0,
              "maneuver": {
                "type": "arrive",
                "modifier": "straight",
                "location": [-15.9507, 18.1012]
              }
            }
          ]
        }
      ]
    }
  ],
  "waypoints": [
    {
      "name": "Avenue Gamal Abdel Nasser",
      "location": [-15.9785, 18.0858]
    },
    {
      "name": "Route de Nouadhibou",
      "location": [-15.9507, 18.1012]
    }
  ]
}

ملاحظات الاستخدام

تنسيق الهندسة

تُرجع هندسة المسار كـ GeoJSON LineString بإحداثيات بترتيب [خط الطول، خط العرض]، وفقاً لمواصفات GeoJSON. يمكن عرضها مباشرة على MapLibre GL أو Leaflet أو أي مكتبة خرائط متوافقة مع GeoJSON.

أنواع المناورات

تتضمن كل خطوة كائن مناورة مع type (depart، turn، continue، merge، roundabout، arrive) و modifier (left، right، straight، slight left، slight right، sharp left، sharp right، uturn). استخدمها لواجهات ملاحة مخصصة.

المسارات البديلة

اضبط alternates=2 لتلقي حتى مسارين بديلين إلى جانب المسار الرئيسي. تُرجع المسارات البديلة في نفس مصفوفة routes، مرتبة حسب المدة (الأسرع أولاً).