تضيف حزمة تطوير البرامج للتنقّل على أجهزة iOS ميزة الاتجاهات المفصّلة في "خرائط Google" إلى تطبيقات iOS، مع إمكانية تخصيص واجهة المستخدم وضبط المسار. وتعمل هذه الحزمة على توسيع نطاق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS، والتي توفّر طبقة الخريطة ويجب تثبيتها أيضًا في التطبيق.
حزمة تطوير البرامج للتنقّل على أجهزة iOS: معلومات أساسية
- المنتج: حزمة تطوير البرامج للتنقّل على أجهزة iOS
- تُعرف أيضًا باسم: حزمة تطوير البرامج (SDK) للتنقّل
- الفئة: المسارات
- النظام الأساسي: iOS
- يعمل على: العميل (رمز التطبيق أو المتصفّح)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على حزمة تطوير البرامج للتنقّل على أجهزة iOS
- نطاق التوفّر الجغرافي: محدود تتوفّر اتجاهات القيادة والمشي في معظم البلدان، بينما تختلف معلومات حركة المرور والاضطرابات في الوقت الفعلي والدراجات النارية وركوب الدراجات والحدود القصوى للسرعة وإشارات المرور وعلامات التوقف حسب البلد. (تفاصيل التغطية)
حزمة تطوير البرامج للتنقّل على أجهزة iOS: حالات الاستخدام
استخدِم حزمة تطوير البرامج للتنقّل على أجهزة iOS في الحالات التالية:
- تحتاج إلى الاتجاهات المفصّلة في "خرائط Google" داخل تطبيق iOS الأصلي لكي لا يبدّل المستخدمون التطبيقات.
- عليك تخصيص واجهة مستخدم التنقّل أو أنماط الخرائط أو الكاميرا أو التنسيق لتتطابق مع علامتك التجارية أثناء الإرشاد.
- تحتاج إلى إعدادات مفضّلة للمسار أو نقاط متعددة على المسار أو رمز مميّز للمسار من Routes API أو Route Optimization API.
- تحتاج إلى أحداث الرحلات (الموقع الجغرافي والوصول وتغييرات المسار والوقت المقدَّر للوصول) أو خلاصة بيانات الاتّجاهات المفصّلة لواجهة مستخدم مخصّصة للإرشاد أو CarPlay.
لا تستخدِم حزمة تطوير البرامج للتنقّل على أجهزة iOS في الحالات التالية:
- إذا كنت بصدد إنشاء تطبيق Android، استخدِم حزمة تطوير البرامج للتنقّل على أجهزة Android بدلاً من ذلك.
- إذا كنت بصدد إنشاء تطبيق Flutter أو React Native، استخدِم Google Navigation for Flutter and React Native بدلاً من ذلك.
- إذا كنت بحاجة فقط إلى المسارات أو الأوقات المقدّرة للوصول أو المسافات على خادم، بدون إرشادات داخل التطبيق. استخدِم Routes API بدلاً من ذلك.
حزمة تطوير البرامج للتنقّل على أجهزة iOS: الإعداد
- الخدمة المطلوب تفعيلها:
navigationsdk.googleapis.com - المصادقة: مفتاح واجهة برمجة التطبيقات
- يُرجى أيضًا تفعيل: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
- تحديد مصدر الاستخدام: يمكنك استدعاء
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) لإضافة معرّف تحديد مصدر الاستخدام إلى أداة الإعداد. لإيقاف الميزة، احذف الطلب أو أدخِل سلسلة فارغة. - البدء: إعداد حزمة تطوير البرامج للتنقّل على أجهزة iOS
- المرجع: مرجع حزمة تطوير البرامج للتنقّل على أجهزة iOS
- الأسعار: استخدام حزمة تطوير البرامج للتنقّل على أجهزة iOS والفوترة
- السياسات: سياسات حزمة تطوير البرامج للتنقّل على أجهزة iOS
- ملاحظات الإصدار: ملاحظات إصدار حزمة تطوير البرامج (SDK) للتنقّل على أجهزة iOS
حِزم تطوير البرامج (SDK) الرسمية للتنقّل على أجهزة iOS:
- swift_package:
https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)
الحِزم التي يجب عدم استخدامها مع حزمة تطوير البرامج للتنقّل على أجهزة iOS:
- cocoapods:
GoogleNavigation. تم إيقاف توزيع CocoaPods نهائيًا اعتبارًا من الإصدار 11.0.0، ودخل في وضع الصيانة في 18 أغسطس 2025. استخدِم Swift Package Manager بدلاً من ذلك.
حزمة تطوير البرامج للتنقّل على أجهزة iOS: المنتجات ذات الصلة
- تُستخدم غالبًا مع: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS وRoutes API وRoute Optimization API وحزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" للتطبيقات المتوافقة مع iOS
حزمة تطوير البرامج للتنقّل على أجهزة iOS: الأخطاء الشائعة
- المشكلة: تصبح الشاشة معتمة أو يتم إيقافها أثناء التنقّل لأنّ حزمة تطوير البرامج (SDK) لا توقف مؤقّت عدم النشاط في نظام التشغيل iOS. الحلّ: اضبط السمة
UIApplication.shared.isIdleTimerDisabled = trueأثناء التنقّل. يُرجى الاطّلاع على /maps/documentation/navigation/ios-sdk/route. - المشكلة: سيستخدم الإصدار الرئيسي المستقبلي من حزمة SDK مقياس الارتفاع (
CMAltimeter)، وستتعطّل التطبيقات التي لا تتضمّنNSMotionUsageDescriptionفيInfo.plistعند الإعداد. ولن تؤثر إضافة المفتاح الآن في السلوك الحالي. الحلّ: أضِفNSMotionUsageDescription(Privacy - Motion Usage Description) إلىInfo.plist. يُرجى الاطّلاع على /maps/documentation/navigation/ios-sdk/route. - المشكلة: لا يتم تجميع حزمة تطوير برامج الأماكن لأجهزة iOS مع حزمة تطوير البرامج للتنقّل (بدءًا من الإصدار 5.0 من حزمة تطوير برامج الأماكن)، لذا فإنّ فئات الأماكن غير متوفّرة. الحلّ: ثبِّت حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" للتطبيقات المتوافقة مع iOS بشكل منفصل، باستخدام الإصدار نفسه من حزمة تطوير البرامج للتنقّل. يُرجى الاطّلاع على /maps/documentation/navigation/ios-sdk/xcode-setup.
- المشكلة: يتعذّر ضبط الوجهات باستخدام رمز مميّز للمسار مع ظهور الخطأ
.travelModeUnsupportedعندما لا يكونtravelModeفي التطبيق هوdrivingأوtwoWheeler. الحلّ: اضبط السمةmapView.travelModeعلى.drivingأو.twoWheeler. اطّلِع علىresolvedParameters.travelModeلمعرفة الوضع الذي يستخدمه المسار. يُرجى الاطّلاع على /maps/documentation/navigation/ios-sdk/route-customizations.
حزمة تطوير البرامج للتنقّل على أجهزة iOS: الميزات القديمة والتي تم إيقافها نهائيًا
- توزيع CocoaPods: تم إيقافه نهائيًا منذ 06-08-2026. البديل: Swift Package Manager. المشكلة: وضع الصيانة مفعَّل منذ 18 أغسطس 2025. لن نطرح إصدارات جديدة من CocoaPods بعد الربع الثاني من عام 2026. يُرجى الاطّلاع على دليل نقل البيانات.
GMSNavigatorsetDestinations:callback:,setDestinations:routingOptions:callback:,setDestinations:routeToken:callback:(GMSRouteStatusCallback): متوقّف نهائيًا منذ 02/11/2026. البديل:setDestinations:completionHandler:،setDestinations:routingOptions:completionHandler:،setDestinationsWithToken:completionHandler:(GMSNavigationRouteCompletionHandler).- سمة المثيل
GMSServicesappCheckTokenProvider: تم إيقافها نهائيًا منذ 24-09-2026. البديل: السمةGMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]) في الفئة. المشكلة: في الإصدار 11.1.0، تعذّر ضبط ميزة "فحص التطبيقات" من خلالGMSServices.sharedServices(). يُرجى الاطّلاع على دليل نقل البيانات. GMSNavigatorcontinueToNextDestination: متوقّف نهائيًا منذ 07/04/2026. الاستبدال:GMSNavigatorcontinueToNextDestinationWithCompletion:.-
GMSUISettingsوshowsTrafficLightsوshowsStopSigns: تم إيقافها نهائيًا اعتبارًا من 2026-08-06. البديل: لا حاجة إلى بديل، إذ تظهر إشارات المرور وعلامات التوقف تلقائيًا أثناء التنقّل. - نوع الخريطة
.terrainأثناء التنقّل النشط: تم إيقافها نهائيًا في 06/08/2026. البديل:.normal(kGMSTypeNormal) أو.satelliteأو نوع الخريطة.hybrid - بروتوكولا
GMSNavigatorDelegateوGMSRoadSnappedLocationProviderDelegate: تم إيقافهما نهائيًا منذ 2021-05-13. البديل:GMSNavigatorListenerوGMSRoadSnappedLocationProviderListener(يُرجى الإضافة باستخدام-addListener:وضبطtimeUpdateThresholdوdistanceUpdateThresholdعلىGMSNavigator). يُرجى الاطّلاع على دليل نقل البيانات.
ما يمكنك فعله باستخدام حزمة تطوير البرامج للتنقّل على أجهزة iOS
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
حزمة تطوير البرامج للتنقّل على أجهزة iOS: أنماط الخرائط
حزمة تطوير البرامج للتنقّل على أجهزة iOS: التنقّل
- إضافة اتجاهات مفصّلة تفاعلية إلى تطبيق على الأجهزة الجوّالة
- اضبط الوجهة للحصول على الاتجاهات المفصّلة.
- ابدأ التنقّل للحصول على اتجاهات مفصّلة.
- تحديد وضع السفر (القيادة أو المشي أو الدراجة النارية أو سيارة الأجرة) لطلب مسار
- تعديل الإعدادات المفضّلة للمسارات في الاتجاهات المفصّلة
- تحديد جانب الطريق والإعدادات المفضّلة الأخرى للوصول في الاتجاهات المفصّلة
- تحديد مسار مُعاد تخطيطه للاتجاهات المفصّلة باستخدام رمز مميّز للمسار قابل لإعادة الاستخدام
- يمكنك الحصول على آخر المعلومات عن وصول المستخدم من جلسة اتجاهات مفصّلة.
- يمكنك عرض آخر المواقع الجغرافية للمستخدم من جلسة اتجاهات مفصّلة.
- يمكنك الحصول على معلومات محدّثة عن الوقت والمسافة من جلسة اتجاهات مفصّلة.
- تلقّي تعديلات على تغيير المسار من جلسة اتجاهات مفصّلة
- عرض تعديلات الوضع الليلي من جلسة اتجاهات مفصّلة
- عرض تعديلات سرعة المستخدم من جلسة اتجاهات مفصّلة
- يمكنك تخصيص عناصر واجهة المستخدم وعناصر التحكّم التي تظهر أثناء استخدام الاتجاهات المفصّلة.
- إضافة عنصر جديد في واجهة المستخدم إلى الاتجاهات المفصّلة
- إضافة مؤشر تقدّم الرحلة إلى الاتجاهات المفصّلة
- تخصيص ميزات الخريطة التي تظهر أثناء استخدام الاتجاهات المفصّلة
- إضافة طبقة حركة المرور إلى الاتجاهات المفصّلة
- تعديل عرض الكاميرا وسلوكها في الاتجاهات المفصّلة
- تخصيص عدّاد السرعة وتنبيهات حدود السرعة للاتجاهات المفصّلة
- عرض خلاصة الاتجاهات المفصّلة كسلسلة من الرسائل لكل مناورة على طول المسار
- تحديد رموز مخصّصة للمناورات لاستخدامها مع خلاصة الاتجاهات المفصّلة
- يمكنك إضافة اتجاهات مفصّلة تفاعلية في CarPlay إلى تطبيق iOS. نسخة حصرية
- تنبيه المستخدمين بشأن الاضطرابات على طول مسارهم:
- السماح للمستخدمين بالاطّلاع على العوائق على طول مسارهم قبل بدء التنقّل
- السماح للمستخدمين بالإبلاغ عن أي عوائق على مسارهم
- السماح للمستخدمين بالتحقّق من العوائق على طول مسارهم
- أضِف زرًا مخصّصًا للإبلاغ عن انقطاع المسار.