الوضع البسيط

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

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

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

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

خريطة الوضع البسيط هي صورة نقطية لخرائط في موقع جغرافي محدّد ومستوى 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

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

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

لن يؤدي الاتصال بالرقم GoogleMap.animateCamera() إلى عرض حركة الكاميرا بشكل متحرك. ستنتقل شاشة الكاميرا على الفور إلى الموضع الجديد.
ربط الأحداث
هل هذا الخيار متاح؟ جزئيًا

يتيح "الوضع البسيط" استخدام GoogleMap.setOnMapClickListener() و GoogleMap.setOnMapLongClickListener().

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

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