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

اختيار النظام الأساسي: Android‏ iOS‏ JavaScript‏

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

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

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

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

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

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

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

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

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

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

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

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

البوصلة

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

البوصلة

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

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

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

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

By default, a level picker (floor picker) appears near the center right-hand edge of the screen when the user is viewing an indoor map. عندما تظهر خريطتان داخليتان أو أكثر، سيتم تطبيق أداة اختيار الطابق على المبنى الذي يتم التركيز عليه حاليًا، وهو عادةً المبنى الأقرب إلى منتصف الشاشة. يحتوي كل مبنى على مستوى تلقائي سيتم اختياره عند عرض أداة الاختيار لأول مرة. ويمكن للمستخدمين اختيار مستوى مختلف من خلال تحديده من أداة الاختيار.

يمكنك إيقاف عنصر التحكّم في أداة اختيار المستوى أو تفعيله من خلال استدعاء 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).