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

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

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

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

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

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

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

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

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

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

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

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

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

البوصلة

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