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

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

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

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

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

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

צילום מסך שבו מוצג המפולגון של Hana Hawaii.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שמות גיאוגרפיים זמינים ממקורות רבים, כגון USGS Board on geo Name, את הרצף ארה"ב קובצי Gazetteer.

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

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

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

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

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

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