الوضع البسيط

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

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

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

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

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

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

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

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

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