نظرة عامة على FeatureView

FeatureView هو تمثيل مسرَّع للاطّلاع فقط FeatureCollection. على عكس FeatureCollection، الذي يتم إنشاء وحداته المركّبة للخريطة النقطية أثناء المعالجة، يتم احتساب وحدات FeatureView المركّبة للخريطة النقطية مسبقًا لتوفير عرض سريع. بالإضافة إلى عرض مواد العرض بشكل أسرع، تُنفِّذ مواد عرض FeatureView ميزة تقليل التفاصيل في العناصر استنادًا إلى مستوى التكبير/التصغير. ويؤدي ذلك إلى أنّ مجموعات البيانات الكثيفة قد تبدو غير مكتملة عند التصغير (لا يتم رسم العناصر الصغيرة)، ولكن يزداد مقدار البيانات الظاهرة عند التكبير، ما يمكن أن يُحسِّن من المظهر الجمالي للخريطة عند مستويات التكبير المنخفضة. يتم التحكّم في سلوك تخفيف كثافة مجموعة بيانات من خلال عدة مَعلمات تحسين يتم ضبطها أثناء تصدير مادة عرض FeatureCollection إلى مادة عرض FeatureView.

بما أنّ مواد عرض FeatureView مخصّصة للعرض فقط، لا يمكن تضمينها في العمليات الحسابية أو التعبيرات، ولكن يمكن عرضها وفحصها في محرِّر رمز JavaScript وتطبيقات Earth Engine بصفتها FeatureViewLayer. ويمكن أيضًا دمجها في تطبيقات Google Maps API.

إنشاء FeatureView

يتضمن إنشاء FeatureView إعداد FeatureCollection يتضمّن بياناتك، واستدعاء الدالة Export.table.toFeatureView، وبدء مهمة التصدير. يوضّح المثال التالي تصدير طرق العرض في مجموعة بيانات مضلّعات WDPA. في تطبيقك، استخدِم أي مجموعة بيانات FeatureCollection تم أرشفتها في كتالوج بيانات Earth Engine أو أنشئ مجموعة بيانات خاصة بك من خلال تحميل مجموعة بيانات ناقلات كأحد مواد عرض Earth Engine.

يمكن تخصيص FeatureView باستخدام عدة مَعلمات في دالة Export.table.toFeatureView.

  • ‫maxFeaturesPerTile: لتحديد الحد الأقصى لعدد العناصر المعروضة في مربّع خريطة عند مستوى تكبير معيّن. استخدِم هذه المَعلمة لتحسين السرعة أو كثافة العناصر.
  • thinningStrategy - للتحكّم في ما إذا كان يجب تحسين كثافة العناصر في مربّع معيّن ومستوى تكبير/تصغير لزيادة الكثافة أو الاتساق في الكثافة على مستوى المربّعات يُرجى العِلم أنّ تحسين الكثافة العالية يمكن أن يؤدي إلى أن تصبح حدود القطعة مميّزة، لأنّ كثافة العناصر لكل قطعة مستقلة.
  • ‫thinningRanking: لتحديد أولوية تقليل عدد الميزات على سبيل المثال، يمكنك تحسين التخفيف لاستهداف الاحتفاظ بخاصية ميزة معيّنة ذات قيم عالية، أي عند التمرير للخارج، سيتم تخفيف العناصر التي لها قيمة منخفضة للخاصية المحدّدة أولاً، ما يترك العناصر الأكثر أهمية (وفقًا لقواعدك) مرئية.
  • ‫zOrderRanking: لتحديد الترتيب حسب السمة z (ترتيب التجميع) للعناصر المعروضة على الخريطة تتحكّم هذه المَعلمة في كيفية عرض العناصر المتداخلة من خلال السماح لك بضبط قواعد الأولوية استنادًا إلى سمات العناصر ونوع الشكل ومستوى التكبير. على سبيل المثال، يمكنك إعطاء الأولوية للعناصر التي تحتوي على قيم عالية لموقع معيّن لكي يتم عرضها فوق العناصر المتداخلة التي تحتوي على قيم منخفضة.

