עיצוב פוליגון גבול

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

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

1. יוצרים פונקציית מפעל של סגנון שמטמיעה את הממשק FeatureLayer.StyleFactory. הפונקציה הזו מגדירה את הלוגיקה של סגנון השכבה.

2. קוראים לפונקציה FeatureLayer.setFeatureStyle() כדי להחיל את פונקציית מפעל הסגנון על שכבת התכונות.

במפה לדוגמה הבאה מודגשת פוליגון הגבול של אזור יחיד בשכבת תכונות של יישוב.

יצירת פונקציית ייצור של סגנון

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

הערה: אם מעדכנים או משנים את פונקציית המפעל של הסגנון בשכבת תכונות, צריך לבצע קריאה חוזרת ל-FeatureLayer.setFeatureStyle() כדי לאפס את הפונקציה בשכבת התכונות.

ה-SDK של מפות ל-Android מעביר מופע של Feature לפונקציית המפעל של הסגנון. המכונה Feature מייצגת את המטא-נתונים של התכונה, ומספקת גישה למטא-נתונים בפונקציית המפעל של הסגנון.

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

הפונקציה הזו פועלת על כל התכונות בשכבה, ולכן חשוב לבצע אופטימיזציה. כדי להימנע מהשפעה על זמני העיבוד:

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

• צריך לקרוא ל-FeatureLayer.setFeatureStyle(null) כששכבת תכונות לא בשימוש יותר.

הגדרת קווים ומילוי של פוליגון

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

• צבע ושקיפות הקו של גבול הפוליגון בפורמט הצבע ARGB, כפי שהוגדר על ידי הכיתה Color. ערך ברירת המחדל הוא שקוף (0x00000000).

• עובי הקו של גבול הפוליגון בפיקסלים של המסך. ערך ברירת המחדל הוא 2.

• צבע המילוי והעכירות של הפוליגון בפורמט הצבע ARGB, כפי שמוגדר על ידי הכיתה Color. ערך ברירת המחדל הוא שקוף (0x00000000).

חיפוש מזהי מקומות לטירגוט תכונות

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

המזהה הייחודי של מקום במסד הנתונים של 'מקומות Google' ובמפות Google. כדי לקבל מזהה מקום:

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

הכיסוי משתנה בהתאם לאזור. פרטים נוספים זמינים במאמר היקף הכיסוי של גבולות Google.

שמות גיאוגרפיים זמינים ממקורות רבים, כמו המועצה של USGS לשמות גיאוגרפיים וקובצי ה-Gazetteer של ארה"ב.

שימוש ב-PlaceFeature כדי לקבל מזהה מקום

הכיתה PlaceFeature היא Subclass של הכיתה Feature. הוא מייצג מאפיין מקום (מאפיין עם מזהה מקום) שכולל מאפיינים מסוג ADMINISTRATIVE_AREA_LEVEL_1,‏ ADMINISTRATIVE_AREA_LEVEL_2,‏ COUNTRY,‏ LOCALITY,‏ POSTAL_CODE ו-SCHOOL_DISTRICT.

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

דוגמה למפעל סגנונות

בדוגמה הזו מחילים פונקציית סגנון של מפעל על פוליגון בשכבת התכונות Locality. פונקציית המפעל של הסגנון קובעת את מזהה המקום של התכונה באמצעות המופע PlaceFeature. אם מזהה המקום הוא של Hana,‏ Hawaii, הפונקציה מחילה על הפוליגון סגנון מילוי וקווי מתאר בהתאמה אישית:

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

2. קבלת הפניה לשכבת התכונות של 'יישוב' כשהמפה מופעלת.

   Java

   private FeatureLayer localityLayer;
   
   @Override
   public void onMapReady(GoogleMap map) {
     // Get the LOCALITY feature layer.
     localityLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
       .featureType(FeatureType.LOCALITY)
       .build());
   
     // Apply style factory function to LOCALITY layer.
     styleLocalityLayer();
   }

   Kotlin

   private var localityLayer: FeatureLayer? = null
   
   override fun onMapReady(googleMap: GoogleMap) {
     // Get the LOCALITY feature layer.
     localityLayer = googleMap.getFeatureLayer(FeatureLayerOptions.Builder()
       .featureType(FeatureType.LOCALITY)
       .build())
   
     // Apply style factory function to LOCALITY layer.
     styleLocalityLayer()
   }

3. יוצרים פונקציית סגנון ומחילים אותה על שכבת התכונה Locality.

   בדוגמה הבאה, הפונקציה חלה רק אם מזהה המקום של התכונה הוא של Hana, Hawaii‏ ("ChIJ0zQtYiWsVHkRk8lRoB1RNPo"). אם מזהה המקום שצוין לא שייך ל-Hana שבהוואי, הסגנון לא יחול.

   Java

   private void styleLocalityLayer() {
   
     // Create the style factory function.
     FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
   
       // Check if the feature is an instance of PlaceFeature,
       // which contains a place ID.
       if (feature instanceof PlaceFeature) {
         PlaceFeature placeFeature = (PlaceFeature) feature;
   
         // Determine if the place ID is for Hana, HI.
         if (placeFeature.getPlaceId().equals("ChIJ0zQtYiWsVHkRk8lRoB1RNPo")) {
   
           // Use FeatureStyle.Builder to configure the FeatureStyle object
           // returned by the style factory function.
           return new FeatureStyle.Builder()
             // Define a style with purple fill at 50% opacity and solid purple border.
             .fillColor(0x80810FCB)
             .strokeColor(0xFF810FCB)
             .build();
         }
       }
       return null;
     };
   
     // Apply the style factory function to the feature layer.
     localityLayer.setFeatureStyle(styleFactory);
   }

   Kotlin

   private fun styleLocalityLayer() {
   
     // Create the style factory function.
     val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
   
         // Check if the feature is an instance of PlaceFeature,
         // which contains a place ID.
         if (feature is PlaceFeature) {
             val placeFeature: PlaceFeature = feature as PlaceFeature
   
             // Determine if the place ID is for Hana, HI.
             if (placeFeature.getPlaceId().equals("ChIJ0zQtYiWsVHkRk8lRoB1RNPo")) {
   
                 // Use FeatureStyle.Builder to configure the FeatureStyle object
                 // returned by the style factory function.
                 return@StyleFactory FeatureStyle.Builder()
                     // Define a style with purple fill at 50% opacity and
                     // solid purple border.
                     .fillColor(0x80810FCB.toInt())
                     .strokeColor(0xFF810FCB.toInt())
                     .build()
             }
         }
         return@StyleFactory null
     }
   
     // Apply the style factory function to the feature layer.
     localityLayer?.setFeatureStyle(styleFactory)
   }

הסרת סגנון משכבה

כדי להסיר עיצוב משכבה, קוראים לפונקציה FeatureLayer.setFeatureStyle(null).