מתחילים

בחירת פלטפורמה: Android iOS JavaScript

כדי להגדיר עיצוב מבוסס-נתונים לגבולות, פועלים לפי השלבים הבאים:

הפעלת הכלי החדש לעיבוד מפות

מעבד מפות משודרג זמין החל מגרסה 18.0.0 של SDK של מפות ל-Android. ה-renderer הזה מביא שיפורים רבים ל-SDK של מפות ל-Android, כולל תמיכה בעיצוב מפות מבוסס-ענן.

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

יצירת מזהה מפה

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

יצירת סגנון מפה חדש

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

בחירת שכבות התכונות בסגנון המפה החדש

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

  1. במסוף Google API, עוברים לדף Map Styles.
  2. אם מתבקשים, בוחרים פרויקט.
  3. בוחרים סגנון מפה.
  4. לוחצים על התפריט הנפתח שכבות תכונות כדי להוסיף או להסיר שכבות.
  5. לוחצים על שמירה כדי לשמור את השינויים ולהפוך אותם לזמינים במפות.

צילום מסך שבו מוצגת התפריט הנפתח.

עדכון קוד האתחול של המפה

בשלב הזה צריך את מזהה המפה שיצרתם. הוא מופיע בדף ניהול מפות Google.

במאמר הוספת מזהה המפה לאפליקציה מוסבר איך מוסיפים את מזהה המפה לקוד האתחול.

קבלת גישה לשכבת תכונות של מפה

משתמשים באובייקט FeatureLayer כדי לייצג כל שכבת תכונות של מפה, כמו שכבת תכונות של מיקוד או שכבת תכונות של יישוב. כדי לקבל גישה לאובייקט של שכבת תכונות, צריך להפעיל את GoogleMap.getFeatureLayer() כשהמפה מופעלת:

Java

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Kotlin

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

מעבירים אובייקט FeatureLayerOptions אל getFeatureLayer() כדי לציין את הסוג של שכבת התכונות. בדוגמה הזו, רוצים לגשת לשכבה POSTAL_CODE. יוצרים אובייקט FeatureLayer שונה לכל שכבה שרוצים לעצב.

אחרי שיוצרים את האובייקט FeatureLayer, אפשר להחיל סגנון על הפוליגונים של הגבולות בתכונה הזו.

בדיקת היכולות של המפה (חובה)

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

Kotlin

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Java

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());