اطّلِع على FeatureView صفحة "التحسين" لمزيد من التفاصيل عن هذه المَعلمات والوسيطات المقبولة لها.

في المثال أدناه، تؤدي الوسيطات المحدّدة لهذه المَعلمات إلى إنشاء FeatureView حيث يكون الحد الأقصى للعناصر لكل مربّع في مستوى تكبير معيّن هو 1500، وتكون كثافة العناصر لكل مربّع مستقلة ويُسمح لها بالوصول إلى الحد الأقصى البالغ 1500، ويتم تقليل عدد المضلّعات الأصغر حجمًا أولاً، وتظهر المضلّعات الأصغر حجمًا فوق المضلّعات الأكبر حجمًا.

محرِّر الرموز البرمجية (JavaScript)

// Import the WDPA feature collection.
var wdpa = ee.FeatureCollection('WCMC/WDPA/current/polygons');

// Export the WDPA FeatureCollection as a FeatureView asset.
Export.table.toFeatureView({
  collection: wdpa,
  assetId: 'wdpa-featureview-demo',
  description: 'wdpa-featureview-demo',
  maxFeaturesPerTile: 1500,
  thinningStrategy: 'HIGHER_DENSITY',
  thinningRanking: ['REP_AREA DESC'],
  zOrderRanking: ['REP_AREA DESC'],
});

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

مواقع مواد عرض FeatureView الجغرافية

يمكن العثور على مواد عرض FeatureView في ملف التداول العلني قائمة البيانات وبين مواد العرض الشخصية في علامة التبويب مواد العرض في "محرر الرموز". تتضمّن جميع مواد عرض FeatureCollection ذات الصلة في "كتالوج البيانات" مادة عرض FeatureView مصاحبة لها تتضمّن إعدادات نقل بيانات عامة. سيتضمّن أرشيف مواد العرض الشخصية أي مواد عرض FeatureViewتنشئها.

استيراد مواد عرض FeatureView إلى النصوص البرمجية

يمكن استيراد مواد عرض FeatureView إلى نصوص برمجية "محرِّر الرموز" باستخدام buttons في مربّعات حوار مواد العرض في "محرِّر الرموز" وإدخال مواد عرض شخصية، وأيضاً من خلال providing a FeatureView asset ID as input to the ui.Map.FeatureViewLayer constructor.

مربّع حوار مادة عرض "كتالوج البيانات"

تحتوي مربّعات حوار مواد عرض جداول "كتالوج البيانات"، التي يمكن الوصول إليها من شريط البحث في "محرر الرموز"، على زر استيراد في أسفل يسار الصفحة مع قائمة منسدلة. من القائمة المنسدلة، اختَر "استيراد FeatureView". سيتم تضمين مادة العرض في القسم عمليات الاستيراد في أعلى النص البرمجي.

مربّع حوار مادة العرض الشخصية

تحتوي مربّعات حوار مواد عرض FeatureView الشخصية، التي يمكن الوصول إليها من خلال اختيار مادة عرض من علامة التبويب مواد العرض في "محرر الرموز"، على زر استيراد في أعلى يسار الصفحة. سيؤدي تفعيل الزر إلى تضمين مادة العرض في قسم عمليات الاستيراد في أعلى النص البرمجي. يمكنك أيضًا استخدام زر اختصار الاستيراد (رمز السهم المتّجه لليسار) الذي يظهر عند تمرير مؤشر الماوس فوق مادة عرض في علامة التبويب مواد العرض.

رقم تعريف مادة العرض

تحتوي مواد عرض FeatureView على معرّف يمكن تقديمه كمدخل إلى ui.Map.FeatureViewLayer constructor، ما يتيح لك الوصول إلى مادة العرض في ui.Map.FeatureViewLayer script. يمكن العثور على مقتطفات الاستيراد التي تم إنشاؤها مسبقًا في صفحات مواد عرض "كتالوج البيانات" ومربّعات حوار مواد العرض في "محرر الرموز".

