שימוש ב-SDK של מפות ל-Android בגרסה 3.1.0 BETA

גרסה 3.1.0 בטא של SDK של מפות Google ל-Android היא הטמעה חדשה עם אותה ממשק API כמו בגרסה הקודמת (כל הכיתות והשיטות נשארות זהות), ועם כמה תכונות חדשות שאפשר לנסות:

  • התאמה אישית של מפות Google
  • טיפול בחפיפה של סמנים
  • התאמה אישית של קו פוליגוני

במדריך הזה נסביר איך להשתמש בתכונות החדשות.

התאמה אישית של מפות Google (בטא)

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

טיפול בחפיפה בין סמנים (בטא)

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

התאמה אישית של קו פוליגוני (בטא)

עכשיו יש כמה דרכים חדשות להתאמה אישית של המראה של קווים פוליגונליים:

  • קווים פוליגוניים בצבעים שונים מגדירים צבעים שונים לקטעי הקווים הפוליגוניים.
  • קווים פוליגונים עם שינוי הדרגתי צובעים קו פוליגון באמצעות שינוי הדרגתי של שני צבעים.
  • קווים פוליגונים בחותמת – סגנון של קו פוליגון באמצעות בימפטים חוזרים.

יצירת קו מרובה צבעוני

אפשר להשתמש ב-spans כדי לצבוע פלחים ספציפיים של קו פוליגון. לשם כך, יוצרים אובייקטים מסוג StyleSpan ומוסיפים אותם ל-PolylineOptions באמצעות השיטות addSpan() או addSpans(). כברירת מחדל, כל פריט במערך מגדיר את הצבע של מקטע הקו המתאים.

יצירת קו פוליגון עם שיפוע

כדי להגדיר שיפוע, מציינים שני מספרים שלמים של 32 ביט מסוג alpha-red-green-blue‏ (ARGB) כדי לציין את צבעי ההתחלה והסיום של הקו. מגדירים את המאפיין הזה באובייקט האפשרויות של הצורה באמצעות קריאה ל-PolylineOptions.addSpan().

יצירת קו מרובה עם חותמת

אפשר להגדיר את המראה של קו מרובע כטקסטורת ביפ-מפט חוזרת. כדי לעשות זאת, יוצרים StampStyle של TextureStyle, ואז מגדירים את המאפיין הזה באובייקט האפשרויות של הצורה באמצעות קריאה ל-PolylineOptions.addSpan().

ייבוא ספריית השירותים התואמת לגרסת הבטא

אם אתם משתמשים בספריית התמיכה של Google Maps Android API, עליכם גם לעדכן את יחסי התלות בפרויקט כדי להחליף את הגרסה הקיימת בגרסה התואמת לגרסת הבטא. לשם כך, פועלים לפי השלבים הבאים:

  1. מייבאים את ספריית ה-util התואמת לגרסת הבטא לקובץ build.gradle: 
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. כדי להסיר את ספריית התמיכה שלא תואמת לגרסת הבטא, מסירים את הפריטים הבאים מ-build.gradle: 
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

הרצת הדוגמאות

במאגר Google Samples ב-GitHub יש אפליקציות לדוגמה שממחישות את השימוש ב-Maps SDK לגרסה 3.1.0 Beta ל-Android.