عناصر التحكم والإيماءات

باستخدام حزمة SDK للخرائط لأجهزة Android، يمكنك تخصيص الطريقة التي يمكن للمستخدمين من خلالها التفاعل مع خريطتك، من خلال تحديد عناصر واجهة المستخدم المضمنة التي تظهر على الخريطة والإيماءات المسموح بها.

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

يتضمن مستودع ApiDemos على GitHub نموذجًا يوضح استخدام خيارات التحكم والإيماءات:

• UiSettingsDemoActivity: نموذج بلغة Kotlin
• UiSettingsDemoActivity: نموذج Java

الوضع البسيط لتقليل تفاعل المستخدم

إذا كنت تريد خريطة خفيفة الوزن بتفاعل بسيط من المستخدم، ضع في اعتبارك استخدام خريطة ذات الوضع البسيط. يقدم الوضع البسيط صورة نقطية للخريطة في موقع ومستوى تكبير/تصغير محدد. في الوضع البسيط، لا يمكن للمستخدمين تحريك الخريطة أو تكبيرها/تصغيرها ولا تعمل الإيماءات. للحصول على التفاصيل، اطّلِع على دليل الوضع البسيط.

عناصر التحكم في واجهة المستخدم

توفر واجهة برمجة التطبيقات للخرائط عناصر تحكم مدمجة في واجهة المستخدم مشابهة لتلك الموجودة في تطبيق خرائط Google على هاتف Android الخاص بك. يمكنك تبديل إذن الوصول إلى عناصر التحكّم هذه باستخدام الفئة UiSettings التي يمكن الحصول عليها من GoogleMap باستخدام الطريقة GoogleMap.getUiSettings. التغييرات التي يتم إجراؤها في هذه الفئة تظهر على الخريطة فورًا. للاطّلاع على مثال على هذه الميزات، يمكنك الاطّلاع على نشاط العرض التوضيحي لإعدادات واجهة المستخدم في نموذج التطبيق.

يمكنك أيضًا ضبط معظم هذه الخيارات عند إنشاء الخريطة إمّا من خلال سمات XML أو باستخدام الفئة GoogleMapOptions. راجِع ضبط الحالة الأولية للحصول على المزيد من التفاصيل.

لكل عنصر تحكم في واجهة المستخدم موضع محدد مسبقًا بالنسبة إلى حافة الخريطة. يمكنك نقل عناصر التحكّم بعيدًا عن الحافة العلوية أو السفلية أو اليسرى أو اليمنى من خلال إضافة مساحة متروكة إلى العنصر GoogleMap.

عناصر التحكم في التكبير/التصغير

توفر واجهة برمجة تطبيقات الخرائط عناصر تحكم مدمجة في التكبير/التصغير تظهر في أسفل الزاوية اليسرى من الخريطة. إنّها غير مفعّلة تلقائيًا، ولكن يمكن تفعيلها من خلال الاتصال بـ UiSettings.setZoomControlsEnabled(true).

بوصلة

توفر واجهة برمجة التطبيقات للخرائط رسم بوصلة يظهر في الزاوية العلوية اليسرى من الخريطة في ظل ظروف معينة. لن تظهر البوصلة إلا عندما تكون الكاميرا موجَّهة بحيث يكون لها حامل غير صفري أو إمالة غير صفرية. عندما ينقر المستخدم على البوصلة، تحرك الكاميرا مرة أخرى إلى موضع مع انحدار وميل بقيمة صفر (الاتجاه التلقائي) وتتلاشى البوصلة بعد ذلك بقليل. يمكنك إيقاف ظهور البوصلة تمامًا عن طريق استدعاء UiSettings.setCompassEnabled(boolean). ومع ذلك، لا يمكنك فرض عرض البوصلة دائمًا.

زر موقعي

يظهر زر موقعي في الزاوية العلوية اليسرى من الشاشة فقط عند تمكين طبقة موقعي. للحصول على التفاصيل، راجع دليل بيانات الموقع الجغرافي.

أداة اختيار المستوى

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

يمكنك إيقاف عنصر التحكّم في "أداة اختيار المستوى" أو تفعيله من خلال طلب الرقم GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean).

