הסגנון של מאפיינים בנכס 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. | כן |