פקדים ותנועות

באמצעות SDK של מפות ל-Android תוכלו להתאים אישית את האופן שבו משתמשים יכולים ליצור אינטראקציה עם המפה שלכם, על ידי קביעת אילו מהרכיבים המובנים של ממשק המשתמש יופיעו במפה ואילו תנועות מותרות.

דוגמאות קוד

מאגר ApiDemos ב-GitHub כולל דוגמה שממחישה את השימוש באפשרויות הבקרה והתנועות:

• UiSettingsDemoActivity: דוגמת Kotlin
• UiSettingsDemoActivity: דוגמת Java

מצב בסיסי לאינטראקציה מינימלית של משתמשים

אם אתם רוצים מפה קלילה עם אינטראקציה מינימלית של המשתמש, עדיף להשתמש במפה במצב Lite. מצב Lite מציע תמונה של מפת סיביות (bitmap) של מפה במיקום מסוים וברמת זום מסוימת. במצב Lite, המשתמשים לא יכולים להזיז את המפה או לשנות את מרחק התצוגה שלה, והתנועות לא פועלות. לפרטים נוספים, אפשר לעיין במדריך למצב Lite.

פקדים בממשק המשתמש

ה-API של מפות Google כולל פקדים מובנים בממשק המשתמש, שדומים לאלו שניתן למצוא באפליקציית מפות Google בטלפון Android. אפשר להציג או להסתיר את אמצעי הבקרה האלו באמצעות המחלקה UiSettings, שניתן לקבל מ-GoogleMap באמצעות ה-method GoogleMap.getUiSettings. שינויים שיבוצעו בכיתה הזו יופיעו מיד במפה. כדי לראות דוגמה לתכונות האלו, אפשר לעיין בפעילות ההדגמה של הגדרות ממשק המשתמש באפליקציה לדוגמה.

אפשר גם להגדיר את רוב האפשרויות האלה כשיוצרים את המפה באמצעות מאפייני XML או באמצעות המחלקה GoogleMapOptions. פרטים נוספים זמינים במאמר הגדרת המצב הראשוני.

לכל פקד בממשק המשתמש יש מיקום שנקבע מראש ביחס לקצה המפה. אפשר להרחיק את הפקדים מהקצה העליון, התחתון, השמאלי או הימני על ידי הוספת מרווח פנימי לאובייקט GoogleMap.

פקדים לשינוי מרחק התצוגה

ה-API של מפות Google כולל פקדים מובנים לשינוי מרחק התצוגה שמופיעים בפינה השמאלית התחתונה של המפה. הם מושבתים כברירת מחדל, אבל אפשר להפעיל אותם באמצעות שליחת קריאה ל-UiSettings.setZoomControlsEnabled(true).

מצפן

ממשק ה-API של מפות Google מציג גרפיקה של מצפן שמופיעה בפינה השמאלית העליונה של המפה בנסיבות מסוימות. המצפן יופיע רק כשהמצלמה מכווננת כך שיש לה כיוון שאינו אפס או הטיה שאינה אפס. כשהמשתמש לוחץ על המצפן, המצלמה מבצעת אנימציה בחזרה למיקום עם כיוון והטיה של אפס (כיוון ברירת המחדל) והמצפן מתעמעם זמן קצר לאחר מכן. אפשר להשבית את המצפן עצמו על ידי קריאה ל-UiSettings.setCompassEnabled(boolean). עם זאת, אי אפשר לאלץ את המצפן להופיע תמיד.

לחצן 'המיקום שלי'

הלחצן 'המיקום שלי' מופיע בפינה השמאלית העליונה של המסך רק כאשר שכבת 'המיקום שלי' מופעלת. למידע נוסף, עיינו במדריך לנתוני מיקום.

בחירת רמה

כברירת מחדל, בוחר רמות (בורר קומה) מופיע ליד הקצה השמאלי המרכזי של המסך כשהמשתמש צופה במפת פנים. כשמוצגות שתי מפות פנים או יותר, בוחר הקומות יחול על המבנה שנמצא כרגע במוקד, שהוא בדרך כלל זה הקרוב ביותר למרכז המסך. לכל בניין יש רמת ברירת מחדל שתיבחר בפעם הראשונה שהבורר יוצג. המשתמשים יכולים לבחור רמה אחרת באמצעות הבורר.

אפשר להשבית או להפעיל את הכלי לבחירת רמות באמצעות קריאה ל-GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean).

האפשרות הזו שימושית אם רוצים להחליף את בורר ברירת המחדל ברמת המודעה שלכם.

סרגל הכלים של המפה

כברירת מחדל, סרגל כלים מופיע בפינה השמאלית התחתונה של המפה כשמשתמש מקיש על סמן. סרגל הכלים מאפשר למשתמש גישה מהירה לאפליקציית מפות Google לנייד.

אפשר להפעיל או להשבית את סרגל הכלים באמצעות קריאה ל-UiSettings.setMapToolbarEnabled(boolean).

במפה במצב Lite, סרגל הכלים ממשיך להופיע בנפרד לפעולות המשתמש. במפה אינטראקטיבית מלאה, סרגל הכלים מחליק במסך כשהמשתמש מקיש על סמן ומחליק החוצה שוב כשהסמן לא נמצא במוקד.

בסרגל הכלים מוצגים סמלים שמאפשרים גישה לתצוגת מפה או לבקשת מסלול באפליקציה לנייד של מפות Google. כשמשתמש מקיש על סמל בסרגל הכלים, ממשק ה-API יוצר כוונה להפעלת הפעילות המתאימה באפליקציה לנייד של מפות Google.

סרגל הכלים מופיע בפינה השמאלית התחתונה של המפה בצילום המסך שלמעלה. אפס, אחד מסמלי ה-Intent או שניהם יופיעו במפה, בהתאם לתוכן המפה ובתנאי שהאפליקציה לנייד של מפות 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).