واجهة الملاحة
احصل على اتجاهات المسار بين نقطتين مع تعليمات خطوة بخطوة. يدعم القيادة (مع حركة المرور) والمشي وركوب الدراجات. التعليمات متاحة بالفرنسية والعربية والإنجليزية.
الحصول على الاتجاهات
احسب مساراً بين نقطة انطلاق ووجهة. تتضمن الاستجابة هندسة GeoJSON LineString لعرض الخريطة، والمسافة والمدة الإجمالية، وتعليمات ملاحة خطوة بخطوة.
المعاملات
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
originLatitude | number | مطلوب | خط عرض نقطة الانطلاق(مثال: 18.0858) |
originLongitude | number | مطلوب | خط طول نقطة الانطلاق(مثال: -15.9785) |
destinationLatitude | number | مطلوب | خط عرض الوجهة(مثال: 18.1012) |
destinationLongitude | number | مطلوب | خط طول الوجهة(مثال: -15.9507) |
profile | string | اختياري | ملف التوجيه: "driving-traffic" (افتراضي) أو "walking" أو "cycling"(مثال: driving-traffic) |
language | string | اختياري | لغة تعليمات الملاحة: fr أو ar أو en(مثال: fr) |
alternates | number | اختياري | عدد المسارات البديلة (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، مرتبة حسب المدة (الأسرع أولاً).