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

גרסה 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 כולל אפליקציות לדוגמה שממחישות את השימוש ב-SDK של מפות Google בגרסה 3.1.0 Beta ל-Android.