تُعدّ حزمة تطوير البرامج (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 في الحالات التالية:
- تحتاج إلى ميزة مشاركة الرحلة للرحلات عند الطلب في تطبيق iOS. استخدِم حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS بدلاً من ذلك.
- تحتاج إلى مشاركة الرحلة في صفحة ويب أو تتبُّع المستهلك للمهام المُجدوَلة، مثل الشحنات. استخدِم حزمة تطوير البرامج (SDK) للمستهلك في JavaScript بدلاً من ذلك.
- عليك إبلاغ الموقع الجغرافي للسائق ومستوى تقدّم الرحلة من تطبيق Android الخاص بالسائق. استخدِم حزمة تطوير البرامج (SDK) للسائق على Android بدلاً من ذلك.
حزمة تطوير البرامج (SDK) للمستهلك على أجهزة Android: الإعداد
- المصادقة: رمز JSON المميّز للويب (JWT)، ومفتاح واجهة برمجة التطبيقات
- يجب أيضًا تفعيل: خدمة Fleet Engine وحزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android
- البدء: إعداد حزمة تطوير البرامج (SDK) للمستهلك على Android
- المرجع: مرجع حزمة تطوير البرامج (SDK) للمستهلك على Android
- السياسات: سياسات حزمة تطوير البرامج (SDK) للمستهلك على Android
- ملاحظات الإصدار: ملاحظات إصدار حزمة تطوير البرامج (SDK) للمستهلك على Android
حِزم SDK الرسمية للمستهلكين في نظام التشغيل Android:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
حزمة تطوير البرامج (SDK) للمستهلك على أجهزة Android: المنتجات ذات الصلة
- غالبًا ما تُستخدَم مع: خدمة Fleet Engine وحزمة تطوير البرامج (SDK) للسائقين على Android وحزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android
حزمة تطوير البرامج (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
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
- يمكنك إضافة خريطة تفاعلية قابلة للتخصيص لتتبُّع مستوى تقدّم الرحلة من Fleet Engine إلى تطبيق على الأجهزة الجوّالة.
- أضِف خطوطًا متعدّدة للمسار لتتبُّع رحلة من Fleet Engine إلى خريطة على صفحة ويب أو تطبيق للأجهزة الجوّالة.
- تعديل مستوى تقدّم الرحلة على طول مسار في خريطة على صفحة ويب أو تطبيق للأجهزة الجوّالة لرحلة في Fleet Engine
- تغيير نمط الطرق والخطوط المتعدّدة والمضلّعات على خريطة تتتبّع تقدّم رحلة من Fleet Engine
- عرض عناصر الخريطة أو إخفاؤها على خريطة تتتبّع تقدّم رحلة من Fleet Engine
- تغيير نمط الرموز والنصوص على خريطة تتتبّع مستوى تقدّم رحلة من Fleet Engine
- تطبيق أنماط خرائط مختلفة على مستويات تكبير مختلفة على خريطة تتتبّع مستوى تقدّم رحلة من Fleet Engine
- تغيير كثافة الأماكن على خريطة تتتبّع تقدّم رحلة من Fleet Engine ميزة تجريبية ملاحظة: تتوفّر ميزة "تصميم الخرائط باستخدام السحابة الإلكترونية" في حزمة تطوير البرامج (SDK) للمستهلكين بشكل عام، في حين أنّ ميزة "التحكّم في كثافة نقاط الاهتمام" هي ميزة تجريبية من ميزات "تصميم الخرائط باستخدام السحابة الإلكترونية" (تتوفّر في أنماط الخرائط البسيطة فقط).
- تغيير نمط المباني على خريطة تتتبّع مستوى تقدّم رحلة من Fleet Engine تجريبي ملاحظة: يتوفّر دعم "تصميم الخرائط باستخدام السحابة الإلكترونية" في حزمة تطوير البرامج (SDK) للمستهلك بشكل متوفّر للجمهور العام، في حين أنّ تخصيص نمط المباني الثلاثية الأبعاد ومساحة المباني هو ميزة تجريبية من ميزات "تصميم الخرائط باستخدام السحابة الإلكترونية" (يتوفّر في أنماط الخرائط الفاتحة فقط).
- تغيير نمط المعالم على خريطة تتتبّع مستوى تقدّم رحلة من Fleet Engine ميزة تجريبية ملاحظة: تتوفّر ميزة "تصميم الخرائط باستخدام السحابة الإلكترونية" في حزمة تطوير البرامج (SDK) للمستهلكين بشكل عام، في حين أنّ ميزة تخصيص رمز المَعلم هي ميزة تجريبية في "تصميم الخرائط باستخدام السحابة الإلكترونية" (تتوفّر في أنماط الخرائط الفاتحة فقط).
- تخصيص علامة على خريطة تتتبّع تقدّم رحلة من Fleet Engine
- تخصيص الخطوط المتعدّدة للمسار على خريطة تتتبّع تقدّم رحلة من Fleet Engine