الوضع البسيط

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

جافا

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

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