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

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

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

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

• UiSettingsDemoActivity: نموذج Kotlin
• ‫UiSettingsDemoActivity: نموذج Java

"الوضع البسيط" لتفاعل المستخدمين بشكل محدود

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

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

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

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

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

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

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

البوصلة

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

زر "موقعي الجغرافي"

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

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

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

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

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

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

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

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

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

يعرض شريط الأدوات رموزًا تتيح الوصول إلى عرض الخريطة أو طلب الاتجاهات في تطبيق "خرائط Google" للأجهزة الجوّالة. عندما ينقر المستخدم على رمز في شريط الأدوات، تنشئ واجهة برمجة التطبيقات intent لبدء النشاط المقابل في تطبيق "خرائط 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).