الوضع البسيط

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

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

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

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

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

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

      

Java


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.
الخطوط المتعددة والمضلعات والدوائر
هل تتوفّر هذه الميزة؟ نعم
تتطابق وظيفة الوضع البسيط للأشكال مع واجهة برمجة التطبيقات الكاملة.
توقّعات الميزانية
هل تتوفّر هذه الميزة؟ نعم
تتطابق وظيفة الوضع البسيط للعرض مع واجهة برمجة التطبيقات الكاملة.
موقعي الجغرافي
هل تتوفّر هذه الميزة؟ نعم
تتطابق وظيفة الوضع البسيط لطبقة موقعي مع واجهة برمجة التطبيقات الكاملة.
المساحة المتروكة على الخريطة
هل تتوفّر هذه الميزة؟ نعم
يتوافق الوضع البسيط مع المساحة المتروكة على الخريطة مع واجهة برمجة التطبيقات الكاملة.
نوافذ المعلومات
هل تتوفّر هذه الميزة؟ نعم
في حال ضبط title() لعلامة، ستظهر نافذة المعلومات التلقائية عندما ينقر المستخدم على العلامة. يمكنك عرض نافذة المعلومات آليًا عن طريق استدعاء الرقم showInfoWindow() على محدِّد الموقع. يمكنك أيضًا إنشاء نوافذ معلومات مخصّصة من خلال واجهة InfoWindowAdapter.
أنماط الخريطة الأساسية المخصّصة
هل تتوفّر هذه الميزة؟ جزئيًا
تتوافق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android مع النمط المخصّص للخريطة الأساسية. يتيح "الوضع البسيط" فقط استخدام النمط المخصّص المستند إلى JSON، وليس النمط المستند إلى السحابة الإلكترونية الذي يتطلب معرّف خريطة لعرض خريطة ذات نمط معيّن.
Markers
هل تتوفّر هذه الميزة؟ جزئيًا
يمكنك إضافة محدّد والردّ على حدث ناتج عن النقر. يمكنك أيضًا إضافة رموز محدّدات موقع مخصّصة. لا يمكن جعل العلامة قابلة للسحب. العلامات على خريطة الوضع البسيط مسطحة ولا يمكن تدويرها.
موضع الكاميرا والتكبير أو التصغير والرسوم المتحركة
هل تتوفّر هذه الميزة؟ جزئيًا

يمكنك ضبط هدف الكاميرا والتكبير/التصغير، ولكن لا يمكنك ضبط الإمالة أو الاتجاه. يتم تقريب مستوى التكبير/التصغير إلى أقرب عدد صحيح في الوضع البسيط. سيؤدي الاتصال بالرقم GoogleMap.moveCamera() إلى عرض صورة خريطة أخرى في الوضع البسيط. للاطّلاع على مزيد من المعلومات حول إعدادات الكاميرا ومعالجتها، يُرجى الاطّلاع على تغيير العرض.

ولن يؤدي طلب الرقم GoogleMap.animateCamera() إلى إنشاء حركة الكاميرا. وسيتحرك عرض الكاميرا فورًا إلى الموضع الجديد.

ربط الأحداث
هل تتوفّر هذه الميزة؟ جزئيًا

يتوافق "الوضع البسيط" مع GoogleMap.setOnMapClickListener() وGoogleMap.setOnMapLongClickListener().

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

لمعرفة التفاصيل، يُرجى الاطّلاع على مستندات الفعاليات.

المباني والخرائط الداخلية
هل تتوفّر هذه الميزة؟ لا
سيعرض "الوضع البسيط" المربّعات نفسها التي تعرضها واجهة برمجة التطبيقات الثابتة للخرائط. وهذا يعني أنه إذا تم دمج مخطط الطابق الداخلي في المربّع التلقائي، سيظهر. وإلا فلن يحدث. ولا يمكنك أيضًا تغيير المستوى المعروض أو معالجة أداة اختيار المستوى.
طبقة حركة المرور
هل تتوفّر هذه الميزة؟ لا
لا يمكن استخدام GoogleMap.setTrafficEnabled() في الوضع البسيط.
العناصر المركّبة على الأرض
هل تتوفّر هذه الميزة؟ لا
لا يتوفَّر GoogleMap.addGroundOverlay() في الوضع البسيط.
تراكبات المربعات
هل تتوفّر هذه الميزة؟ لا
لا يتوفَّر GoogleMap.addTileOverlay() في الوضع البسيط.
الإيماءات
هل تتوفّر هذه الميزة؟ لا
لا يتيح "الوضع البسيط" الإيماءات. ولن يكون لتفعيل الإيماءات وإيقافها أي تأثير.
التجوّل الافتراضي
هل تتوفّر هذه الميزة؟ لا
لا يتم دعم التجوّل الافتراضي في الوضع البسيط.