يمكنك من خلال استخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android تخصيص الطريقة التي يمكن للمستخدمين من خلالها التفاعل مع خريطتك، من خلال تحديد مكونات واجهة المستخدم المضمّنة والتي تظهر على الخريطة والإيماءات المسموح بها.
عيّنات تعليمات برمجية
يتضمن مستودع ApiDemos على GitHub نموذجًا يوضح استخدام خيارات التحكم والإيماءات:
- UiSettingsDemoActivity: نموذج Java
- UiSettingsDemoActivity: نموذج Kotlin
الوضع البسيط لأقل تفاعل من المستخدم
إذا كنت ترغب في خريطة خفيفة الوزن ذات تفاعل بسيط من المستخدم، ففكر في استخدام خريطة ذات الوضع البسيط. يقدم الوضع البسيط صورة نقطية للخريطة في موقع ومستوى تكبير/تصغير محدد. في الوضع البسيط، لا يمكن للمستخدمين تحريك الخريطة أو تكبيرها/تصغيرها ولا تعمل الإيماءات. لمعرفة التفاصيل، يُرجى الاطّلاع على دليل الوضع البسيط.
عناصر التحكُّم في واجهة المستخدم
تقدم واجهة برمجة التطبيقات للخرائط عناصر تحكم مدمجة في واجهة المستخدم تشبه تلك الموجودة في تطبيق خرائط 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 لنظام التشغيل Android الإيماءات نفسها مثل تطبيق خرائط Google. ومع ذلك، قد تكون هناك مواقف تريد فيها إيقاف إيماءات معينة من أجل الحفاظ على حالة الخريطة. يمكن أيضًا ضبط التكبير أو التصغير والتحريك والإمالة والمحاذاة بشكل آلي. راجع الكاميرا والعرض لمزيد من التفاصيل. تجدر الإشارة إلى أنّ إيقاف الإيماءات لا يؤثر في إمكانية تغيير موضع الكاميرا آليًا.
مثل عناصر التحكّم في واجهة المستخدم، يمكنك تفعيل/إيقاف الإيماءات باستخدام الفئة
UiSettings التي يمكن الحصول عليها من GoogleMap
من خلال طلب GoogleMap.getUiSettings. تنعكس التغييرات التي يتم إجراؤها على هذه الفئة
على الفور على الخريطة. للاطّلاع على مثال على هذه الميزات، يمكنك الاطّلاع على نشاط العرض التوضيحي لإعدادات واجهة المستخدم في نموذج التطبيق (يمكنك الاطّلاع هنا على كيفية تثبيته).
يمكنك أيضًا ضبط هذه الخيارات عند إنشاء الخريطة إما من خلال سمات XML أو باستخدام الفئة GoogleMapOptions.
راجع تهيئة الخريطة للحصول على مزيد من التفاصيل.
إيماءات التكبير/التصغير
تستجيب الخريطة لمجموعة متنوعة من الإيماءات التي يمكن أن تغير مستوى التكبير/التصغير للكاميرا:
- انقر مرّتين لزيادة مستوى التكبير/التصغير بمقدار 1 (تكبير).
- انقر بإصبعين لتصغير مستوى التكبير/التصغير بمقدار 1 (تصغير).
- تصغير/توسيع بإصبعَين
- التكبير بإصبع واحد من خلال النقر المزدوج مع عدم رفعه عند النقرة الثانية، ثم تمرير الإصبع للأعلى للتصغير أو التمرير إلى الأسفل للتكبير.
يمكنك إيقاف إيماءات التكبير/التصغير من خلال استدعاء
UiSettings.setZoomGesturesEnabled(boolean). لن يؤثر ذلك في إمكانية استخدام المستخدم
لعناصر تحكم التكبير/التصغير للتكبير والتصغير.
إيماءات التمرير (التحريك)
يمكن للمستخدم التمرير (التحريك) حول الخريطة عن طريق سحب الخريطة بإصبعه.
يمكنك إيقاف الانتقال للأسفل أو للأعلى من خلال استدعاء
UiSettings.setScrollGesturesEnabled(boolean).
إيماءات الإمالة
يمكن للمستخدم إمالة الخريطة عن طريق وضع إصبعين على الخريطة وتحريكهما لأسفل أو لأعلى معًا لزيادة زاوية الإمالة أو تقليلها على التوالي. يمكنك إيقاف إيماءات الإمالة من خلال طلب الرقم UiSettings.setTiltGesturesEnabled(boolean).
تدوير الإيماءات
يمكن للمستخدم تدوير الخريطة عن طريق وضع إصبعين على الخريطة وتطبيق حركة تدوير. يمكنك إيقاف التناوب عن طريق طلب الرقم
UiSettings.setRotateGesturesEnabled(boolean).