نظرة عامة

تضيف حزمة Navigation SDK لنظام التشغيل Android ميزات التنقّل إلى حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android. إذا كان تطبيق Android المستنِد إلى "خرائط Google" يحتاج إلى ميزات التنقّل، يجب أن يعتمد على حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android.

ومع ذلك، تعمل معظم الوظائف في "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google لتطبيقات Android" بالطريقة نفسها في "حزمة تطوير البرامج للتنقّل على أجهزة Android". ويمكنك الوصول إليها باستخدام حزمة com.google.android.gms.maps نفسها، بغض النظر عن الملحقات التي تستخدمها لحزمة SDK. وهذا يعني أنّه إذا كان تطبيقك يعتمد في السابق على حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android، يمكنك تغيير اعتماده إلى حزمة تطوير البرامج (SDK) لتطبيق "التنقّل" لنظام التشغيل Android بدون التأثير في الوظائف الحالية لتطبيقك، مع مراعاة استثناءَين مهمّين:

  • واجهات برمجة التطبيقات التي تُعرِض استثناءً
  • واجهات برمجة التطبيقات التي لا تعمل في NavSDK ولا يكون لها أي تأثير عند طلبها

في ما يلي توضيح لهذه الاستثناءات.

واجهات برمجة التطبيقات التي تُعرِض استثناءً

تُعرِض الدالة التالية استثناءً إذا فعّل تطبيقك ذلك:

واجهات برمجة التطبيقات التي لا تتضمّن أي وظائف في حزمة Navigation SDK

لا تملك واجهات برمجة التطبيقات التالية أي وظيفة في حزمة تطوير البرامج (SDK) للملاحة، ولكنّها لن تؤثر أيضًا في حالة استدعاءها من خلال رمزك البرمجي. وتندرج هذه الطلبات ضمن الفئات التالية:

  • واجهات برمجة التطبيقات لنشاط الأجهزة القابلة للارتداء
    • فعِّل خلاصة TBT بدلاً من ذلك إذا كنت تريد هذه الوظيفة في حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android.
  • واجهات برمجة التطبيقات الأخرى

واجهات برمجة التطبيقات للأجهزة القابلة للارتداء

عادةً ما تسمح لك القيمة GoogleMapOptions.ambientEnabled(boolean enabled)بإيقاف وضع الاستراحة أو تفعيله في التطبيقات المخصّصة للأجهزة القابلة للارتداء. بالإضافة إلى ذلك، تتوفّر الطريقتان onEnterAmbient و onExitAmbient في MapView وMapFragment، ولكنهما ليس لهما أثر عند استدعائهما. بالنسبة إلى الأجهزة القابلة للارتداء، استخدِم خلاصة "الذكريات البعيدة" بدلاً من ذلك.

واجهات برمجة التطبيقات الأخرى

واجهات برمجة التطبيقات المخصّصة فقط لعملاء "خدمات النقل"

هناك العديد من واجهات برمجة التطبيقات في حزمة تطوير البرامج (SDK) لميزة التنقّل مخصّصة فقط لاستخدام عملاء خدمات النقل الذين تُحصّل Google الرسوم منهم على أساس كل معاملة. إذا لم تكن من عملاء "خدمات النقل"، لن تكون الطرق التالية مفيدة لك: