مرجع سريع حول حزمة تطوير البرامج (SDK) للسائقين على أجهزة Android

حزمة تطوير البرامج (SDK) للسائقين على أجهزة Android هي مجموعة أدوات للأجهزة الجوّالة مخصّصة لتطبيقات السائقين، وهي ترسل تحديثات حول الموقع الجغرافي للمركبة والمسار والمسافة المتبقية والوقت المقدَّر للوصول من حزمة تطوير البرامج (SDK) للتنقّل إلى Fleet Engine. وتتيح هذه الخدمة الرحلات عند الطلب والمهام المُجدوَلة.

حزمة تطوير البرامج (SDK) للسائقين على أجهزة Android: معلومات أساسية

  • المنتج: حزمة تطوير البرامج (SDK) للسائقين على أجهزة Android
  • تُعرف أيضًا باسم: حزمة تطوير البرامج (SDK) للسائق، وحزمة تطوير البرامج (SDK) للسائق للرحلات عند الطلب، وحزمة تطوير البرامج (SDK) للسائق للمهام المُجدوَلة
  • الفئة: المسارات
  • النظام الأساسي: Android
  • يعمل على: العميل (رمز التطبيق أو المتصفّح)
  • مرحلة الإطلاق: GA
  • Lifecycle: نشط
  • نظرة عامة: نظرة عامة على حزمة تطوير البرامج (SDK) للسائقين لنظام التشغيل Android

حزمة تطوير البرامج (SDK) للسائقين على أجهزة Android: حالات الاستخدام

استخدِم حزمة تطوير البرامج (SDK) للسائقين على أجهزة Android في الحالات التالية:

  • يجب أن يرسل تطبيق السائق على Android الموقع الجغرافي للمركبة في الوقت الفعلي وتعديلات المسار إلى Fleet Engine.
  • تحتاج إلى Fleet Engine لتلقّي المسافة المتبقية والوقت المقدّر للوصول إلى النقطة التالية على المسار من حزمة تطوير البرامج (SDK) للتنقّل.
  • تحتاج إلى تطبيق واحد للسائقين يدير الرحلات المخصّصة عند الطلب أو المهام المُجدوَلة ويوفّر ميزة التنقّل.

لا تستخدِم حزمة Driver SDK لنظام التشغيل Android في الحالات التالية:

حزمة تطوير البرامج (SDK) للسائقين على أجهزة Android: الإعداد

حِزم Driver SDK الرسمية لنظام التشغيل Android:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven: com.google.android.libraries.navigation:navigation

حزمة تطوير البرامج (SDK) للسائقين على أجهزة Android: الأخطاء الشائعة

  • المشكلة: إذا لم تحدّد تبعيات الإصدار إصدارًا من حزمة SDK للسائق، تحمّل بيئة التطوير المتكاملة (IDE) أحدث إصدار. اعتبارًا من الإصدار 7.0.0، لن تتيح الإصدارات الجديدة الإصدارَين 6 و7 من Android (المستويات 23 إلى 25 من واجهة برمجة التطبيقات). الحلّ: حدِّد إصدارًا صريحًا من Driver SDK لنظام التشغيل Android في تبعيات الإصدار للتحكّم في وقت تغيير الحدّ الأدنى لإصدار نظام التشغيل المتوافق. يُرجى الاطّلاع على /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
  • المشكلة: تعتمد حزمة تطوير البرامج (SDK) الخاصة بالسائق على حزمة تطوير البرامج (SDK) الخاصة بالتنقّل. وبدون تثبيت إصدار حزمة تطوير البرامج (SDK) الخاصة بالتنقّل، ينزّل المشروع دائمًا أحدث إصدار من حزمة تطوير البرامج (SDK) الخاصة بالتنقّل ضمن رقم الإصدار الرئيسي. الحلّ: أضِف تبعيات كلّ من حزمة تطوير البرامج (SDK) للسائق وحزمة تطوير البرامج (SDK) للتنقّل. إذا ثبّتّ إصدار Navigation SDK، اختَر إصدارًا ضمن النطاق الذي تدرجه ملاحظات الإصدار لإصدار Driver SDK (على سبيل المثال، [7.0, 8.0) لإصدار Driver SDK 7.1). يُرجى الاطّلاع على /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
  • المشكلة: تطلب حزمة SDK رموز التفويض من خلال AuthTokenFactory في وقت تعديل الموقع الجغرافي. وإذا لم يتمكّن الخادم من إصدار رموز JWT، لا يمكن تفويض التعديلات على Fleet Engine. الحلّ: تأكَّد من أنّ عملية التنفيذ من جهة الخادم يمكنها إصدار الرموز المميّزة قبل إعداد حزمة تطوير البرامج (SDK)، وأعِد استخدام الرموز المميّزة إلى أن تنتهي صلاحيتها. يُرجى الاطّلاع على /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate.
  • المشكلة: يمكن أن تؤدي إصدارات ProGuard إلى ظهور تحذيرات بشأن فئات com.google وio.grpc وokio. الحلّ: أضِف -dontwarn com.google.** و-dontwarn io.grpc.** و-dontwarn okio.** إلى إعدادات ProGuard. يُرجى الاطّلاع على /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.

حزمة تطوير البرامج (SDK) للسائقين على أجهزة Android: الميزات القديمة والمتوقّفة نهائيًا

  • واجهة StatusListener: تم إيقافها نهائيًا منذ ‎25-11-2024. الاستبدال: DriverStatusListener. المشكلة: تمت إزالة هذه الميزة في الإصدار 6.0.0 من حزمة تطوير البرامج (SDK) للسائقين على Android. يُرجى الاطّلاع على دليل نقل البيانات.
  • الإصدار 1.x من حزمة تطوير البرامج (SDK) للتنقّل/للسائقين لنظام التشغيل Android (ملف ثنائي مجمّع): تم إيقافه نهائيًا منذ ‎21-06-2022. البديل: ملفات ثنائية منفصلة للإصدار 3 من حزمة تطوير البرامج (SDK) للسائقين والإصدارات الأحدث وحزمة تطوير البرامج (SDK) للتنقّل. المشكلة: تم إيقافها نهائيًا في 21 يونيو 2021 ولم تتم صيانتها بعد 21 يونيو 2022، وتمت إزالة طرق مثل Waypoint#fromLatLng وNavigator#startGuidance(resumeIntent) في الإصدار 3.0. يُرجى الاطّلاع على دليل نقل البيانات.
  • AuthTokenContext ServiceType: تم إيقافها نهائيًا منذ ‎29-11-2021. الاستبدال: المطالبات بمعرّف المركبة ومعرّف المهمة المضمّنَين. المشكلة: تمت إزالة ServiceType وgetServiceType() من AuthTokenContext وsetServiceType من AuthTokenContext.Builder في الإصدار 4.0.0. يُرجى الاطّلاع على دليل نقل البيانات.
  • السمة Task parentId: متوقّفة نهائيًا منذ ‎28-04-2022. الاستبدال: trackingId. العَرَض: تمت إعادة تسمية السمة في الإصدار 4.1.0، ولا تزال السمة القديمة متوفّرة ولكن تم إيقافها نهائيًا.

الإجراءات التي يمكنك تنفيذها باستخدام حزمة تطوير البرامج (SDK) للسائقين على Android

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