الشكل 1. مربّع حوار مادة عرض "كتالوج البيانات" يُبرز طرق استيراد FeatureView

البيانات الوصفية لميزة "عرض العناصر"

تتوفّر معلومات FeatureView والبيانات الوصفية في مربّعات حوار مواد العرض المذكورة في قسم مواقع مواد عرض "عرض الميزات" أعلاه. بالإضافة إلى الوصف والسمات التي يمكن مشاركتها مع المصدر FeatureCollection، هناك خمس سمات فريدة لملف التعريف FeatureView. وتشمل هذه الإعدادات إعدادات مَعلمات نقل البيانات الموضّحة في قسم إنشاء FeatureView وsourceVersion، وهو الطابع الزمني "لآخر تعديل" لمادة عرض الجدول التي تم إنشاء FeatureView منها. يعرض الشكل 1 أعلاه خصائص خاصة بملف FeatureView في مربّع حوار مادة عرض "كتالوج البيانات". مثل مواد العرض الأخرى، يمكنك أيضًا جلب المواقع آليًا من القاموس الذي تعرضه ee.data.getAsset.

عرض FeatureView

يمكن عرض عنصر FeatureView في "أداة التعديل" وتطبيقات Earth Engine و"خرائط Google".

أداة تعديل الرموز

يتضمّن "أداة تعديل الرموز" المكوّن ui.Map.FeatureViewLayer لعرض مواد عرض FeatureView على الخريطة. يحدّد المثال التالي رقم تعريف مادة عرض FeatureView ، ويستورد مادة العرض كعنصر FeatureViewLayer، ويعرضها على الخريطة.

محرِّر الرموز البرمجية (JavaScript)

// Define the FeatureView asset ID.
var assetId = 'WCMC/WDPA/current/polygons_FeatureView';

// Import the FeatureView asset as a FeatureViewLayer.
var layer = ui.Map.FeatureViewLayer(assetId);

// Add the FeatureViewLayer to the map.
Map.add(layer);

التصميم

يمكنك وضع أسلوب على FeatureViewLayer من خلال تمرير قاموس أسلوب إلى الدالة ui.Map.FeatureViewLayer أو إضافته إلى طبقة باستخدام الطريقة setVisParams. في ما يلي مثال على تنسيق:

  • ألوان المخطط استنادًا إلى السمة "MARINE" (سواء كانت المنطقة المحمية تقع كليًا أو جزئيًا ضمن البيئة البحرية)
  • لون التعبئة استنادًا إلى السمة IUCN_CAT (فئة الاتحاد الدولي للحفاظ على التنوع البيولوجي (IUCN))
  • عتامة الملء استنادًا إلى حجم المنطقة المحمية التي تحدّدها السمة "REP_AREA"

انتقِل إلى صفحة "تنسيق ميزة العرض" للحصول على المزيد من التفاصيل حول خيارات التنسيق المتاحة.

محرِّر الرموز البرمجية (JavaScript)

// Set visualization properties for the defined layer.
layer.setVisParams({
  color: {
    property: 'MARINE',
    categories: [
      ['0', 'purple'],
      ['1', 'green'],
      ['2', 'blue'],
    ]
  },
  fillColor: {
    property: 'IUCN_CAT',
    defaultValue: 'd3d3d3',
    categories: [
      ['Ia', 'a6cee3'],
      ['Ib', '1f78b4'],
      ['II', 'b2df8a'],
      ['III', '33a02c'],
      ['IV', 'fb9a99'],
      ['V', 'e31a1c'],
      ['VI', 'fdbf6f'],
    ]
  },
  fillOpacity: {
    property: 'REP_AREA',
    mode: 'interval',
    palette: [
      [0, 0.5],
      [80, 0.35],
      [2000, 0.22],
      [5000, 0.15],
    ],
  },
  width: 1.0,
  pointSize: 6.0,
});

الفلترة

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

محرِّر الرموز البرمجية (JavaScript)

