الرئيسية / المسار
المسار
GET
/routing/route/v1/driving/{coordinates}
مسار بالسيارة عبر 2–25 نقطة بالترتيب، مع الزمن والمسافة، ومستوى الزحمة عند الطلب.
الصلاحية المطلوبة على المفتاح: route
جرّب الآن
GET /routing/route/v1/driving/{coordinates}الطلب كـ curl
اضغط على الخريطة لإضافة نقطة إلى المسار.
الرد كاملاً
المعاملات
| الاسم | المكان | النوع | الوصف |
|---|---|---|---|
coordinates * |
المسار | lng,lat;lng,lat;… | النقاط بالترتيب: خط الطول أولاً، وفاصلة منقوطة بينها. |
overview |
الاستعلام | full | simplified | false | دقة شكل المسار. |
geometries |
الاستعلام | geojson | polyline | polyline6 | صيغة الشكل؛ geojson للرسم مباشرة. |
congestion |
الاستعلام | true | false | مستوى الزحمة لكل جزء وللمسار كله (إضافة من البوابة). |
alternatives |
الاستعلام | false | true | 2 | طرق بديلة. |
steps |
الاستعلام | true | false | خطوات الانعطاف. |
الرد
- routes[0].duration / distance
- الثواني (مع الزحمة) والأمتار.
- routes[0].geometry
- الخط المرسوم بالصيغة المطلوبة.
- routes[0].congestion
- مع congestion=true: level (low/moderate/heavy/severe/unknown) وdelay وfree_flow_duration.
- waypoints[].distance
- كم تحركت كل نقطة لتصل إلى الطريق، بالأمتار: افحصها قبل الرسم.
ملاحظات
- OSRM يلصق كل نقطة بأقرب طريق مهما بعد: إذا تجاوزت waypoints[].distance نحو 500 م فالنقطة بعيدة أو الإحداثيات معكوسة.
- الزمن يشمل الزحمة التقديرية والمقاسة من مركبات العملاء، والطرق المغلقة يتجنبها.
- لنصوص الانعطاف بالعربي استخدم osrm-text-instructions.
مثال
curl -H "X-Api-Key: $KEY" \
"https://<الخادم>/routing/route/v1/driving/44.3661,33.3152;44.4009,33.2778?overview=full&geometries=geojson&congestion=true&alternatives=false&steps=false"