يمكن لحزمة تطوير البرامج (SDK) للخرائط الخاصة بنظام التشغيل Android عرض صورة نقطية لخريطة، التفاعلية المحدودة للمستخدم. ويُطلَق على ذلك خريطة الوضع البسيط.
عيّنات تعليمات برمجية
يشمل مستودع ApiDemos على GitHub ما يلي: العينات التي توضح استخدام الوضع البسيط:
- LiteDemoActivity - Java: أساسيات استخدام خريطة الوضع البسيط في Java
- LiteDemoActivity - Kotlin: أساسيات استخدام خريطة الوضع البسيط في Kotlin
- LiteListDemoActivity - Java: عرض الخرائط بكفاءة في عروض ListViews باستخدام الوضع البسيط في Java
- LiteListDemoActivity - Kotlin: عرض الخرائط بكفاءة في عروض ListViews باستخدام الوضع البسيط في Kotlin
نظرة عامة على الوضع البسيط
خريطة الوضع البسيط هي صورة نقطية لخريطة في موقع محدد ويتم تكبيره أو تصغيره المستوى. يدعم الوضع البسيط جميع أنواع الخرائط (العادية والمختلطة والقمر الصناعي والتضاريس) ومجموعة فرعية من الوظائف التي توفرها واجهة برمجة التطبيقات الكاملة. الوضع البسيط عندما تريد تقديم عدد من الخرائط في تدفق، أو خريطة صغيرة جدًا بحيث لا تدعم التفاعل الهادف.
لا يمكن للمستخدمين الذين يعرضون الخريطة تكبير/تصغير الخريطة أو تحريكها. تعطي الأيقونات على الخريطة وصول المستخدمين إلى عرض الخريطة في تطبيق خرائط 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.setTrafficEnabled() " غير متاح
في الوضع البسيط. |
تراكبات سطح الأرض | متوافق؟ لا
لا يمكن استخدام " GoogleMap.addGroundOverlay() " في الإصدار البسيط.
الحالي. |
تراكبات الصور | متوافق؟ لا
لا يمكن استخدام " GoogleMap.addTileOverlay() " في الإصدار البسيط.
الحالي. |
الإيماءات | متوافق؟ لا
لا يتيح "الوضع البسيط" الإيماءات. تمكين الإيماءات وإيقافها
لن يكون له أي تأثير. |
التجوّل الافتراضي | متوافق؟ لا
التجوّل الافتراضي هو
غير متاحة في الوضع البسيط. |