تضيف حزمة تطوير البرامج للتنقّل على أجهزة Android ميزات التنقّل إلى حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لأجهزة Android. إذا كان تطبيق Android الذي يستند إلى "خرائط Google" يحتاج إلى ميزات تنقّل، يجب أن يعتمد على حزمة Navigation SDK لنظام التشغيل Android.
ومع ذلك، تتشابه معظم الدوال في "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android" مع الدوال في "حزمة تطوير البرامج للتنقّل على أجهزة Android". ويمكنك الوصول إليها باستخدام الحزمة com.google.android.gms.maps نفسها، بغض النظر عن ملحق حزمة SDK الذي تستخدمه.
يعني ذلك أنّه إذا كان تطبيقك يعتمد سابقًا على
حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android، يمكنك تغيير هذا الاعتماد إلى
حزمة تطوير البرامج (SDK) لخدمة "الملاحة" لنظام التشغيل Android بدون التأثير في وظائف تطبيقك الحالية، مع
استثناءَين جديرَين بالذكر:
- واجهات برمجة التطبيقات التي تعرض استثناءً
- واجهات برمجة التطبيقات التي لا تعمل في NavSDK وليس لها أي تأثير عند طلبها
في ما يلي توضيح لهذه الاستثناءات.
واجهات برمجة التطبيقات التي تطرح استثناءً
تُصدر الدالة التالية استثناءً إذا كان تطبيقك يتيحها:
واجهات برمجة التطبيقات التي لا تتضمّن وظائف في حزمة تطوير البرامج للتنقّل
لا تتضمّن واجهات برمجة التطبيقات التالية أي وظائف في Navigation SDK، ولكن لن يكون لها أي تأثير إذا كان الرمز البرمجي الخاص بك يستدعيها. وتندرج ضمن الفئات التالية:
- واجهات برمجة التطبيقات الخاصة بنشاط الأجهزة القابلة للارتداء
- يمكنك تفعيل خلاصة التنقّل خطوة بخطوة بدلاً من ذلك إذا كنت تريد هذه الوظيفة في حزمة تطوير البرامج للتنقّل على أجهزة Android.
- واجهات برمجة التطبيقات الأخرى
واجهات برمجة التطبيقات للأجهزة القابلة للارتداء
يسمح لك عادةً GoogleMapOptions.ambientEnabled(boolean enabled) بتفعيل وضع الاستراحة أو إيقافه لتطبيقات الأجهزة القابلة للارتداء. بالإضافة إلى ذلك، يتوفّر الإجراءان onEnterAmbient وonExitAmbient في MapView وMapFragment، ولكن ليس لهما أي تأثير عند استدعائهما. بالنسبة إلى الأجهزة القابلة للارتداء، استخدِم خلاصة "التنقّل خطوة بخطوة" بدلاً من ذلك.
واجهات برمجة تطبيقات أخرى
- لا يؤدي ضبط LocationSource مخصّص إلى أي إجراء في NavSDK.
- جميع واجهات برمجة التطبيقات MapsInitializer
- RuntimeRemoteException
واجهات برمجة التطبيقات المخصّصة لاستخدام عملاء "خدمات التنقّل" فقط
تتضمّن Navigation SDK عدة واجهات برمجة تطبيقات مخصّصة فقط لعملاء خدمات التنقّل الذين تحصّل منهم Google رسومًا على أساس كل معاملة. إذا لم تكن من عملاء "خدمات التنقّل"، لن يكون بإمكانك استخدام الطرق التالية:
NavigationTransactionRecorder.pickup()NavigationTransactionRecorder.dropoff()NavigationTransactionRecorder.generatedTransactionId()Navigator.fetchRouteInfo()Navigator.setTransactionIds()