כשמשתמשים בתבניות הבאות, אפשר להוסיף תמיכה באינטראקציה של משתמשים עם המפות שיוצרים, למשל לאפשר להם לראות חלקים שונים במפה באמצעות שינוי מרחק התצוגה והזזה.
| תבנית | תמיכה ברמת API של אפליקציות לרכב |
|---|---|
NavigationTemplate |
2 |
(deprecated) |
4 |
(deprecated) |
4 |
(deprecated) |
5 (התבנית הוצגה) |
MapWithContentTemplate |
7 (template introduced) |
הטמעה של התקשרות חזרה לאינטראקטיביות
בממשק SurfaceCallback יש כמה שיטות של קריאה חוזרת שאפשר להטמיע כדי להוסיף אינטראקטיביות למפות שנוצרו באמצעות התבניות שבקטע הקודם:
| אינטראקציה | שיטה | תמיכה ברמת API של אפליקציות לרכב |
|---|---|---|
| לחיצה | onClick |
5 |
| אפשר לפתוח או לסגור אצבעות כדי לשנות את מרחק התצוגה | onScale |
2 |
| גרירה בנגיעה אחת | onScroll |
2 |
| הזזה בנגיעה אחת | onFling |
2 |
| לחיצה פעמיים |
(מארח התבנית קובע את מקדם ההמרה) |
2 |
| הזזה סיבובית במצב הזזה |
(המרחק נקבע על ידי ה-Templates Host) |
2 |
הוספה של סרגל פעולות במפה
בתבניות האלה יכולה להיות רצועת פעולות במפה, לפעולות שקשורות למפה כמו הגדלה והקטנה, מרכוז מחדש, הצגת מצפן ופעולות אחרות שאתם בוחרים להציג. סרגל הפעולות במפה יכול להכיל עד ארבעה לחצנים עם סמלים בלבד שאפשר לרענן בלי להשפיע על עומק המשימה. סרגל הפעולות מוסתר במצב לא פעיל ומופיע שוב במצב פעיל.
כדי לקבל קריאות חוזרות (callback) של אינטראקטיביות במפה, חובה להוסיף Action.PAN
לחצן בשורת הפעולות במפה. כשהמשתמש לוחץ על הלחצן הזזה, המארח עובר למצב הזזה, כמו שמתואר במאמר הסבר על מצב הזזה.
אם האפליקציה לא כוללת את הלחצן Action.PAN בסרגל הפעולות של המפה, היא לא מקבלת קלט משתמש מהשיטות SurfaceCallback, והמארח סוגר כל מצב הזזה שהופעל קודם.
במסך מגע, הלחצן הזזה לא מוצג.
הסבר על מצב הזזה
במצב פנורמה, המארח של התבנית מתרגם קלט משתמש ממכשירי קלט שאינם מגע, כמו בקרי חוגה ומשטחי מגע, לשיטות המתאימות של SurfaceCallback. השיטה setPanModeListener ב-NavigationTemplate.Builder משמשת למענה על פעולת המשתמש להפעלת מצב הפנורמה או ליציאה ממנו.
המארח יכול להסתיר רכיבים אחרים בממשק המשתמש בתבנית בזמן שהמשתמש נמצא במצב פנורמה.