عارض خرائط جديد

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

ويوفر العارض الجديد المزايا التالية:

الجدول الزمني للطرح

في تشرين الأول (أكتوبر) 2021، بدأت Google في طرح عارض الخرائط الذي تمت ترقيته. وفي ذلك الوقت، يمكنك الموافقة على بدء استخدام العارض الذي تمت ترقيته في تطبيقك.

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

ماذا يحدث عندما يتم تغيير العارض التلقائي؟

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

ومع ذلك، يمكنك أن تقرر إيقاف هذا التغيير. في حال إيقاف التطبيق، سيستمر تطبيقك في استخدام العارض القديم. راجِع إيقاف استخدام العارض الذي تمت ترقيته للحصول على أمثلة عن الرمز البرمجي الذي يتناول كيفية الإيقاف.

الأجهزة المتوافقة

لاستخدام عارض الخرائط الذي تمت ترقيته، يجب أن تستوفي الأجهزة المعايير التالية:

  • Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) أو إصدار أحدث
  • تستخدم الإصدار 21.39.14 أو إصدار أحدث من "خدمات Google Play"

في الأجهزة التي تستخدم الإصدار 4.4W (المستوى 20 من واجهة برمجة التطبيقات) أو الإصدارات الأقدم أو التي تستخدم الإصدار 21.39.13 أو الإصدارات الأقدم من "خدمات Google Play"، يمكنك مواصلة استخدام العارض القديم حتى بعد تغيير العارض التلقائي إلى عارض الخرائط الذي تمت ترقيته.

إيقاف استخدام العارض الذي تمت ترقيته

تستخدم التطبيقات التي تم إنشاؤها باستخدام الإصدار 18.2.0 من حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android بشكل تلقائي عارضًا تمت ترقيته. وإذا لزم الأمر، يمكنك صراحةً إيقاف استخدام العارض الذي تمت ترقيته لاستخدام العارض القديم في تطبيقك.

لإيقاف الميزة:

يجب أن يستدعي الرمز MapsInitializer.initialize() قبل إنشاء أيّ من MapView أو MapFragment أو SupportMapFragment. ننصحك باستدعاء هذا الحدث في onCreate ضمن قسم التطبيق أو النشاط في تطبيقك، قبل ضبط عرض المحتوى.

يوضح المثال التالي كيفية طلب إيقاف استخدام عارض الخرائط القديم في MapsInitializer.initialize().

Kotlin

import com.google.android.gms.maps.MapsInitializer
import com.google.android.gms.maps.MapsInitializer.Renderer
import com.google.android.gms.maps.OnMapsSdkInitializedCallback

internal class MapRendererOptInApplication : Application(), OnMapsSdkInitializedCallback {
  override fun onCreate() {
    super.onCreate()
    MapsInitializer.initialize(applicationContext, Renderer.LEGACY, this)
  }

  override fun onMapsSdkInitialized(renderer: MapsInitializer.Renderer) {
    when (renderer) {
      Renderer.LATEST -> Log.d("MapsDemo", "The latest version of the renderer is used.")
      Renderer.LEGACY -> Log.d("MapsDemo", "The legacy version of the renderer is used.")
    }
  }
}

Java

import com.google.android.gms.maps.MapsInitializer;
import com.google.android.gms.maps.MapsInitializer.Renderer;
import com.google.android.gms.maps.OnMapsSdkInitializedCallback;

class MapRendererOptInApplication extends Application implements OnMapsSdkInitializedCallback {

  @Override
  public void onCreate() {
    super.onCreate();
    MapsInitializer.initialize(getApplicationContext(), Renderer.LEGACY, this);
  }

  @Override
  public void onMapsSdkInitialized(MapsInitializer.Renderer renderer) {
    switch (renderer) {
      case LATEST:
        Log.d("MapsDemo", "The latest version of the renderer is used.");
        break;
      case LEGACY:
        Log.d("MapsDemo", "The legacy version of the renderer is used.");
        break;
    }
  }
}