عند استخدام النماذج التالية، يمكنك إضافة إمكانية تفاعل المستخدمين مع الخرائط التي ترسمها، مثل السماح لهم بالاطّلاع على أجزاء مختلفة من الخريطة من خلال التكبير والتصغير والعرض الشامل.
| نموذج | مستويات واجهة برمجة التطبيقات المتوافقة مع تطبيقات السيارات |
|---|---|
NavigationTemplate |
2 |
(متوقّف نهائيًا) |
4 |
(متوقّف نهائيًا) |
4 |
(متوقّف نهائيًا) |
5 (تم تقديم النموذج) |
MapWithContentTemplate |
7 (تم تقديم النموذج) |
تنفيذ عمليات معاودة الاتصال المتعلقة بالتفاعل
تتضمّن واجهة SurfaceCallback عدة طرق ردّ يمكنك تنفيذها لإضافة التفاعلية إلى الخرائط التي تم إنشاؤها باستخدام النماذج في القسم السابق:
| التفاعل | الطريقة | مستويات واجهة برمجة التطبيقات المتوافقة مع تطبيقات السيارات |
|---|---|---|
| نقر | onClick |
5 |
| استخدام إصبعين للتصغير | onScale |
2 |
| السحب بلمسة واحدة | onScroll |
2 |
| نقل المحتوى بلمسة واحدة | onFling |
2 |
| النقر مرتين |
(يحدّد مضيف النموذج عامل القياس) |
2 |
| الدفع الدائري في وضع العرض الشامل |
(يحدّد مضيف النموذج عامل المسافة) |
2 |
إضافة شريط إجراءات الخريطة
يمكن أن تتضمّن هذه النماذج شريط إجراءات الخريطة لتنفيذ إجراءات متعلقة بالخريطة، مثل التكبير والتصغير وإعادة التوسيط وعرض بوصلة وغيرها من الإجراءات التي تختار عرضها. يمكن أن يحتوي شريط إجراءات الخريطة على ما يصل إلى أربعة أزرار تتضمّن رموزًا فقط يمكن إعادة تحميلها بدون التأثير في عمق المهمة. يتم إخفاء شريط الإجراءات عندما تكون الشاشة في وضع الخمول، ثم يظهر مجددًا عندما تكون في وضع النشاط.
لتلقّي عمليات ردّ الاتصال التفاعلية الخاصة بالخريطة، يجب إضافة زر في شريط إجراءات الخريطة.Action.PAN عندما يضغط المستخدم على الزر تحريك، يدخل الجهاز المضيف في وضع التحريك، كما هو موضّح في التعرّف على وضع التحريك.
إذا حذف تطبيقك الزر Action.PAN من شريط إجراءات الخريطة، لن يتلقّى إدخال المستخدم من طُرق SurfaceCallback، وسيغلق التطبيق المضيف أي وضع تحريك تم تفعيله سابقًا.
على شاشة تعمل باللمس، لا يظهر الزر تحريك.
التعرّف على وضع العرض الشامل
في وضع التحريك، يحوّل مضيف النموذج إدخال المستخدم من أجهزة الإدخال غير اللمسية، مثل وحدات التحكّم الدوّارة ولوحات اللمس، إلى طرق SurfaceCallback المناسبة. الاستجابة لإجراء المستخدم للدخول إلى وضع العرض الشامل أو الخروج منه
باستخدام طريقة setPanModeListener في NavigationTemplate.Builder
يمكن للمضيف إخفاء مكوّنات أخرى في واجهة المستخدم في النموذج أثناء استخدام وضع التحريك.