الوضع البسيط

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

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

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

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

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

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