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

باستخدام حزمة 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).