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

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

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

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

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

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

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

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

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

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

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

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

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

יצירת קו פוליגוני עם הדרגתיות

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

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

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