تغيير مظهر FeatureView

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

عنصر النمط

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

{
  // Broad style rules.
  opacity: …,
  polygonFillColor: …,

  // Specific style rules.
  rules: [
    { … },
    { … }
  ]
};

القواعد العامة

لتطبيق خصائص النمط على جميع المعالم (أو تلك التي تنتمي إلى نوع هندسي معيّن)، حدِّد خصائص النمط في المستوى الأعلى في عنصر النمط.

{
  opacity: 0.5,
  pointShape: 'triangle',
  lineWidth: 10,
  polygonFillColor: 'green'
};

قواعد محدّدة

لتطبيق خصائص النمط على مجموعة فرعية من العناصر، استخدِم الحقل rules. يقبل الحقل rules قائمة بكائنات JavaScript، يحتوي كل منها على filter يختار المعالم وفقًا للشروط المحدّدة بواسطة كائن ee.Filter، متبوعًا بسلسلة من سمات النمط. في المثال أدناه، هناك قاعدة تضبط polygonStrokeWidth وpolygonFillColor فقط إذا كانت السمة "REP_AREA" أقل من 100. وتلغي القواعد المحدّدة خصائص النمط للقواعد العامة، كما تلغي القواعد التي تقع بالقرب من نهاية قائمة rules القواعد التي تقع بالقرب من البداية (يتم تقييم القواعد المحدّدة من البداية إلى النهاية).

{
  rules: [
    {
      filter: ee.Filter.lt('REP_AREA', 100),
      polygonStrokeWidth: 0.5,
      polygonFillColor: 'blue'
    },
    { … }  // Optionally include additional rules.
  ]
};

ضبط النمط

يمكن ضبط نمط العنصر عند الإعلان عن FeatureViewLayer أو في أي وقت بعد ذلك.

نموذج بيان واحد (FeatureViewLayer)

لضبط مَعلمات العرض المرئي عند تعريف FeatureViewLayer، استخدِم المَعلمة visParams.

var visParams = {
  opacity: 0.5,
  lineWidth: 10,
  polygonFillColor: 'purple'
};

var layer = ui.Map.FeatureViewLayer({
  assetId: 'WCMC/WDPA/current/polygons_FeatureView',
  visParams: visParams
});

Map.add(layer);

FeatureViewLayer الحالية

لضبط مَعلمات العرض لـ FeatureViewLayer حالي، استخدِم الدالة setVisParams. يحلّ محل أي قواعد نمط محددة مسبقًا؛ يتم تعيين الخصائص غير المحددة على الإعدادات الافتراضية.

var layer = ui.Map.FeatureViewLayer('WCMC/WDPA/current/polygons_FeatureView');
Map.add(layer);

layer.setVisParams({
  opacity: 0.5,
  lineWidth: 10,
  polygonFillColor: 'purple'
});

التعبير بالرموز

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

ثابت

تتألف قاعدة النمط الثابت من سمة نمط يتم ضبطها وقيمتها. يضبط المثال التالي لون تعبئة المضلّع على الأزرق.

var visParams = {
  polygonFillColor: 'blue'
};

فئوي

تتكوّن قاعدة النمط الفئوي من سمة نمط يتم ضبطها وكائن JavaScript يتضمّن ثلاث سمات:

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

على سبيل المثال، يضبط العنصر التالي سمة النمط color استنادًا إلى سمة العنصر "MARINE". يتم ضبط الميزات في الفئة "MARINE"‏ "0" على اللون الأرجواني، و"1" على اللون الأخضر، و"2" على اللون الأزرق، وأي فئة أخرى على اللون الأبيض.

var visParams = {
  color: {
    property: 'MARINE',
    categories: [
      ['0', 'purple'],
      ['1', 'green'],
      ['2', 'blue']
    ],
    defaultValue: 'white'
  }
};

مُحتسَب

تتألف قاعدة النمط المُدرَج من سمة نمط يتم ضبطها وكائن JavaScript يحتوي على ما يصل إلى خمس سمات:

  • ‫property: اسم سمة العنصر الذي ستؤثر قيمته في النمط.
  • ‫mode: وضع الاستكمال، إما 'linear' أو 'interval'.
  • ‫palette: قائمة بالألوان أو مستويات التعتيم أو العرض التي يجب احتساب معدّل التغيّر في قيم سمات الإدخال بينها يعتمد التنسيق على mode، يُرجى الاطّلاع على قسمَي التمارين الخطية والتمارين المتناوبة لمزيد من التفاصيل.

ينطبق على وضع "'linear'" فقط

  • ‫min: قيمة السمة التي سيتم ربطها بالعنصر الأول في قائمة palette
  • ‫max: قيمة السمة التي سيتم ربطها بالعنصر الأخير في قائمة palette.

المساواة بين نقاط الاتصال

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

على سبيل المثال، يضبط العنصر التالي سمة النمط color استنادًا إلى سمة العنصر "REP_AREA". السمة palette هي قائمة بالألوان تشير إلى أنّ قيم الإدخال بين min وmax يجب أن تتدرج خطيًا من الأصفر إلى الأحمر إلى الأزرق. يتم استيفاء قيمة بين 1 و500 بين الأصفر والأحمر، ويتم استيفاء قيمة بين 500 و1000 بين الأحمر والأزرق.

