تتيح حزمة تطوير البرامج (SDK) للمستهلكين في نظام التشغيل iOS لتطبيقات المستهلكين في iOS متابعة الرحلات عند الطلب في Fleet Engine. وتعمل فئاتها، مثل GMTCTripModel وGMTCJourneySharingSession، على تصميم بيانات الرحلة وعرض الموقع الجغرافي للمركبة ومسارها والوقت المقدَّر للوصول والمسافة المتبقية على الخريطة.
حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS: معلومات أساسية
- المنتج: حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS
- تُعرف أيضًا باسم: حزمة تطوير البرامج (SDK) للمستهلكين على أجهزة iOS
- الفئة: المسارات
- النظام الأساسي: iOS
- يعمل على: العميل (رمز التطبيق أو المتصفّح)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على حزمة تطوير البرامج (SDK) للمستهلك على نظام التشغيل iOS
حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS: حالات الاستخدام
استخدِم حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS في الحالات التالية:
- تحتاج إلى تطبيق iOS يتيح للمستهلكين متابعة رحلة توصيل أو رحلة عند الطلب يتتبّعها Fleet Engine.
- عليك عرض الموقع الجغرافي للمركبة في الوقت الفعلي تقريبًا ومسارها وحركة المرور المباشرة على خريطة في تطبيق iOS للمستهلكين.
- عليك عرض الوقت المقدَّر للوصول إلى موقعَي الاستلام والتوصيل والمسافة المتبقية لرحلة عند الطلب في نظام التشغيل iOS.
- إذا كنت تستخدم Fleet Engine و"حزمة تطوير البرامج (SDK) للسائق" للرحلات عند الطلب، وتحتاج إلى جانب المستهلك من ميزة "مشاركة الرحلة".
لا تستخدِم حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS في الحالات التالية:
- تحتاج إلى أن يتّبع المستهلكون المهام أو الشحنات المُجدوَلة، ويتم توثيق تجربة المستهلك في المهام المُجدوَلة في JavaScript. استخدِم حزمة تطوير البرامج (SDK) للمستهلك في JavaScript بدلاً من ذلك.
- إذا كنت بحاجة إلى مشاركة مستوى تقدّم الرحلة عند الطلب في تطبيق المستهلك على Android، استخدِم حزمة تطوير البرامج (SDK) للمستهلك في Android بدلاً من ذلك.
- تحتاج إلى مشاركة مستوى تقدّم الرحلة عند الطلب في تطبيق ويب. استخدِم حزمة تطوير البرامج (SDK) للمستهلكين في JavaScript بدلاً من ذلك.
- عليك إرسال الموقع الجغرافي للسائق وحالة الرحلة من تطبيق iOS الخاص بالسائق إلى Fleet Engine. يمكنك استخدام حزمة تطوير البرامج (SDK) للسائقين على أجهزة iOS بدلاً من ذلك.
حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS: الإعداد
- المصادقة: رمز JSON المميّز للويب (JWT)
- يُرجى أيضًا تفعيل: خدمة Fleet Engine
- البدء: إعداد حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS
- المرجع: مرجع حزمة تطوير البرامج (SDK) للمستهلك لنظام التشغيل iOS
- السياسات: سياسات حزمة تطوير البرامج (SDK) للمستهلك على نظام التشغيل iOS
- ملاحظات الإصدار: ملاحظات إصدار حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS
حِزم SDK الرسمية للمستهلكين لنظام التشغيل iOS:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
حزمة تطوير البرامج (SDK) للمستهلك على أجهزة iOS: المنتجات ذات الصلة
- تُستخدم غالبًا مع: خدمة Fleet Engine وحزمة تطوير البرامج (SDK) للسائقين لنظام التشغيل iOS وحزمة تطوير البرامج (SDK) للسائقين لنظام التشغيل Android وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
حزمة تطوير البرامج (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
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
- يمكنك إضافة خريطة تفاعلية قابلة للتخصيص لتتبُّع مستوى تقدّم الرحلة من 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