الأسطول والخدمات اللوجستية
الأسطول والخدمات اللوجستية
لمنتجات التوصيل والخدمة الميدانية والأسطول، تقدّم Navvo تحسين المسارات متعدّدة المحطّات، ومخاطر مسار تراعي الظروف، وعلاقة ثنائية الاتجاه مع طبقة حركة المرور: رحلاتك تحسّن حركة المرور، وحركة المرور الحيّة تحسّن أوقات وصولك.
النطاقات المطلوبة: routing وtraffic وtelemetry (وgeo/tiles حسب الحاجة).
1. حسّن مسارًا متعدّد المحطّات
يبني POST /routing/plan المسار، ويحسّن ترتيب المحطّات، ويطبّق قيود المركبة، ويبلّغ عن أي مناطق لوجستية تمّ عبورها — في استدعاء واحد.
const res = await fetch("https://navvo.io/api/v1/routing/plan", {
method: "POST",
headers: { "x-api-key": KEY, "Content-Type": "application/json" },
body: JSON.stringify({
locations: [
{ lon: 35.91, lat: 31.95, name: "Depot" },
{ lon: 35.95, lat: 31.99, name: "Stop A" },
{ lon: 35.88, lat: 31.97, name: "Stop B" },
{ lon: 35.93, lat: 31.93, name: "Stop C" },
],
costing: "truck",
preference: "fastest",
avoid: ["unpaved"],
optimize: true,
constraintsText: "Stop A must be before 11:00; avoid the old downtown.",
}),
});
const plan = await res.json();
const trip = plan.engine.data.trip; // route geometry + maneuvers
const zones = plan.logistics.matchedZones; // SLA / restricted zones crossed
const order = plan.constraints; // AI-parsed stop ordering/time windows
/plan ترتيب المحطّات تلقائيًا. تخبرك كتلة logistics إن كان المسار يدخل مناطق ذات وصول مقيّد أو ازدحام عالٍ، مع costMultiplier يمكنك دمجه في التسعير.2. قيّم مخاطر المسار قبل الإرسال
يقيّم POST /map/route-risk مسارًا عبر حركة المرور والطقس والحوادث والمناطق اللوجستية وأصول الإنفاذ:
const risk = await (await fetch("https://navvo.io/api/v1/map/route-risk", {
method: "POST",
headers: { "x-api-key": KEY, "Content-Type": "application/json" },
body: JSON.stringify({
routeId: "trip-42",
timeOffset: "+1h", // score against the forecast an hour out
geometry: { type: "LineString", coordinates: routeCoords }, // [[lng,lat], …]
}),
})).json();
console.log(risk.severity, risk.scores.overall); // "low", 24
risk.warnings.forEach((w) => console.log(w.type, w.title, w.location));
استخدم POST /map/route-enforcement للحصول فقط على كاميرات السرعة / الإشارات على طول المسار.
3. أوقات وصول تراعي حركة المرور
احسب أوقات الوصول الحيّة باستخدام POST /traffic/route (راجع الاتجاهات وأوقات الوصول الحيّة). لقرارات الإرسال عبر العديد من السائقين، اجمعها دفعةً واحدةً مع POST /routing/matrix.
4. ساهم بالرحلات (واحصل على حركة مرور أفضل في المقابل)
إذا كانت تطبيقات سائقيك تلتقط الموقع، أرسل رحلات مجهولة المصدر إلى POST /telemetry/trips. تطابق Navvo هذه الرحلات مع الخريطة وتدمج السرعات في طبقات حركة المرور الحيّة/النمطية — مما يحسّن أوقات الوصول لأسطولك بأكمله.
await fetch("https://navvo.io/api/v1/telemetry/trips", {
method: "POST",
headers: { "x-api-key": KEY, "Content-Type": "application/json" },
body: JSON.stringify({
metadata: { consentCaptured: true },
points: gpsTrace.map((p) => ({
lat: p.lat, lng: p.lng,
speed: p.speedMps, // meters/second
capturedAt: p.timestampIso, // ISO-8601
})),
}),
});
الحلقة
التخطيط
POST /routing/plan — مسار متعدّد المحطّات مُحسّن ومُراعٍ للقيود.
التقييم
POST /map/route-risk — حركة المرور والطقس والحوادث والمناطق والإنفاذ.
القيادة
POST /traffic/route — أوقات وصول حيّة؛ POST /telemetry/trips — ساهم ببيانات الاستشعار.
التحسين
رحلاتك تشحذ طبقة حركة المرور التي تشغّل الخطة التالية.