var visParams = {
  color: {
    property: 'REP_AREA',
    mode: 'linear',
    palette: ['yellow', 'red', 'blue'],
    min: 1,
    max: 1000
  }
};

الفاصل

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

In the following example, feature fill opacity is set according to graduated classes of the "REP_AREA" property. يتم توفير تعريف الفئة ورموز الأنماط في السمة palette كقائمة من القوائم. ويشير ذلك إلى أنّه يجب أن تكون هناك 4 فئات مع فواصل عند القيم 0 و80 و2000 و5000، مع قيم عتامة للعناصر تبلغ 0.5 و0.35 و0.22 و0.15 على التوالي. بعبارة أخرى، ستكون الميزات التي تحتوي على قيم "REP_AREA" في الفاصل الزمني $ 0 \le x < 80 $ لها عتامة تعبئة تبلغ 0.5، وستكون القيم في الفاصل الزمني $ 80 \le x < 2000 $ لها عتامة تعبئة تبلغ 0.35، وهكذا.

var visParams = {
  fillOpacity: {
    property: 'REP_AREA',
    mode: 'interval',
    palette: [
      [0, 0.5],
      [80, 0.35],
      [2000, 0.22],
      [5000, 0.15]
    ]
  }
};

جميع سمات الأنماط

في ما يلي جميع سمات الأنماط التي يمكنك تحديدها في عنصر النمط. يؤدي ضبط سمات النمط لأنواع هندسية معيّنة إلى إلغاء سمات النمط المقابلة التي تم ضبطها لـ "جميع الأشكال الهندسية" (على سبيل المثال، يؤدي ضبط polygonFillColor إلى إلغاء القيمة المحدّدة في fillColor).

الموقع النوع الوصف يتيح استخدام "القاعدة المُستنتَجة"
جميع الأشكال الهندسية
isVisible Boolean تحدّد ما إذا كانت الميزة مرئية أم لا. لا
color String يضبط لون التعبئة/الحدود لجميع أنواع الأشكال الهندسية. يجب أن تكون قيمة ست عشرية أو لون CSS3. نعم
opacity Double يضبط عتامة التعبئة/الحدود لجميع أنواع الأشكال الهندسية. يجب أن تكون القيمة مزدوجة بين 0 و1. نعم
width Double يضبط عرض الخط لجميع أنواع الأشكال الهندسية. نعم
fillColor String يضبط لون التعبئة لجميع أنواع الأشكال الهندسية. يجب أن تكون قيمة ست عشرية أو لون CSS3. نعم
الأشكال الهندسية للنقاط
pointShape String يضبط هذا الإجراء شكل الأشكال الهندسية للنقاط. تتيح استخدام الأشكال نفسها التي تتيحها السمة ee.FeatureCollection.style (دائرة، مربّع، معين، صليب، علامة زائد، نجمة خماسية، نجمة سداسية، مثلث، مثلث_لأعلى، مثلث_لأسفل، مثلث_لليسار، مثلث_لليمين، شكل خماسي، شكل سداسي، نجمة5، نجمة6). لا
pointSize Double لضبط عرض الأشكال الهندسية للنقاط (بالبكسل) نعم
pointFillColor String يضبط لون التعبئة للأشكال الهندسية للنقاط. يجب أن تكون قيمة ست عشرية أو لون CSS3. نعم
pointFillOpacity Double يتم ضبط تعتيم التعبئة للأشكال الهندسية للنقاط. يجب أن تكون القيمة مزدوجة بين 0 و1. نعم
الأشكال الهندسية للخطوط
lineType String يحدّد نوع الخط. تتوافق مع الأنواع نفسها التي تتوافق معها السمة ee.FeatureCollection.style (خط متصل، خط متقطع، خط منقّط). لا
lineWidth Double لضبط عرض الخط (بالبكسل) نعم
lineColor String يضبط لون الأشكال الهندسية للخطوط. يجب أن تكون قيمة ست عشرية أو لون CSS3. نعم
lineOpacity Double يتم ضبط مستوى التعتيم للأشكال الهندسية الخطية. يجب أن تكون القيمة مزدوجة بين 0 و1. نعم
الأشكال الهندسية المضلّعة
polygonStrokeWidth Double لضبط عرض خط المضلّعات (بالبكسل) نعم
polygonStrokeType String يضبط نوع الخط للمضلّعات. تتوافق مع الأنواع نفسها التي تتوافق معها السمة ee.FeatureCollection.style (خط متصل أو متقطع أو منقّط). لا
polygonStrokeColor String يضبط لون الخطوط الخارجية للأشكال الهندسية المضلّعة. يجب أن تكون قيمة ست عشرية أو لون CSS3. نعم
polygonStrokeOpacity Double يضبط هذا الإجراء مستوى تعتيم الإطار للأشكال الهندسية المضلّعة. يجب أن تكون القيمة مزدوجة بين 0 و1. نعم
polygonFillColor String يضبط لون التعبئة للأشكال الهندسية المضلّعة. يجب أن تكون قيمة ست عشرية أو لون CSS3. نعم
polygonFillOpacity Double لضبط درجة تعتيم التعبئة للأشكال الهندسية المضلّعة يجب أن تكون القيمة مزدوجة بين 0 و1. نعم