تطبيق نمط مضلع للحدود

لتطبيق أنماط للخطوط والحشو على مضلّعات الحدود في طبقة ميزة:

1. أنشئ دالة مصنع أنماط تنفِّذ واجهة FeatureLayer.StyleFactory . تحدِّد هذه الدالة منطق التصميم لطبقة ميزة.

2. اتصل FeatureLayer.setFeatureStyle() لتطبيق دالة المصنع على طبقة الخصائص.

يوضّح مثال الخريطة التالي تمييز المضلّع الحدودي لمنطقة واحدة في طبقة عنصر "المنطقة المحلية".

إنشاء دالة مصنع للنمط

يتم تطبيق دالة "منشأة الأنماط" على كل مضلّع في طبقة العناصر المتأثرة في وقت ضبط الدالة على طبقة العناصر. يجب أن تُعرِض هذه الدالة FeatureStyle كائنًا يحدِّد كيفية وضع تنسيق على المضلّع.

تجتاز حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android Feature لدالة مصنع النمط. يمثل المثيل Feature بيانات التعريف الخاصة بالميزات، مما يتيح لك الوصول إلى بيانات التعريف في مصنع الأنماط الأخرى.

يجب أن تعرِض دالة "مُنشئ الأنماط" دائمًا نتائج متسقة عند تطبيقها. على سبيل المثال، إذا أردت تلوين مجموعة من العناصر بشكل عشوائي، يجب ألا يقع الجزء العشوائي في دالة نمط العناصر، لأنّ ذلك قد يؤدي إلى نتائج غير مقصودة.

ولأن هذه الدالة تعمل على كل ميزة في الطبقة، فإن التحسين التحليل. لتجنُّب التأثير في مُدد العرض:

• تمكين طبقات الميزات التي تحتاجها فقط.

• اتصل بالرقم FeatureLayer.setFeatureStyle(null) عندما لا تكون إحدى طبقات العناصر قيد الاستخدام.

ضبط تعبئة المضلّع وضربه

عند تصميم مضلّع حدود في دالة مصنع الأنماط، يمكنك تعيين:

• لون الخطوط وعتمتها لحدود المضلّع بتنسيق ألوان ARGB، على النحو المحدّد من قِبل فئة Color القيمة التلقائية هي شفافة (0x00000000).

• عرض الخط لحدود المضلّع في وحدات بكسل الشاشة. القيمة التلقائية هي 2.

• املأ اللون ودرجة التعتيم للمضلّع بتنسيق ألوان ARGB، على النحو التالي: المحددة من خلال Color الصف. تكون القيمة التلقائية شفافة (0x00000000).

البحث عن أرقام تعريف الأماكن لاستهداف العناصر

تطبق العديد من التطبيقات أنماطًا على ميزة استنادًا إلى موقع الميزة. بالنسبة على سبيل المثال، قد ترغب في تطبيق النمط على بلدان أو مناطق أو الإقليمية. يتم تمثيل الموقع الجغرافي للعنصر باستخدام رقم تعريف المكان.

تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى Google. و"خرائط Google". للحصول على رقم تعريف مكان، اتّبِع الخطوات التالية:

• استخدام واجهات برمجة تطبيقات الأماكن والترميز الجغرافي للبحث عن المناطق حسب الاسم، والحصول على أرقام تعريف الأماكن لمناطق داخل حدودًا محددة.
• الحصول على البيانات من أحداث النقر يعرض هذا الإجراء العنصر المقابل للمنطقة التي تم النقر عليها، ما يتيح الوصول إلى معرّف المكان وفئة نوع العنصر.

تختلف التغطية حسب المنطقة. عرض تغطية حدود Google لمزيد من التفاصيل.

تتوفّر الأسماء الجغرافية من العديد من المصادر، مثل مجلس أسماء الأماكن الجغرافية في هيئة المسح الجيولوجي الأمريكية، وملفات فهرس الولايات المتحدة.

استخدام PlaceFeature للحصول على معرّف مكان

فئة PlaceFeature هي فئة فرعية لفئة Feature. ويمثّل عنصر مكان (عنصر يتضمّن رقم تعريف مكان) يتضمّن عناصر من النوع ADMINISTRATIVE_AREA_LEVEL_1 وADMINISTRATIVE_AREA_LEVEL_2 COUNTRY وLOCALITY وPOSTAL_CODE وSCHOOL_DISTRICT.

عندما يكون رقم تعريف المكان متاحًا، تمرر حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android نسخة من PlaceFeature إلى مصنع الأنماط. بحيث يمكنك تحديد موقع العنصر.

مثال على مصنع الأنماط

يطبق هذا المثال دالة مصنع الأنماط على مضلّع في المنطقة طبقة الخصائص. تحدِّد دالة "منشأة الأنماط" رقم تعريف المكان للعنصر باستخدام مثيل PlaceFeature. إذا كان معرّف المكان هو "هانا"، هاواي، ثم تطبّق الدالة نمطًا مخصّصًا للتعبئة والخطوط على المضلع:

1. اتّبِع الخطوات الواردة في البدء لإنشاء رقم تعريف جديد للخريطة ونمط جديد للخريطة، إذا لم يسبق لك إجراء ذلك. احرص على تفعيل المنطقة المحلية طبقة الخصائص.

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"). إذا كان معرف المكان المحدد ليس لـ 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).