الوضع البسيط

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

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

يتضمن مستودع ApiDemos على GitHub عيّنات تعرض استخدام الوضع البسيط:

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

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

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

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

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

يستخدم الوضع البسيط فئات وواجهات نفس واجهة برمجة تطبيقات Android لخرائط Google بالكامل. يمكنك ضبط الوضع 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

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

      

val options = GoogleMapOptions()
    .liteMode(true)

      

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

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

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

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

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

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

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

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

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

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