هذه الطريقة مفيدة إذا كنت تريد استبدال أداة اختيار المستوى التلقائي بمنتقي المستوى الخاص بك.

شريط أدوات الخريطة

يظهر شريط الأدوات افتراضيًا في الجزء السفلي الأيمن من الخريطة عندما ينقر المستخدم على العلامة. يوفر شريط الأدوات للمستخدم إمكانية الوصول السريع إلى تطبيق خرائط Google للجوّال.

ويمكنك تفعيل شريط الأدوات وإيقافه عن طريق استدعاء UiSettings.setMapToolbarEnabled(boolean).

في خريطة الوضع البسيط، يستمر شريط الأدوات بشكلٍ مستقل عن إجراءات المستخدم. في الخريطة التفاعلية بالكامل، ينزلق شريط الأدوات عندما ينقر المستخدم على محددة ثم ينزلق مرة أخرى عندما تصبح العلامة غير محل التركيز.

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

يظهر شريط الأدوات في أسفل يسار الخريطة في لقطة الشاشة أعلاه. لا شيء، سيظهر أحد رمزي الغرض أو كليهما على الخريطة، اعتمادًا على محتوى الخريطة بشرط أن يدعم تطبيق خرائط Google للجوّال الهدف الناتج.

إيماءات الخريطة

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

مثل عناصر التحكّم في واجهة المستخدم، يمكنك تفعيل/إيقاف الإيماءات باستخدام الفئة UiSettings التي يمكن الحصول عليها من GoogleMap من خلال طلب GoogleMap.getUiSettings. تنعكس التغييرات التي يتم إجراؤها على هذه الفئة على الفور على الخريطة. للاطّلاع على مثال على هذه الميزات، يمكنك الاطّلاع على نشاط العرض التوضيحي لإعدادات واجهة المستخدم في نموذج التطبيق (يمكنك الاطّلاع هنا على كيفية تثبيته).

يمكنك أيضًا ضبط هذه الخيارات عند إنشاء الخريطة إما من خلال سمات XML أو باستخدام الفئة GoogleMapOptions. راجع تهيئة الخريطة للحصول على المزيد من التفاصيل.

إيماءات التكبير/التصغير

تستجيب الخريطة لمجموعة متنوعة من الإيماءات التي يمكن أن تغير مستوى تكبير/تصغير الكاميرا:

• انقر مرّتين لزيادة مستوى التكبير بمقدار 1 (تكبير).
• انقر بإصبعين لخفض مستوى التكبير/التصغير بمقدار 1 (تصغير).
• التصغير أو التكبير بإصبعين
• التكبير بإصبع واحد من خلال النقر المزدوج مع عدم رفع الإصبع عن النقر عند النقرة الثانية، ثم تمرير الإصبع للأعلى للتصغير أو للأسفل للتكبير.

يمكنك إيقاف إيماءات التكبير/التصغير من خلال طلب الرقم UiSettings.setZoomGesturesEnabled(boolean). لن يؤثر ذلك في ما إذا كان بإمكان المستخدم استخدام عناصر التحكم في التكبير أو التصغير للتكبير والتصغير.

إيماءات التمرير (التحريك)

يمكن للمستخدم التمرير (تحريك) حول الخريطة عن طريق سحب الخريطة بإصبعه. يمكنك إيقاف التمرير عن طريق استدعاء UiSettings.setScrollGesturesEnabled(boolean).

إيماءات الإمالة

يمكن للمستخدم إمالة الخريطة عن طريق وضع إصبعين على الخريطة وتحريكهما لأسفل أو لأعلى معًا لزيادة زاوية الإمالة أو تقليلها على التوالي. يمكنك إيقاف إيماءات الإمالة من خلال طلب الرقم UiSettings.setTiltGesturesEnabled(boolean).

تدوير الإيماءات

يمكن للمستخدم تدوير الخريطة عن طريق وضع إصبعين على الخريطة وتطبيق حركة دوّارة. يمكنك إيقاف ميزة الدوران من خلال طلب الرقم UiSettings.setRotateGesturesEnabled(boolean).