نظرة عامة

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

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

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

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

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

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

واجهات برمجة التطبيقات التي لا تحتوي على وظائف في حزمة تطوير البرامج (SDK) الخاصة بالتنقل

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

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

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

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

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

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

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