حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS هي مجموعة أدوات للتطبيقات على الأجهزة الجوّالة ومكوّن من Fleet Engine. وهي ترسل الموقع الجغرافي للمركبة والمسار ونقاط المسار والمسافة المتبقية والوقت المقدّر للوصول من حزمة تطوير البرامج (SDK) للتنقّل إلى Fleet Engine، وذلك للرحلات عند الطلب والمهام المُجدوَلة.
حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS: معلومات أساسية
- المنتج: حزمة تطوير البرامج (SDK) للسائق على أجهزة iOS
- تُعرف أيضًا باسم: حزمة تطوير البرامج (SDK) للسائق، وحزمة تطوير البرامج (SDK) للسائق للرحلات عند الطلب، وحزمة تطوير البرامج (SDK) للسائق للمهام المُجدوَلة
- الفئة: المسارات
- النظام الأساسي: iOS
- يعمل على: العميل (رمز التطبيق أو المتصفّح)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على حزمة تطوير البرامج (SDK) للسائقين لنظام التشغيل iOS
حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS: حالات الاستخدام
استخدِم حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS في الحالات التالية:
- تحتاج إلى تطبيق سائق على أجهزة iOS لإرسال تعديلات الموقع الجغرافي للمركبة في الوقت الفعلي إلى Fleet Engine.
- عليك إبلاغ Fleet Engine بالمسار والنقاط على المسار والمسافة المتبقية والوقت المقدّر للوصول من حزمة تطوير البرامج (SDK) للتنقّل.
- تحتاج إلى أن يدير السائقون الرحلات المخصّصة لهم عند الطلب وأن يتنقّلوا في تطبيق واحد بدون التبديل بين التطبيقات.
- أنت بصدد إنشاء تطبيق للسائقين لمهام Fleet Engine المُجدوَلة على أجهزة iOS.
لا تستخدِم حزمة تطوير البرامج (SDK) للسائق على أجهزة iOS في الحالات التالية:
- تحتاج فقط إلى اتجاهات مفصّلة في تطبيق iOS، بدون تتبُّع Fleet Engine. يمكنك استخدام حزمة تطوير البرامج للتنقّل على أجهزة iOS بدلاً من ذلك.
- تحتاج إلى عرض مستوى تقدّم الرحلة أو التسليم للراكب أو العميل في تطبيق المستهلك. استخدِم حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS بدلاً من ذلك.
- يجب إرسال تعديلات على بيانات المركبة بخلاف الموقع الجغرافي والمسار، ويتم إرسالها من خلال الخلفية إلى Fleet Engine. استخدِم خدمة Fleet Engine بدلاً من ذلك.
- يعمل تطبيق السائق على Android. يمكنك استخدام حزمة تطوير البرامج (SDK) للسائقين على Android بدلاً من ذلك.
حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS: الإعداد
- المصادقة: مفتاح واجهة برمجة التطبيقات، رمز JSON المميّز للويب (JWT)
- يُرجى أيضًا تفعيل: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
- البدء: إعداد حزمة تطوير البرامج (SDK) للسائق على أجهزة iOS
- المرجع: مرجع حزمة تطوير البرامج (SDK) للسائقين على نظام التشغيل iOS
- السياسات: سياسات حزمة تطوير البرامج (SDK) للسائقين على نظام التشغيل iOS
- ملاحظات الإصدار: ملاحظات إصدار حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS
حِزم Driver SDK الرسمية لنظام التشغيل iOS:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS: المنتجات ذات الصلة
- تُستخدم غالبًا مع: حزمة تطوير البرامج (SDK) للتنقّل لنظام التشغيل iOS وخدمة Fleet Engine وحزمة تطوير البرامج (SDK) للمستهلك لنظام التشغيل iOS
حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS: الأخطاء الشائعة
- المشكلة: قد يتعذّر تعديل المركبة لأول مرة بعد بدء التشغيل مع ظهور رسالة الخطأ "update_mask cannot be empty" (لا يمكن أن تكون update_mask فارغة) عندما تكون المَعلمة
updateMaskفارغة. الحلّ: يجب دائمًا تقديم اسم حقل واحد على الأقل فيupdateMask، ومعالجة هذا الخطأ فيGMTDVehicleReporterListenerdidFailVehicleUpdate. يُرجى الاطّلاع على /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot. - المشكلة: لا يواصل
GMSRoadSnappedLocationProviderإرسال تحديثات الموقع الجغرافي عندما لا يتحرّك الجهاز منذ آخر تحديث، على سبيل المثال عندما ينتظر السائق في وضع عدم النشاط. الحلّ: لإرسال إشعار جديد بشأن الموقع الجغرافي عندما يكون الجهاز ثابتًا، يجب إيقافGMSRoadSnappedLocationProviderثم تشغيله (بعد إضافةGMTDVehicleReporterكمستمع). يُرجى الاطّلاع على /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready. - المشكلة: لا يعرض تطبيق المستهلك الرحلة بشكل صحيح إذا كانت الإحداثيات التي تم تمريرها إلى
setDestinations()لا تتطابق مع نقطة المسار الخاصة بالرحلة. الحلّ: تأكَّد من أنّ خطوط العرض/الطول التي تم تمريرها إلىsetDestinations()تتطابق مع إحداثيات نقاط المسار في Fleet Engine. يُرجى الاطّلاع على /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details. - المشكلة: يمكن أن يؤدي استخدام عامل تشغيل إصدار متفائل (
~>) إلى عمليات إنشاء غير متوقعة وغير قابلة للتكرار، كما يؤدي حذف إصدار إلى تحميل أحدث حزمة تطوير برامج (SDK)، والتي يمكن أن تتضمّن تغييرات قد تؤدي إلى عطل أو رفع الحد الأدنى لإصدار iOS. لا يمكن استخدام Carthage. الحلّ: ثبِّت إصدارًا محدّدًا من Driver SDK في CocoaPods أو Swift Package Manager، واطّلِع على ملاحظات الإصدار قبل الترقية. يُرجى الاطّلاع على /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.
حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS: الميزات القديمة والمتوقّفة نهائيًا
- فئة
GMTSVehicleMatch: متوقّفة نهائيًا. البديل: لا حاجة إلى بديل في حزمة Driver SDK (تتم معالجة مطابقة المركبات في Fleet Engine). المشكلة: تم إيقاف هذه الميزة نهائيًا في الإصدار 2.2.0 من حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS، وتم حذفها من مرجع حزمة تطوير البرامج (SDK) للسائقين الحالي. يُرجى الاطّلاع على دليل نقل البيانات. -
GMTSServiceTypeوfetchAuthTokenForServiceType:authorizationContext:completion:: تم إيقافهما نهائيًا منذ 29 تشرين الثاني (نوفمبر) 2021. الاستبدال:GMTDAuthorizationfetchTokenWithContext:completion:بـGMTDAuthorizationContext(المطالبات المتعلّقة برقم تعريف المركبة فقط) يُرجى الاطّلاع على دليل نقل البيانات.
الإجراءات التي يمكنك تنفيذها باستخدام حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
- الإبلاغ عن الموقع الجغرافي للمركبة في الوقت الفعلي إلى خدمة Fleet Engine
- أبلِغ عن إحداثيات خطوط العرض/الطول للنقاط على مسار رحلة المركبة من حزمة تطوير البرامج (SDK) الخاصة بالتنقّل إلى خدمة Fleet Engine.
- إبلاغ خدمة Fleet Engine بالمسافة المتبقية للمركبة للوصول إلى نقطة على المسار التالية.
- يمكنك إبلاغ خدمة Fleet Engine بالوقت المقدّر لوصول المركبة إلى نقطة المسار التالية.
- إبلاغ خدمة Fleet Engine بالمسار الذي توفّره حزمة تطوير البرامج للتنقّل لمركبة معيّنة