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

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

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

מרווח

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

בדוגמה הבאה, אטימות המילוי של התכונה מוגדרת לפי מחלקות מדורגות של המאפיין REP_AREA. הגדרת המחלקה וסמלי הסגנון מופיעים במאפיין palette כרשימה של רשימות. הוא מציין שצריכות להיות 4 קבוצות עם מעברים בערכים 0, 80, 2, 000 ו-5, 000, עם ערכי אטימות של 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 מגדירה את אטימות המילוי/הקו לכל סוגי הגיאומטריה. הערך חייב להיות מספר עם נקודה צפה (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 ההגדרה הזו קובעת את רמת האטימות של גיאומטריות קו. הערך חייב להיות מספר עם נקודה צפה (double) בין 0 ל-1. כן
גיאומטריות של פוליגונים
polygonStrokeWidth Double מגדיר את רוחב הקו של פוליגונים (בפיקסלים). כן
polygonStrokeType String הגדרת סוג הקו של המצולעים. תומך באותם סוגים כמו ee.FeatureCollection.style (רציף, מקווקו, מנוקד). לא
polygonStrokeColor String הגדרת צבע הקו של צורות גיאומטריות מסוג פוליגון. הערך חייב להיות קוד צבע הקסדצימלי או צבע CSS3. כן
polygonStrokeOpacity Double ההגדרה הזו קובעת את רמת האטימות של קווי המתאר של פוליגונים. הערך חייב להיות מספר עשרוני בין 0 ל-1. כן
polygonFillColor String הגדרת צבע המילוי של צורות גיאומטריות מסוג פוליגון. הערך חייב להיות קוד צבע הקסדצימלי או צבע CSS3. כן
polygonFillOpacity Double ההגדרה הזו קובעת את מידת האטימות של המילוי בגיאומטריות של פוליגונים. הערך חייב להיות מספר עשרוני בין 0 ל-1. כן