الوضع البسيط

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

عيّنات تعليمات برمجية

يتضمن مستودع ApiDemos على GitHub نماذج توضح استخدام الوضع البسيط:

• LiteDemoActivity - Java: أساسيات استخدام خريطة الوضع البسيط في لغة Java
• LiteDemoActivity - Kotlin: أساسيات استخدام خريطة الوضع البسيط في لغة Kotlin.
• LiteListDemoActivity - Java: عرض الخرائط بكفاءة في ListViews باستخدام الوضع البسيط في Java
• LiteListDemoActivity - Kotlin: يتم عرض الخرائط بكفاءة في ListViews باستخدام الوضع البسيط في لغة Kotlin.

نظرة عامة على الوضع البسيط

خريطة الوضع البسيط هي صورة نقطية لخريطة في موقع محدد ومستوى تكبير/تصغير. يدعم الوضع البسيط جميع أنواع الخرائط (عادية، مختلطة، قمر صناعي، تضاريس) ومجموعة فرعية من الوظائف التي توفرها واجهة برمجة التطبيقات الكاملة. يكون الوضع البسيط مفيدًا عندما تريد تقديم عدد من الخرائط في ساحة المشاركات، أو خريطة صغيرة جدًا بحيث لا تدعم تفاعلاً هادفًا.

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

إضافة خريطة وضع بسيط

يستخدم الوضع البسيط الفئات والواجهات نفسها مثل واجهة برمجة التطبيقات الكاملة لتطبيق "خرائط Google" على نظام التشغيل Android. يمكنك ضبط GoogleMap على الوضع البسيط بالطرق التالية:

• إما كسمة XML للرمز MapView أو MapFragment
• أو في العنصر GoogleMapOptions

كسمة XML للسمة MapView أو MapFragment

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    android:name="com.google.android.gms.maps.MapFragment"
    android:id="@+id/map"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map:cameraZoom="13"
    map:mapType="normal"
    map:liteMode="true"/>

في الكائن GoogleMapOptions

val options = GoogleMapOptions()
    .liteMode(true)

      

GoogleMapOptions options = new GoogleMapOptions()
    .liteMode(true);

      

للحصول على تفاصيل حول إعداد الحالة الأولية للخريطة، يمكنك الاطّلاع على دليل كائن الخريطة.

نية إطلاق عرض الخريطة أو طلب الاتجاهات

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

بالإضافة إلى ذلك، عندما ينقر المستخدم على الخريطة، تبدأ واجهة برمجة التطبيقات تلقائيًا في تشغيل تطبيق "خرائط Google" المتوافق مع الأجهزة الجوّالة. ويمكنك إلغاء ذلك باستخدام GoogleMap.setOnMapClickListener() لضبط خدمة المستمع الخاصة بك. يمكنك أيضًا إيقاف أحداث النقر على الخريطة من خلال استدعاء setClickable() في العرض الذي يتضمّن MapView أو MapFragment. للحصول على تفاصيل حول هاتَين الأسلوبين، يُرجى الاطّلاع على مستندات الفعاليات.

أحداث دورة الحياة

عند استخدام واجهة برمجة التطبيقات في الوضع التفاعلي الكامل، على مستخدمي الفئة MapView إعادة توجيه جميع طُرق دورة حياة النشاط إلى الطرق المناسبة في الفئة MapView. تشمل أمثلة طُرق دورة الحياة كلاً من onCreate() وonDestroy() وonResume() وonPause().

عند استخدام الفئة MapView في الوضع البسيط، تكون إعادة توجيه أحداث مراحل النشاط اختياريًا، باستثناء الحالات التالية:

• يلزم طلب الرقم onCreate()، وإلا فلن تظهر أي خريطة.
• إذا كنت ترغب في عرض نقطة "موقعي" على خريطة الوضع البسيط واستخدام مصدر الموقع التلقائي، ستحتاج إلى الاتصال بـ onResume() وonPause()، لأنه سيتم تحديث مصدر الموقع الجغرافي بين هذه المكالمات فقط. إذا كنت تستخدم مصدر الموقع الخاص بك، فليس من الضروري استدعاء هاتين الطريقتين.

ميزات واجهة برمجة التطبيقات المتوافقة

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