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

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

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

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

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

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

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

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

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

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

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

إيماءات التمرير (التحريك)

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

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

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

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

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