באמצעות ה-SDK של מפות Google ל-Android תוכלו להתאים אישית את האינטראקציה של המשתמשים עם המפה שלכם, על ידי קביעה אילו רכיבים בממשק המשתמש יופיעו במפה ואילו תנועות מותרות.
דוגמאות קוד
מאגר ApiDemos ב-GitHub כולל דגימה שמדגימה את השימוש באפשרויות הבקרה והתנועות:
- UiSettingsDemoActivity: דגימת Java
- UiSettingsDemoActivity: דגימה מ-Kotlin
מצב בסיסי לאינטראקציה מינימלית של המשתמש
אם אתם רוצים מפה קלה עם אינטראקציה מינימלית של המשתמשים, כדאי להשתמש במפה במצב בסיסי. מצב Lite כולל תמונת מפת סיביות של מפה במיקום וברמת זום מסוימים. במצב Lite, המשתמשים לא יכולים להזיז את המפה או לשנות את מרחק התצוגה והתנועות לא פועלות. לפרטים נוספים אפשר לעיין במדריך למצב בסיסי.
פקדים בממשק המשתמש
ה-API של מפות Google מציע פקדים מובנים בממשק המשתמש, כמו אלו הזמינים באפליקציית מפות Google בטלפון Android. אפשר להחליף את רמת הגישה של אמצעי הבקרה האלה באמצעות המחלקה UiSettings, שאפשר לקבל מ-GoogleMap באמצעות השיטה GoogleMap.getUiSettings. השינויים לכיתה הזו יבואו לידי ביטוי באופן מיידי במפה. כדי לראות דוגמה לתכונות האלה, עיינו בפעילות ההדגמה של הגדרות ממשק המשתמש באפליקציה לדוגמה.
אפשר גם להגדיר את רוב האפשרויות האלה כשהמפה נוצרת באמצעות מאפייני XML, או באמצעות המחלקה GoogleMapOptions. לפרטים נוספים, אפשר לעיין במאמר הגדרת מצב ראשוני.
לכל פקד של ממשק משתמש יש מיקום שנקבע מראש ביחס לקצה המפה.
אפשר להזיז את הפקדים מהקצה העליון, התחתון, שמאל או ימין על ידי הוספת מרווח פנימי לאובייקט GoogleMap.
פקדי זום
ה-API של מפות Google כולל פקדי זום מובנים שמופיעים בפינה השמאלית התחתונה של המפה. האפשרויות האלה מושבתות כברירת מחדל, אבל אפשר להפעיל אותן על ידי קריאה ל-UiSettings.setZoomControlsEnabled(true).
מצפן
ה-API של מפות Google מספק גרפיקה של מצפן, שמוצגת בפינה הימנית העליונה של המפה בנסיבות מסוימות. המצפן יופיע רק כשהמצלמה מוכוונת, כך שזווית הכיוון שלו היא אפס או אפס. כשהמשתמש לוחץ על המצפן, המצלמה מבצעת אנימציה בחזרה למיקום עם זווית והטיה של אפס (כיוון ברירת המחדל), והמצפן מתעמעם זמן קצר לאחר מכן. תוכלו להשבית לגמרי את המצפן שמופיע על ידי התקשרות אל UiSettings.setCompassEnabled(boolean).
עם זאת, לא ניתן לאלץ את המצפן להיות מוצג תמיד.
הלחצן 'המיקום שלי'
הלחצן 'המיקום שלי' מופיע בפינה השמאלית העליונה של המסך רק כששכבת 'המיקום שלי' מופעלת. מידע נוסף זמין במדריך לנתוני מיקום.
בוחר רמות
כברירת מחדל, בוחר הקומות (בוחר הקומות) מופיע ליד הקצה השמאלי המרכזי של המסך כשהמשתמש צופה במפת פנים. כשמוצגות שתי מפות פנימיות או יותר, בוחר הרמות יחול על הבניין שנמצא כרגע במוקד, שהוא בדרך כלל הקרוב ביותר למרכז המסך. לכל מבנה יש רמת ברירת מחדל שתיבחר בפעם הראשונה שהבורר מוצג. המשתמשים יכולים לבחור רמה אחרת על ידי בחירתה בבורר.
כדי להשבית או להפעיל את הבורר של הרמה, צריך לבצע קריאה ל-GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean).
האפשרות הזו שימושית אם אתם רוצים להחליף את בוחר ברירת המחדל ברמה בבורר קיים.
סרגל הכלים של המפה
כברירת מחדל, סרגל כלים מופיע בפינה השמאלית התחתונה של המפה כשמשתמש לוחץ על סמן. סרגל הכלים מאפשר למשתמשים לגשת במהירות לאפליקציה לנייד של מפות Google.
אפשר להפעיל ולהשבית את סרגל הכלים באמצעות הפקודה UiSettings.setMapToolbarEnabled(boolean).
במפת מצב בסיסי סרגל הכלים ממשיך לפעול בנפרד מפעולות המשתמש. במפה אינטראקטיבית לחלוטין, סרגל הכלים נכנס פנימה כשהמשתמש מקיש על סמן ומחליק שוב החוצה כשהסמן כבר לא בפוקוס.
סרגל הכלים מציג סמלים שמספקים גישה לתצוגת מפה או בקשת מסלול באפליקציה לנייד של מפות Google. כשמשתמש מקיש על סמל בסרגל הכלים, ה-API יוצר כוונת רכישה כדי להפעיל את הפעילות המתאימה באפליקציה לנייד של מפות Google.
סרגל הכלים גלוי בפינה השמאלית התחתונה של המפה בצילום המסך שלמעלה. אפס או אחד מהסמלים של הכוונה יופיעו במפה, בהתאם לתוכן המפה, בתנאי שהאפליקציה של מפות Google לנייד תומכת בכוונה שמתקבלת.
תנועות במפה
מפה שנוצרה באמצעות SDK של מפות ל-Android תומכת באותן תנועות כמו באפליקציה של מפות Google. עם זאת, במצבים מסוימים כדאי להשבית תנועות מסוימות כדי לשמור על מצב המפה. אפשר גם להגדיר את הזום, ההטיה וההטיה ולבצע גם פעולות פרוגרמטיות – לפרטים נוספים, ראו מצלמה ותצוגה. שימו לב שהשבתת תנועות לא משפיעה על האפשרות לשנות את מיקום המצלמה באופן פרוגרמטי.
בדומה לפקדי ממשק המשתמש, אפשר להפעיל או להשבית תנועות ברמה UiSettings באמצעות הפונקציה GoogleMap, על ידי קריאה ל-GoogleMap.getUiSettings. השינויים שייעשו בכיתה הזו יבואו לידי ביטוי מיד במפה. רוצה לראות דוגמה לתכונות האלה? אפשר לעיין בפעילות ההדגמה של הגדרות ממשק המשתמש באפליקציה לדוגמה (כאן מוסבר איך להתקין אותה.
אפשר להגדיר את האפשרויות האלה גם אם המפה נוצרת באמצעות מאפייני ה-XML או באמצעות המחלקה GoogleMapOptions.
לפרטים נוספים, אפשר לעיין בהגדרת המפה.
תנועות לשינוי מרחק התצוגה
המפה מגיבה למגוון תנועות שיכולות לשנות את רמת הזום של המצלמה:
- מקישים פעמיים כדי להגדיל את המרחק מהתצוגה ב-1 (התקרבות).
- מקישים על שתי אצבעות כדי להקטין את המרחק מהתצוגה ב-1 (התרחקות).
- מתיחה או מתיחה של שתי אצבעות
- באצבע אחת זום על ידי הקשה כפולה, אך לא שחרור מההקשה השנייה, ולאחר מכן מחליקים את האצבע למעלה כדי להתרחק או למטה כדי להתקרב.
כדי להשבית את הזום, התקשר ל-UiSettings.setZoomGesturesEnabled(boolean). לא תהיה לכך השפעה על האפשרות של המשתמש להשתמש בפקדי הזום כדי להגדיל או להקטין את התצוגה.
גלילה (תנועה)
משתמש יכול לגלול (להזיז) את המפה על ידי גרירת המפה עם האצבע.
כדי להשבית את הגלילה, אפשר לבצע שיחה למספר UiSettings.setScrollGesturesEnabled(boolean).
הטיה
משתמש יכול להטות את המפה על ידי מיקום שתי אצבעות על המפה ולהזיז אותן כלפי מעלה או כלפי מעלה יחד, כדי להגדיל או להקטין את זווית ההטיה בהתאמה. אפשר להשבית את תנועות ההטיה על ידי קריאה אל UiSettings.setTiltGesturesEnabled(boolean).
סיבוב תנועות
משתמש יכול לסובב את המפה על ידי הנחת שתי אצבעות על המפה והחלת תנועה של סיבוב. אפשר להשבית את הסבב על ידי קריאה אל UiSettings.setRotateGesturesEnabled(boolean).