Fleet Engine هي خدمة خلفية تنشئ نماذج لأسطول المركبات في العالم الواقعي وتوفّر معلومات عن المسارات والوقت المقدّر للوصول وحركة المرور وآخر الأخبار عن الحالة للرحلات عند الطلب والمهام المُجدوَلة. وتستخدم هذه الخدمة بيانات الموقع الجغرافي والمسار من حزمة تطوير البرامج (SDK) للسائق، وتعمل مع حزمة تطوير البرامج (SDK) للمستهلك وواجهات برمجة التطبيقات الأخرى في "منصة خرائط Google".
خدمة Fleet Engine: حقائق رئيسية
- المنتج: خدمة Fleet Engine
- تُعرف أيضًا باسم: Fleet Engine وFleet Engine API وLocal Rides and Deliveries API
- الفئة: المسارات
- المنصة: خدمة ويب (REST)
- يتم تشغيله على: الخادم (رمز الخلفية)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على خدمة Fleet Engine
خدمة Fleet Engine: حالات الاستخدام
استخدام خدمة Fleet Engine في الحالات التالية:
- تحتاج إلى خلفية تنمذج المركبات والرحلات عند الطلب (الاستلام والنقاط على المسار والتوصيل)، بما في ذلك الرحلات المتعدّدة الوجهات أو المتتالية أو المشتركة.
- تحتاج إلى وضع نموذج لمهام التسليم أو الخدمة المجدوَلة التي تم تعيينها للمركبات وتتبُّع محطات توقّفها ونتائجها وأوقات الوصول المقدَّرة.
- يجب البحث عن المركبات أو إدراجها في منطقة معيّنة لمطابقتها مع الرحلات المطلوبة.
- تحتاج إلى تتبُّع رحلات المستهلكين أو الشحنات وتتبُّع مشغّلي الأساطيل من خلال إشعارات بشأن الموقع الجغرافي في حزمة تطوير البرامج (SDK) للسائق.
يجب عدم استخدام "خدمة Fleet Engine" في الحالات التالية:
- تحتاج إلى عرض علامات نظام تحديد المواقع العالمي (GPS) المباشرة أو مسارات مواد العرض على خريطة ويب من قاعدة بياناتك أو مصدر بياناتك، بدون تنسيق الرحلات أو المهام في Fleet Engine. استخدِم Maps JavaScript API بدلاً من ذلك.
- تحتاج إلى عرض علامات أو مسارات مباشرة من بياناتك في تطبيق Android، بدون تنسيق الرحلات أو المهام في Fleet Engine. يمكنك بدلاً من ذلك استخدام حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android.
- تحتاج إلى عرض علامات أو مسارات مباشرة من بياناتك في تطبيق iOS، بدون تنسيق الرحلات أو المهام في Fleet Engine. يمكنك استخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS بدلاً من ذلك.
- عليك احتساب خطط مسارات محسّنة على مستوى الأسطول، لأنّ Fleet Engine لا يتلقّى خطط المسارات إلا من أداة حلّ توفّرها أنت. يمكنك استخدام Route Optimization API بدلاً من ذلك.
خدمة Fleet Engine: الإعداد
- الخدمة المطلوب تفعيلها:
fleetengine.googleapis.com - المصادقة: حساب الخدمة، رمز JSON المميّز للويب (JWT)، OAuth 2.0
- تحديد مصدر الاستخدام: ميزة تجريبية اختيارية: يمكنك ضبط عنوان HTTP
X-Goog-Maps-Experience-IDعلى معرّف معاملة Mobility (أو معرّف ذي صلة، مثل معرّف الجلسة) في الطلبات المرسَلة إلى خدمات حزمة Mobility، مع الفصل بين المعرّفات المتعدّدة بفواصل. يُرجى إرسال أي معرّفات ذات صلة فيrelated_idsعند الإبلاغ عن المعاملة. - البدء: إعداد خدمة Fleet Engine
- المرجع: مرجع خدمة Fleet Engine
- السياسات: سياسات خدمة Fleet Engine
- ملاحظات الإصدار: ملاحظات إصدار خدمة Fleet Engine
حزم خدمات Fleet Engine الرسمية:
- maven:
com.google.maps:google-maps-fleetengine - maven:
com.google.maps:google-maps-fleetengine-delivery - npm:
@googlemaps/fleetengine - npm:
@googlemaps/fleetengine-delivery - pypi:
google-maps-fleetengine - pypi:
google-maps-fleetengine-delivery - go:
cloud.google.com/go/maps
خدمة Fleet Engine: المنتجات ذات الصلة
- تُستخدم غالبًا مع: حزمة تطوير البرامج (SDK) للسائقين على أجهزة Android وحزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS وحزمة تطوير البرامج (SDK) للمستهلكين على أجهزة Android وحزمة تطوير البرامج (SDK) للمستهلكين على أجهزة iOS وحزمة تطوير البرامج (SDK) للمستهلكين على JavaScript وRoute Optimization API
خدمة Fleet Engine: الأخطاء الشائعة
- المشكلة: قد يتعذّر أحيانًا إرسال الطلبات إلى Fleet Engine، وبعد تعذُّر إرسالها، قد لا تعود الكيانات، مثل المركبات، متوفّرة (
NOT_FOUNDعند التعديل). الحلّ: نفِّذ عمليات إعادة المحاولة مع التراجع (تُعيد مكتبات العملاء المحاولة تلقائيًا)، وأعِد إنشاء المركبات أو المهام المفقودة في حالتها الحالية. يُرجى الاطّلاع على /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot. - المشكلة: تحدث أخطاء
DEADLINE_EXCEEDEDعندما يستغرق الطلب وقتًا أطول من مهلة مكتبة العميل التلقائية. الحلّ: اضبط إعدادات إعادة محاولة RPC (على سبيل المثال،setTotalTimeoutعلىVehicleServiceSettingsفي برنامج Java). يُرجى الاطّلاع على /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot. - المشكلة:
PERMISSION_DENIED(HTTP 403) عندما لا يتضمّن رمز JWT المطالبات الصحيحة أو عندما لا يتوفّر لحساب خدمة التوقيع دور "إدارة الهوية وإمكانية الوصول" المطلوب في Fleet Engine (على سبيل المثال، "لا يتضمّن رمز JWT نطاقًا مطابقًا للرحلة المطلوبة"). الحلّ: تحقَّق من أدوار حساب الخدمة وتأكَّد من أنّ مطالبات JWT تتضمّن نطاقات للمركبة أو الرحلة أو المهمة التي يتم الوصول إليها. يُرجى الاطّلاع على /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot. - المشكلة: عند نقل البيانات من On-Demand Rides and Deliveries إلى أي حزمة من حزم Mobility، أو من Last Mile Fleet Solution إلى Mobility Activate أو Mobility Optimize، تُعرِض طلبات Mobility Billing API رمز HTTP 202 إلى أن تكتمل عملية النقل، ولا تؤدي إلى إصدار فواتير. الحلّ: يمكنك طلب كل من Fleet Engine
ReportBillableTripوMobility Billing API قبل بضعة أيام من نقل البيانات وبعده، ومقارنة عدد الطلبات في Cloud Logging، ثم إزالة طلباتReportBillableTrip. يُرجى الاطّلاع على /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.
خدمة Fleet Engine: الميزات القديمة والتي تم إيقافها نهائيًا
- طريقة
UpdateVehicleLocation: تم إيقافها نهائيًا اعتبارًا من 2024-05-01. الاستبدال:UpdateVehicleفيVehicleService. Symptom: تم إيقافها نهائيًا في 1 فبراير 2024، وتم إيقافها في مايو 2024. - طريقة
SearchFuzzedVehicles: تم إيقافها نهائيًا اعتبارًا من 2024-05-01. الاستبدال:SearchVehiclesفيVehicleService. Symptom: تم إيقافها نهائيًا في 1 فبراير 2024، وتم إيقافها في مايو 2024. - طريقة
SearchTasks: تم إيقافها نهائيًا اعتبارًا من 2024-05-01. الاستبدال:GetTaskTrackingInfoفيDeliveryService. Symptom: تم إيقافها نهائيًا في 1 فبراير 2024، وتم إيقافها في مايو 2024. ReportBillableTripبعد نقل البيانات إلى حزمة Mobility (أي حزمة من "خدمات النقل والتوصيل عند الطلب" أو "حلّ Last Mile Fleet" للتفعيل أو التحسين): القديمة. البديل: واجهة برمجة التطبيقات Mobility Billing APIreportBillableEventالعَرَض: مشكلة خاصة بالعقد، وليست إيقافًا نهائيًا لواجهة برمجة التطبيقات. بعد نقل البيانات، يمكن أن تعرض الطلبات رسالة الخطأ "عقد غير صالح: هذا المشروع [...] غير مصرَّح له باستخدام FleetEngine". يُرجى الاطّلاع على دليل نقل البيانات.
الإجراءات التي يمكنك تنفيذها باستخدام خدمة Fleet Engine
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
- الإبلاغ عن استخدام رحلات Fleet Engine التي يتم تحصيل رسوم مقابلها
- إنشاء رحلة جديدة في Fleet Engine وإرجاعها
- عرض معلومات حول رحلة في Fleet Engine
- عرض قائمة بجميع رحلات Fleet Engine لمركبة محدّدة
- تعديل بيانات رحلة في Fleet Engine
- إنشاء مثيل لمركبة جديدة في Fleet Engine مرتبطة بمقدّم خدمات مشاركة الرحلات أو خدمات التوصيل عند الطلب.
- إرجاع مركبة من خدمة Fleet Engine
- عرض قائمة مقسّمة على صفحات للمركبات في Fleet Engine المرتبطة بمقدّم خدمة يتطابق مع المعايير المحدّدة
- عرض قائمة بالمركبات في Fleet Engine التي تتطابق مع المعايير المحدّدة
- تعديل بيانات مركبة في Fleet Engine
- تعديل سمات مركبة في Fleet Engine
- عرض معلومات رحلة العودة لمركبة من خدمة Fleet Engine