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

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

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

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

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

الوضع البسيط للحد الأدنى من تفاعل المستخدم

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

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

توفر واجهة برمجة التطبيقات للخرائط عناصر تحكم مدمجة في واجهة المستخدم تشبه عناصر واجهة برمجة التطبيقات الموجودة في تطبيق خرائط 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 للجوّال النتيجة الناتجة.

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

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

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

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

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

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

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

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

إيماءات التمرير (العرض الشامل)

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

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

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

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

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