إنشاء خريطة توزيعات ذات تظليل مساحي

اختيار النظام الأساسي: Android iOS JavaScript

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

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

ملاحظة: عادةً ما يتمّ تحديد جدول للّون لكلّ ولاية، ثمّ يتمّ البحث عن اللون لكلّ ولاية استنادًا إلى معرّف مكان الولاية.

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

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

   Java

   private FeatureLayer areaLevel1Layer;
   
   @Override
   public void onMapReady(GoogleMap map) {
     areaLevel1Layer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
       .featureType(FeatureType.ADMINISTRATIVE_AREA_LEVEL_1)
       .build());
   
     // Apply style factory function to ADMINISTRATIVE_AREA_LEVEL_1 layer.
     styleAreaLevel1Layer();
   }

   Kotlin

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

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

   Java

   private void styleAreaLevel1Layer() {
     FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
       if (feature instanceof PlaceFeature) {
         PlaceFeature placeFeature = (PlaceFeature) feature;
   
         // Return a hueColor in the range [-299,299]. If the value is
         // negative, add 300 to make the value positive.
         int hueColor = placeFeature.getPlaceId().hashCode() % 300;
         if (hueColor < 0) {
           hueColor += 300;
         }
   
         return new FeatureStyle.Builder()
           // Set the fill color for the state based on the hashed hue color.
           .fillColor(Color.HSVToColor(150, new float[] {hueColor, 1, 1}))
           .build();
       }
       return null;
     };
   
     // Apply the style factory function to the feature layer.
     areaLevel1Layer.setFeatureStyle(styleFactory);
   }

   Kotlin

   private fun styleAreaLevel1Layer() {
     val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
         if (feature is PlaceFeature) {
             val placeFeature: PlaceFeature = feature as PlaceFeature
   
             // Return a hueColor in the range [-299,299]. If the value is
             // negative, add 300 to make the value positive.
             var hueColor: Int = placeFeature.getPlaceId().hashCode() % 300
             if (hueColor < 0) {
                 hueColor += 300
             }
             return@StyleFactory FeatureStyle.Builder()
             // Set the fill color for the state based on the hashed hue color.
               .fillColor(Color.HSVToColor(150, floatArrayOf(hueColor.toFloat(), 1f, 1f)))
               .build()
         }
         return@StyleFactory null
     }
   
     // Apply the style factory function to the feature layer.
     areaLevel1Layer?.setFeatureStyle(styleFactory)
   }