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

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

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

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

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

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

צילום מסך שבו מוצג מצולע של Hana Hawaii.

יצירת פונקציית יצירת סגנונות

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

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

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

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

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

  • ‫Call FeatureLayer.setFeatureStyle(null) כששכבה במפה לא נמצאת יותר בשימוש.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. מקבלים הפניה לשכבת התכונות Locality כשהמפה מאותחלת.

    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"). אם מזהה המקום שצוין לא מתייחס להאנה שבהוואי, הסגנון לא יוחל.

    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).