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

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

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

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

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

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

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

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

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

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

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

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

  • المشكلة: إذا لم يتم ضبط تبعية حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" على إصدار صريح، تستخدم حزمة تطوير البرامج للمستهلك الحد الأدنى المطلوب من إصدار حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google"، ما قد يؤدي إلى تعطُّل التطبيقات التي تعتمد على الميزات في الإصدارات الأحدث من حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google". الحلّ: يجب تحديد إصدار play-services-maps بشكل صريح إلى جانب transportation-consumer في Gradle أو Maven. يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project.
  • المشكلة: يؤدي عدم إيقاف مشاركة الرحلة بعد انتهائها إلى إرسال طلبات شبكة غير ضرورية إلى Fleet Engine وتسرُّب الذاكرة. الحلّ: يمكنك استدعاء JourneySharingSession.stop() عندما لا تكون الرحلة مطلوبة، على سبيل المثال في onDestroy() أو عندما تكون الرحلة COMPLETE. يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey.
  • المشكلة: يعرض ConsumerApi.initialize() استثناءً إذا كان مثيل واجهة برمجة التطبيقات متوفّرًا (الإصدار 2.0.0 والإصدارات الأحدث). الحلّ: يجب استدعاء ConsumerApi.getInstance() أولاً والتحقّق من Task الذي تم عرضه لتحديد ما إذا كان هناك مثيل حالي. يُرجى الاطّلاع على /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android.
  • المشكلة: لا يتوافق الإصدار 3 من حزمة SDK للمستهلك والإصدارات الأقدم مع وضع R8 الكامل، وقد تواجه التطبيقات التي تستهدف الإصدار 8.0 من AGP أو الإصدارات الأحدث مشاكل في الإنشاء أو وقت التشغيل. الحلّ: اضبط android.enableR8.fullMode=false عند استهداف الإصدار 8.0 من AGP أو الإصدارات الأحدث، واستخدِم الإصدار 7.3 من AGP أو الإصدارات الأحدث مع الإصدار 2.0 من Kotlin للإصدار 3.0 من حزمة تطوير البرامج (SDK) للمستهلك أو الإصدارات الأحدث. يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.

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

  • ‫ConsumerTrip وConsumerTripCallback وConsumerTripManager وConsumerTripOptions: تم إيقافها نهائيًا منذ ‎15/09/2023. البديل: TripModel وTripModelCallback وTripModelManager وTripModelOptions يُرجى الاطّلاع على دليل نقل البيانات.
  • فئة Trip والتعليقات التوضيحية Trip.TripStatus / Trip.TripType (وTripInfo#getTripStatus() وTripInfo#getTripType() وTripModelCallback#onTripStatusUpdated): تم إيقافها نهائيًا منذ ‎15/09/2023. الاستبدال: TripInfo.TripStatus / TripInfo.TripType، TripInfo#getCurrentTripStatus()، TripInfo#getCurrentTripType()، TripModelCallback#onTripStatusUpdate. يُرجى الاطّلاع على دليل نقل البيانات.
  • ‫MarkerStyleOptions وPolylineStyleOptions: تم إيقاف تشغيلهما منذ ‎30-11-2021. البديل: MarkerOptions وPolylineOptions (تتم مشاركتهما مع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google"). المشكلة: تطبّق حزمة تطوير البرامج (SDK) للمستهلك النمط التلقائي الخاص بها لكل نوع علامة أو خط متعدّد، وليس الإعدادات التلقائية في MarkerOptions. يُرجى الاطّلاع على دليل نقل البيانات.
  • قناة توزيع المستودع الخاص: متوقفة نهائيًا. البديل: مستودع Maven من Google (الإصدار 2.1.0 والإصدارات الأحدث) يُرجى الاطّلاع على دليل نقل البيانات.

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

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