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

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

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

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

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

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

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

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

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

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

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

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

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

יצירת קו פוליגוני עם מעבר צבע

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

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

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

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

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

  1. מייבאים את ספריית כלי השירות שתואמת לגרסת הבטא בקובץ 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'