الوضع البسيط

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

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

يتضمّن مستودع ApiDemos على GitHub عيّنات توضّح كيفية استخدام الوضع الخفيف:

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

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

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

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

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

يستخدم "الوضع البسيط" الفئات والواجهات نفسها التي يستخدمها الإصدار الكامل من Google Maps Android API. يمكنك ضبط 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()، لأنّ مصدر الموقع الجغرافي لن يتم تعديله إلا بين هاتين العمليتين. إذا كنت تستخدم مصدر الموقع الجغرافي الخاص بك، ليس من الضروري استدعاء هاتين الطريقتين.

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

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