الوضع البسيط

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

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

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