الوضع البسيط

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

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

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

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

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

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