שימוש ב-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().

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

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

  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 בגרסת v3.1.0 ל-Android.