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

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

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

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

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

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

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

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

توفر واجهة برمجة تطبيقات الخرائط عناصر تحكم مضمنة في واجهة المستخدم تشبه تلك التي توجد في تطبيق خرائط 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 لخرائط Google مع الإيماءات نفسها مثل تطبيق خرائط Google. ومع ذلك، قد تكون هناك مواقف تريد فيها تعطيل إيماءات معينة للحفاظ على حالة الخريطة. يمكن أيضًا ضبط التكبير/التصغير والتحريك والإمالة والاتجاهات آليًا. يمكنك أيضًا الاطّلاع على الكاميرا والعرض لمزيد من التفاصيل. يُرجى العلم أنّ إيقاف الإيماءات لا يؤثر في إمكانية تغيير موضع الكاميرا آليًا.

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

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

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

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

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

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

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

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

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

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

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

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