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