الرئيسية / الزحمة
إرسال مسار GPS (الزحمة)
POST
/routing/traffic/v1/traces
تطبيقات السائقين ترسل نقاط GPS لمركبة واحدة؛ تُحفظ سرعة كل جزء طريق فقط فتتحسن أزمنة الوصول للجميع.
الصلاحية المطلوبة على المفتاح: traffic
جرّب الآن
POST /routing/traffic/v1/tracesالطلب كـ curl
الزر يبني مساراً تجريبياً بسرعة 30 كم/س على طول طريق حقيقي ويرسمه.
الرد كاملاً
المعاملات
| الاسم | المكان | النوع | الوصف |
|---|---|---|---|
points |
الجسم | JSON | 2–100 نقطة لمركبة واحدة، الأقدم أولاً، من آخر ساعة: lon وlat وtime (ثوانٍ Unix) وaccuracy (اختياري، متر). |
الرد
- segments
- عدد أجزاء الطرق التي قيست. 0 ليس خطأ: نقاط خارج الطريق أو مركبة متوقفة.
ملاحظات
- time بالثواني: Math.floor(Date.now() / 1000)، لا بالمللي ثانية.
- سجّل نقطة كل 3–5 ثوانٍ أثناء القيادة، وأرسل دفعة كل دقيقة أو كل 20 نقطة.
- لا تُحفظ النقاط ولا المركبة ولا الرحلة.
مثال
curl -X POST -H "X-Api-Key: $KEY" -H 'Content-Type: application/json' \
"https://<الخادم>/routing/traffic/v1/traces" \
-d '{"points":[{"lon":44.4084,"lat":33.3283,"time":1791640000},{"lon":44.4091,"lat":33.3279,"time":1791640004}]}'