مرجع سريع حول حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android

تضيف حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android بيانات "خرائط Google" وطرق عرض الخرائط والاستجابات لإيماءات الخرائط إلى تطبيقات Android، بما في ذلك تطبيقات Wear OS. يمكنك إضافة علامات ومضلّعات وتراكبات لعرض معلومات حول المواقع الجغرافية على الخريطة ودعم تفاعل المستخدمين، وذلك باستخدام Kotlin أو Java.

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

حالات استخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android

استخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android في الحالات التالية:

  • تحتاج إلى خريطة Google تفاعلية ثنائية الأبعاد في تطبيق Android أو Wear OS أصلي.
  • تحتاج إلى إضافة علامات أو نوافذ معلومات أو خطوط متعدّدة أو مضلّعات أو تراكبات أرضية أو تراكبات مربّعات إلى خريطة في تطبيق Android.
  • تحتاج إلى صور بانوراما في "التجوّل الافتراضي" أو خرائط في "الوضع المبسّط" (صورة نقطية) أو "تصميم الخرائط باستخدام السحابة الإلكترونية" مع أرقام تعريف الخرائط في تطبيق Android.
  • يمكنك إنشاء خريطة Android بلغة Kotlin أو Java، بما في ذلك Jetpack Compose من خلال مكتبة Compose لحزمة تطوير برامج "خرائط Google".

لا تستخدِم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android في الحالات التالية:

حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android: الإعداد

حزم حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android الرسمية:

  • maven: com.google.android.gms:play-services-maps

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: الأخطاء الشائعة

  • المشكلة: منذ الإصدار 20.0.0 من حزمة تطوير البرامج (SDK)، لم يعُد بيان الحزمة يتضمّن مكتبة org.apache.http.legacy. قد تتعطّل التطبيقات التي تحمّل أداة عرض الخرائط القديمة عند استخدام java.lang.NoClassDefFoundError. الحلّ: أضِف داخل علامة في ملف AndroidManifest.xml الخاص بالتطبيق. لا تتأثر الأجهزة التي تعمل بالإصدار 25.50.34 من "خدمات Google Play" أو الإصدارات الأحدث. يُرجى الاطّلاع على /maps/documentation/android-sdk/release-notes.
  • المشكلة: تحتاج العلامات المتقدّمة إلى أداة عرض الخرائط التي تمت ترقيتها. إذا أضفتها إلى تطبيق حالي بدون إعادة إنشائه، سيظل بإمكان التطبيق استخدام العارض القديم. الحلّ: أعِد إنشاء التطبيق باستخدام حزمة تطوير البرامج (SDK) بالإصدار 18.2.0 أو إصدار أحدث ليكون محرّك العرض الذي تمت ترقيته هو المحرّك التلقائي. يُرجى الاطّلاع على /maps/documentation/android-sdk/advanced-markers/start.
  • المشكلة: الأجهزة التي لا تستوفي متطلبات العارض (الإصدار 5.0 من Android أو المستوى 21 من واجهة برمجة التطبيقات أو الإصدارات الأحدث، والإصدار 21.39.14 من "خدمات Google Play" أو الإصدارات الأحدث، وتفعيل "متجر Google Play") تعود إلى العارض القديم، وبالتالي لا تتوفّر عليها الميزات التي تحتاج إلى العارض الجديد، مثل "تصميم الخرائط باستخدام السحابة الإلكترونية". الحلّ: يُرجى استدعاء MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) والتحقّق من قيمة MapsInitializer.Renderer التي تم تمريرها إلى OnMapsSdkInitializedCallback.onMapsSdkInitialized()، أو التحقّق من GoogleMap.getMapCapabilities(). إذا كان الجهاز يستخدم LEGACY، لا تعتمد على ميزة "تصميم الخرائط باستخدام السحابة الإلكترونية" أو "العلامات المتقدّمة". يُرجى الاطّلاع على /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback.
  • المشكلة: تتطلّب حزمة SDK توفُّر "خدمات Google Play" على الجهاز الذي يعمل عليه التطبيق. الحلّ: يمكنك اختياريًا استدعاء عملية التحقّق من توفّر "خدمات Google Play" من تطبيقك. يُرجى الاطّلاع على /maps/documentation/android-sdk/config.

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

  • أداة عرض الخرائط القديمة: تم إيقافها نهائيًا منذ 4 مارس 2024. البديل: أداة عرض الخرائط التي تمت ترقيتها (أحدث إصدار)، وهي الأداة التلقائية منذ الإصدار 18.2.0 من حزمة تطوير البرامج (SDK). المشكلة: لا تتوفّر ميزات "تصميم الخرائط باستخدام السحابة الإلكترونية" والتخصيصات المتقدّمة للخطوط المتعدّدة و"العلامات المتقدّمة" في أداة العرض القديمة. يُرجى الاطّلاع على دليل نقل البيانات.

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

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

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: التصميم المستند إلى البيانات للحدود

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: التصميم المستند إلى البيانات لمجموعات البيانات

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: مجموعات البيانات

حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android: الخرائط

حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android: التعليقات التوضيحية على الخرائط

حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android: أنماط الخرائط

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