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

تتيح حزمة تطوير البرامج (SDK) للمستهلكين في نظام التشغيل iOS لتطبيقات المستهلكين في iOS متابعة الرحلات عند الطلب في Fleet Engine. وتعمل فئاتها، مثل GMTCTripModel وGMTCJourneySharingSession، على تصميم بيانات الرحلة وعرض الموقع الجغرافي للمركبة ومسارها والوقت المقدَّر للوصول والمسافة المتبقية على الخريطة.

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

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

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

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

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

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

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

  • cocoapods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

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

  • المشكلة: يتعذّر تتبُّع الرحلة ويظهر الخطأ 401 UNAUTHENTICATED عندما يتم توقيع رمز JWT بدون معرّف رحلة أو عندما تنتهي صلاحيته. الحلّ: اطلب من موفّر الرمز المميّز (GMTCAuthorization) عرض رمز JWT تم إصداره لمعرّف الرحلة في سياق التفويض، وتخزينه مؤقتًا لكل رحلة، وتجديده عند انتهاء صلاحيته. يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk.
  • المشكلة: يتعذّر تتبُّع الرحلة مع ظهور الخطأ 400 INVALID_ARGUMENT عندما لا يستخدم اسم الرحلة التنسيق providers/{provider_id}/trips/{trip_id}. الحلّ: استخدِم رقم تعريف مشروع على السحابة الإلكترونية على Google Cloud كـ provider_id، وأدخِل رقم تعريف المشروع نفسه كـ providerID عند إعداد حزمة تطوير البرامج (SDK). يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk.
  • المشكلة: يستمر التطبيق في الاستماع إلى التحديثات بعد اكتمال الرحلة أو إلغائها. الحلّ: يمكنك استدعاء unregisterSubscriber في نموذج الرحلة عند اكتمال الرحلة أو إلغائها. يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey.
  • المشكلة: عند تثبيت XCFramework يدويًا، يتم حذف حِزم الموارد وإعدادات الإصدار المطلوبة ما لم تتم إضافتها في Xcode. الحلّ: استخدِم CocoaPods حيثما أمكن. بالنسبة إلى عمليات التثبيت اليدوية، أضِف gRPCCertificates.bundle وGoogleRidesharingConsumer.bundle إلى المشروع، واربط أُطر العمل المدرَجة، وأضِف -ObjC إلى "علامات الربط الأخرى" (Other Linker Flags) لتصحيح الأخطاء والإصدار. يُرجى الاطّلاع على /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.

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

  • أداة الإعداد GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:: متوقّفة نهائيًا منذ ‎01-06-2025. الاستبدال: استبدال GMTSVehicleLocation -initWithOptions: بـ GMTSVehicleLocationOptions.
  • [GMTCMapView initWithCoder]: تم إيقافها نهائيًا منذ ‎2023-12-01. الاستبدال: GMTCMapView -initWithOptions:.

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

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