المرجع السريع لـ Navigation SDK لنظام التشغيل iOS

تضيف حزمة تطوير البرامج للتنقّل على أجهزة iOS ميزة الاتجاهات المفصّلة في "خرائط Google" إلى تطبيقات iOS، مع إمكانية تخصيص واجهة المستخدم وضبط المسار. وتعمل هذه الحزمة على توسيع نطاق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS، والتي توفّر طبقة الخريطة ويجب تثبيتها أيضًا في التطبيق.

حزمة تطوير البرامج للتنقّل على أجهزة iOS: معلومات أساسية

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

حزمة تطوير البرامج للتنقّل على أجهزة iOS: حالات الاستخدام

استخدِم حزمة تطوير البرامج للتنقّل على أجهزة iOS في الحالات التالية:

  • تحتاج إلى الاتجاهات المفصّلة في "خرائط Google" داخل تطبيق iOS الأصلي لكي لا يبدّل المستخدمون التطبيقات.
  • عليك تخصيص واجهة مستخدم التنقّل أو أنماط الخرائط أو الكاميرا أو التنسيق لتتطابق مع علامتك التجارية أثناء الإرشاد.
  • تحتاج إلى إعدادات مفضّلة للمسار أو نقاط متعددة على المسار أو رمز مميّز للمسار من Routes API أو Route Optimization API.
  • تحتاج إلى أحداث الرحلات (الموقع الجغرافي والوصول وتغييرات المسار والوقت المقدَّر للوصول) أو خلاصة بيانات الاتّجاهات المفصّلة لواجهة مستخدم مخصّصة للإرشاد أو CarPlay.

لا تستخدِم حزمة تطوير البرامج للتنقّل على أجهزة iOS في الحالات التالية:

حزمة تطوير البرامج للتنقّل على أجهزة 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: الأخطاء الشائعة

  • المشكلة: تصبح الشاشة معتمة أو يتم إيقافها أثناء التنقّل لأنّ حزمة تطوير البرامج (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. يُرجى الاطّلاع على دليل نقل البيانات.
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback: (GMSRouteStatusCallback): متوقّف نهائيًا منذ ‎02/11/2026. البديل: setDestinations:completionHandler:، setDestinations:routingOptions:completionHandler:، setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • سمة المثيل GMSServices appCheckTokenProvider: تم إيقافها نهائيًا منذ ‎24-09-2026. البديل: السمة GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]) في الفئة. المشكلة: في الإصدار 11.1.0، تعذّر ضبط ميزة "فحص التطبيقات" من خلال GMSServices.sharedServices(). يُرجى الاطّلاع على دليل نقل البيانات.
  • GMSNavigator continueToNextDestination: متوقّف نهائيًا منذ ‎07/04/2026. الاستبدال: GMSNavigator continueToNextDestinationWithCompletion:.
  • ‫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: التنقّل