// Define the FeatureView asset ID.
var assetId = 'WCMC/WDPA/current/polygons_FeatureView';

// Import the FeatureView asset as a FeatureViewLayer.
var layer = ui.Map.FeatureViewLayer(assetId, null, 'WDPA FeatureViewLayer');

// Callback function to update FeatureViewLayer style.
var updateVisParams = function() {
  layer.setVisParams({
    color: {
      property: 'MARINE',
      categories: [
        ['0', 'purple'],
        ['1', 'green'],
        ['2', 'blue'],
      ]
    },
    fillColor: {
      property: 'IUCN_CAT',
      defaultValue: 'd3d3d3',
      categories: [
        ['Ia', 'a6cee3'],
        ['Ib', '1f78b4'],
        ['II', 'b2df8a'],
        ['III', '33a02c'],
        ['IV', 'fb9a99'],
        ['V', 'e31a1c'],
        ['VI', 'fdbf6f'],
      ]
    },
    fillOpacity: {
      property: 'REP_AREA',
      mode: 'interval',
      palette: [
        [0, 0.5],
        [80, 0.35],
        [2000, 0.22],
        [5000, 0.15],
      ],
    },
    width: 1.0,
    pointSize: 6.0,
    rules: [
      {
        filter: ee.Filter.lt('REP_AREA', filterSlider.getValue()),
        isVisible: false,
      },
    ],
  });
};

// Slider widget that calls the updateVisParams function on change.
var filterSlider = ui.Slider({
  min: 0,
  max: 10000,
  step: 10,
  value: 0,
  style: { stretch: 'horizontal'},
  onChange: updateVisParams,
});
var filterSliderLabel = ui.Label(
  'Adjust slider to hide features less than the specified area (km²)');

// Add the slider to the map.
Map.add(ui.Panel([filterSliderLabel, filterSlider]));

// Initialize the FeatureViewLayer style.
updateVisParams();

// Add the FeatureViewLayer to the map.
Map.add(layer);

الشكل 2. FeatureViewLayer رسوم بيانية تتضمّن أداة شريط تمرير لإخفاء العناصر الأصغر حجمًا من المنطقة المحدّدة

واجهة برمجة تطبيقات خرائط Google

تتألّف عملية عرض مادة عرض FeatureView باستخدام Google Maps API من أربعة أجزاء: الحصول على مفتاح مربّعات باستخدام ee.data.getFeatureViewTilesKey، ونقله إلى مثيل FeatureViewTileSource، وإنشاء ee.layer.ImageOverlay، ثم إضافة التراكب إلى مثيل google.maps.Map. في ما يلي نموذج رمز لإنشاء ImageOverlay في JavaScript.

var tilesKey = ee.data.getFeatureViewTilesKey({
  assetId: 'WCMC/WDPA/current/polygons_FeatureView',
  visParams: { … },
});

var tileSource = new ee.layers.FeatureViewTileSource(tilesKey);
var overlay = new ee.layers.ImageOverlay(tileSource);

بعد الانتهاء من ذلك، يمكنك إضافة التراكب إلى مثيل google.maps.Map كما هو موضّح أدناه.

// embeddedMap is your google.maps.Map instance.
embeddedMap.overlayMapTypes.setAt(0, overlay);

فحص FeatureView

يمكن فحص طبقة FeatureViewLayer التي تمت إضافتها إلى خريطة "محرر الرموز البرمجية" التلقائية باستخدام أداة "المدقق". وتتطابق وظائفه مع وظائف FeatureCollection. يُرجى العِلم أنّه لا يتم إدراج سوى العناصر المرئية في مستوى التكبير/التصغير الحالي ضمن النتائج التي يتم عرضها للموضع الجغرافي الذي تم النقر عليه. لا يتم عرض الأشكال الهندسية للعناصر التي تم فحصها لأنّها تكون مبسّطة كجزء من عملية تصدير FeatureView.

الشكل 3. فحص FeatureViewLayer يعرِض المفتش الطبقة والعناصر ورقم تعريف مادة العرض ومَعلمات العرض.