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

اختيار النظام الأساسي: 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). ومع ذلك، لا يمكنك فرض ظهور البوصلة دائمًا.

البوصلة

زر "موقعي"

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

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

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

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

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

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

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

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

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

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

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

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