مرجع سريع لخدمة Fleet Engine

‫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" في الحالات التالية:

خدمة 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: الأخطاء الشائعة

  • المشكلة: قد يتعذّر أحيانًا إرسال الطلبات إلى 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 API reportBillableEvent العَرَض: مشكلة خاصة بالعقد، وليست إيقافًا نهائيًا لواجهة برمجة التطبيقات. بعد نقل البيانات، يمكن أن تعرض الطلبات رسالة الخطأ "عقد غير صالح: هذا المشروع [...] غير مصرَّح له باستخدام FleetEngine". يُرجى الاطّلاع على دليل نقل البيانات.

الإجراءات التي يمكنك تنفيذها باستخدام خدمة Fleet Engine

يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.