الوضع البسيط

يمكن أن تعرض حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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

Kotlin

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

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

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

الوظائف
أنواع الخرائط	هل يتوفّر؟ نعم تتوفّر أنواع الخرائط التالية من خلال GoogleMapOptions.mapType() وGoogleMap.setMapType(): MAP_TYPE_NORMAL وMAP_TYPE_SATELLITE وMAP_TYPE_TERRAIN وMAP_TYPE_HYBRID وMAP_TYPE_NONE
الخطوط المتعدّدة والمضلّعات والدوائر	هل يتوفّر؟ نعم تتطابق وظائف الوضع المبسّط للأشكال مع واجهة برمجة التطبيقات الكاملة.
العرض	هل يتوفّر؟ نعم تتطابق وظائف الوضع المبسّط في Projection مع واجهة برمجة التطبيقات الكاملة.
موقعي الجغرافي	هل يتوفّر؟ نعم تتطابق وظيفة الوضع البسيط في طبقة "موقعي الجغرافي" مع واجهة برمجة التطبيقات الكاملة.
تحجيم الخريطة	هل يتوفّر؟ نعم يتطابق دعم الوضع البسيط لميزة تحجيم الخريطة مع واجهة برمجة التطبيقات الكاملة.
نوافذ المعلومات	هل يتوفّر؟ نعم في حال ضبط title() لعلامة، ستظهر نافذة المعلومات التلقائية عندما ينقر المستخدم على العلامة. يمكنك عرض نافذة المعلومات برمجيًا من خلال استدعاء showInfoWindow() على العلامة. يمكنك أيضًا إنشاء نوافذ معلومات مخصّصة من خلال واجهة InfoWindowAdapter.
أنماط الخريطة الأساسية المخصّصة	هل الميزة متاحة؟ جزئيًا تتيح حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android الأنماط المخصّصة للخريطة الأساسية. لا يتيح "الوضع المبسّط" سوى الأنماط المخصّصة المستندة إلى JSON، وليس الأنماط المستندة إلى السحابة الإلكترونية التي تتطلّب رقم تعريف خريطة لعرض خرائط ذات تصميم خاص. لا يتيح "الوضع البسيط" أيضًا ضبط مخطط ألوان الخريطة لاستخدام الوضع الداكن.
العلامات	هل يتوفّر؟ جزئيًا يمكنك إضافة علامة والاستجابة لحدث ناتج عن النقر. ويمكنك أيضًا إضافة رموز مخصّصة لمحدّدات المواقع. لا يمكن جعل العلامة قابلة للسحب. تكون العلامات على خريطة الوضع البسيط مسطّحة ولا يمكن تدويرها.
موضع الكاميرا والتكبير/التصغير والصور المتحركة	هل الميزة متاحة؟ جزئيًا يمكنك ضبط هدف الكاميرا ومستوى التكبير/التصغير، ولكن ليس الإمالة أو الاتجاه. يتم تقريب مستوى التكبير إلى أقرب عدد صحيح في الوضع المبسّط. سيؤدي الاتصال بالرقم GoogleMap.moveCamera() إلى منحك صورة أخرى لخريطة في "الوضع البسيط". لمزيد من المعلومات حول ضبط الكاميرا والتحكّم فيها، يُرجى الاطّلاع على تغيير العرض. لن يؤدي استدعاء GoogleMap.animateCamera() إلى تحريك حركة الكاميرا. سينتقل عرض الكاميرا على الفور إلى الموضع الجديد.
ربط الأحداث	هل يتوفّر؟ جزئيًا يتيح "الوضع البسيط" استخدام GoogleMap.setOnMapClickListener() و GoogleMap.setOnMapLongClickListener(). لإيقاف الأحداث الناتجة عن النقر على خريطة في الوضع المبسّط، يمكنك استدعاء setClickable() في العرض الذي يحتوي على MapView أو MapFragment. ويكون ذلك مفيدًا، على سبيل المثال، عند عرض خريطة أو خرائط في عرض على شكل قائمة، حيث تريد أن يؤدي الحدث الناتج عن النقر إلى استدعاء إجراء غير مرتبط بالخريطة. لمعرفة التفاصيل، يُرجى الاطّلاع على مستندات الأحداث.
الخرائط الداخلية والمباني	هل يتوفّر؟ لا سيعرض "الوضع البسيط" المربّعات نفسها التي تعرضها Maps Static API. وهذا يعني أنّه إذا كان مخطط المبنى الداخلي مضمّنًا في المربّع التلقائي، سيظهر. وإلا، لن يتم ذلك. بالإضافة إلى ذلك، لا يمكنك تغيير المستوى المعروض أو التلاعب بأداة اختيار المستوى.
طبقة حركة المرور	هل يتوفّر؟ لا لا يتوفّر "GoogleMap.setTrafficEnabled()" في الوضع البسيط.
التراكبات الأرضية	هل يتوفّر؟ لا لا يتوفّر "GoogleMap.addGroundOverlay()" في الوضع المبسّط.
تراكبات المربّعات	هل يتوفّر؟ لا لا يتوفّر "GoogleMap.addTileOverlay()" في الوضع المبسّط.
الإيماءات	هل يتوفّر؟ لا لا يتيح "الوضع البسيط" استخدام الإيماءات. ولن يؤدي تفعيل الإيماءات وإيقافها إلى أي تأثير.
التجوّل الافتراضي	هل يتوفّر؟ لا لا تتوفّر ميزة التجوّل الافتراضي في الوضع البسيط.