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

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

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

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

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

الوضع البسيط لأقل تفاعل للمستخدم

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

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

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

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

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

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

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

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

بوصلة

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

بوصلة

زر موقعي

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

زر موقعي

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

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

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

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

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

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

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

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

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

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

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

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

AndroidManifest.xml

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

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

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

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

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

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

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

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

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

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

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

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

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

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