مرجع سريع لحزمة تطوير البرامج (SDK) الخاصة بالسائق لنظام التشغيل iOS

حزمة تطوير البرامج (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 في الحالات التالية:

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

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

  • cocoapods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

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

  • المشكلة: قد يتعذّر تعديل المركبة لأول مرة بعد بدء التشغيل مع ظهور رسالة الخطأ "update_mask cannot be empty" (لا يمكن أن تكون update_mask فارغة) عندما تكون المَعلمة updateMask فارغة. الحلّ: يجب دائمًا تقديم اسم حقل واحد على الأقل في updateMask، ومعالجة هذا الخطأ في GMTDVehicleReporterListener didFailVehicleUpdate. يُرجى الاطّلاع على /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. الاستبدال: GMTDAuthorization fetchTokenWithContext:completion: بـ GMTDAuthorizationContext (المطالبات المتعلّقة برقم تعريف المركبة فقط) يُرجى الاطّلاع على دليل نقل البيانات.

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

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