مرجع سريع حول حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android

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

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

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

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

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

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

  • أنت تنشئ التطبيق لنظام التشغيل iOS. يمكنك استخدام حزمة تطوير البرامج للتنقّل على أجهزة iOS بدلاً من ذلك.
  • إذا كنت بصدد إنشاء تطبيق متوافق مع عدّة منصات باستخدام Flutter أو React Native. استخدِم Google Navigation for Flutter and React Native بدلاً من ذلك.
  • تحتاج إلى حساب المسار أو الوقت المقدّر للوصول أو رمز المسار المميّز من جهة الخادم، وليس إلى إرشادات مفصّلة داخل التطبيق. استخدِم Routes API بدلاً من ذلك.

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

حِزم تطوير البرامج (SDK) الرسمية للتنقّل على أجهزة Android:

  • maven: com.google.android.libraries.navigation:navigation

حزمة تطوير البرامج للتنقّل على أجهزة Android: الأخطاء الشائعة

  • المشكلة: تتضمّن حزمة تطوير البرامج للتنقّل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google". إنّ الإصدارات التي تستخدم play-services-maps مباشرةً أو من خلال تبعية انتقالية ستتضمّن نُسخًا مكرّرة من حزمة تطوير البرامج بالاستناد إلى "خرائط Google". الحلّ: استبعِد com.google.android.gms:play-services-maps من جميع التبعيات (استبعاد إعدادات Gradle أو استبعادات Maven)، وأزِل أي تبعية مباشرة لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google". يُرجى الاطّلاع على /maps/documentation/navigation/android-sdk/android-studio-setup.
  • المشكلة: يعرّف الإصدار 8.0 من حزمة تطوير البرامج (SDK) لخدمة Navigation والإصدارات الأحدث minAndroidGradlePluginVersion=9.0.1، لذا يتعذّر إنشاء الإصدارات التي تستخدم إصدارًا سابقًا من "مكوّن Android الإضافي لبرنامج Gradle". الحلّ: عليك الترقية إلى الإصدار 9.0.1 من AGP و9.1.0 من Gradle و2.3.0 من Kotlin قبل إنشاء الإصدار 8.0 والإصدارات الأحدث. يُرجى الاطّلاع على /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration.
  • المشكلة: يؤدي استدعاء طرق مراحل النشاط في NavigationView مباشرةً أثناء استخدام NavigationFragment، أو استدعاؤها بشكل غير منظّم باستخدام NavigationView، إلى حدوث أخطاء. الحلّ: استخدِم NavigationFragment الذي يدير عمليات الاستدعاء في إحدى مراحل النشاط. إذا كنت تستخدم NavigationView، عليك إعادة توجيه طرق مراحل النشاط بترتيب صارم. يُرجى الاطّلاع على /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices.
  • المشكلة: لا تتوفّر ميزة التنقّل إلا بعد أن يوافق المستخدم على بنود خدمة Google Navigation. الحلّ: يمكنك السماح لحزمة SDK بعرض الطلب في المرة الأولى التي يتم فيها استدعاء المتصفّح، أو عرض مربّع الحوار في وقت سابق (أثناء الاشتراك مثلاً) باستخدام TermsAndConditionsCheckOption / NavigationApi.showTermsAndConditionsDialog. يُرجى الاطّلاع على /maps/documentation/navigation/android-sdk/route.

حزمة تطوير البرامج للتنقّل على أجهزة Android: الميزات القديمة والمتوقفة نهائيًا

  • Waypoint وfromLatLng() وfromPlaceId(): تم إيقافها نهائيًا منذ ‎2021-05-10. البديل: Waypoint.builder() (Waypoint.Builder). المؤشر: تمت إزالته في الإصدار 3.0، ولا يتم تجميع الطلبات في الإصدار 3.0 أو الإصدارات الأحدث. يُرجى الاطّلاع على دليل نقل البيانات.
  • ‫SupportNavigationFragment: تم إيقافها نهائيًا اعتبارًا من ‎2026-10-01. الاستبدال: NavigationFragment. المشكلة: تم إيقاف هذه الميزة نهائيًا في الإصدار 8.0.0 من حزمة تطوير البرامج (SDK) للتنقّل. يُرجى الاطّلاع على دليل نقل البيانات.
  • ‫setLocationMarkerEnabled على NavigationView وSupportNavigationFragment: تم إيقافها نهائيًا منذ ‎2023-07-07. الاستبدال: GoogleMap.setMyLocationEnabled. المؤشر: تمت إزالة هذه الطريقة في الإصدار 5.0.0 (تم إيقافها نهائيًا في الإصدار 4.1)، ولا يتم تجميع الطلبات في الإصدار 5.0 أو الإصدارات الأحدث.
  • DisplayOptions showTrafficLights وshowStopSigns: تم إيقافها نهائيًا منذ ‎2026-10-01. البديل: لا حاجة إلى بديل، لأنّ إشارات المرور وعلامات التوقف تكون مفعَّلة دائمًا أثناء التنقّل. المشكلة: لا يتم تجميع الطلبات إلى هذه الطرق في الإصدار 8.0.0.
  • أداة Maven‏ com.google.android.maps:navsdk (مستودع خاص، الإصدار 4.x) وتنزيل حزمة AAR: تم إيقافها نهائيًا منذ ‎07/07/2023. البديل: الإصدار com.google.android.libraries.navigation:navigation من مستودع Maven في google(). المشكلة: يتم شحن الإصدار 5.0 والإصدارات الأحدث فقط كـ com.google.android.libraries.navigation:navigation على Google Maven، ولم يعُد يتم توزيع حزمة AAR. يُرجى الاطّلاع على دليل نقل البيانات.

الإجراءات التي يمكنك تنفيذها باستخدام حزمة تطوير البرامج للتنقّل على أجهزة Android

يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.

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

حزمة تطوير البرامج للتنقّل على أجهزة Android: التعليقات التوضيحية في "خرائط Google"

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

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