אופטימיזציה של FeatureView

כשמייצאים קובץ FeatureCollection כנכס FeatureView, אפשר להגדיר פרמטרים שמגדירים את סדר העדיפויות של התכונות שיוצגו ברמת זום מסוימת (דילול) ואת סדר התכונות החופפות (סדר z). ההגדרות האלה משפיעות על המהירות ועל מאפייני התצוגה של אובייקטים מסוג FeatureView. בקטעים הבאים מתוארים הפרמטרים של האופטימיזציה ומתואר ההשפעה שלהם באמצעות תרשימים רעיוניים שבהם משבצות המפה מסומנות בקווים מקווקווים, תכונות גלויות הן פוליגונים עם קווים מלאים ותכונות שהוסרו (דילול) הן פוליגונים עם קווים מקווקווים ללא מילוי.

מקטע הקוד הבא הוא דוגמה לייצוא מ-FeatureCollection אל FeatureView, שמבליט את פרמטרים האופטימיזציה שמתוארים בדף הזה.

Export.table.toFeatureView({
  collection: fooFc,
  assetId: 'foo-featureview-demo',
  description: 'foo-featureview-demo',
  maxFeaturesPerTile: 1500,
  thinningStrategy: 'HIGHER_DENSITY',
  thinningRanking: ['my-property DESC'],
  zOrderRanking: ['my-property DESC']
});

מספר התכונות המקסימלי בכל משבצת

הפרמטר 'תכונות מקסימליות לכל משבצת' (maxFeaturesPerTile) מגדיר את מספר התכונות המקסימלי שאפשר להציג ביחידה אחת של מפה. הערך הזה הוא גבול עליון, והוא עשוי להיות נמוך משמעותית בהתאם לאסטרטגיית הדילול. הערך הזה יכול להיות כל מספר בין 1 ל-2000. ככל שהערך גבוה יותר, כך מוצגות יותר תכונות בכל משבצת, אבל זמן הטעינה של המשבצות ארוך יותר.

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

כל התכונות (לעיון)

maxFeaturesPerTile: 5

מוצגות לא יותר מ-5 תכונות בכל אריח.

maxFeaturesPerTile: 2

מוצגות לא יותר מ-2 תכונות בכל אריח.

דירוג דילולים

הפרמטר של דירוג הדילול (thinningRanking) קובע את סדר העדיפויות של הנתונים לדילול על סמך סוג הגיאומטריה, גודל התכונה וערכים של מאפייני התכונה. הוא מקבל קבוצת כללים שמספקים לאלגוריתם הדילול מידע על התכונות שצריך לדלל לפני שאר התכונות כשמגיעים לערך maxFeaturesPerTile. כל כלל כולל מאפיין של תכונה, ואחריו כיוון המיון (למעלה/ASC או למטה/DESC). אפשר להגדיר כלל אחד או יותר. בנוסף למאפייני התכונות הרגילים, יש שני מאפיינים מיוחדים שאפשר להשתמש בהם כדי לתעדף את הדילול: .geometryType ו-.minZoomLevel.

  • .geometryType – מאפיין ישויות כנקודות, קווים או פוליגונים. סוגי הגיאומטריה האלה מסווגים כקטנים, בינוניים וגדולים, בהתאמה, לצורך מיון.
  • .minZoomLevel – רמת הזום הנמוכה ביותר במפה שבה תכונה יכולה להירטן כמשבצת. ברמות זום מתחת לערך הזה התכונה לא תוצג, וברמות זום שגדולות מערך זה או שוות לו התכונה עשויה להופיע. חשוב לזכור שרמות זום נמוכות מייצגות אזור גיאוגרפי גדול יותר לכל משבצת מפה בהשוואה לרמות זום גבוהות יותר. לתכונות של נקודות מוקצה הערך 0 (גלוי בכל רמות הזום). לגיאומטריות של קווים ופוליגונים מוקציים ערכים על סמך הגבולות שלהם (קווים) או השטח שלהם (פוליגונים): לישויות גדולות יש ערכים נמוכים יותר של .minZoomLevel מאשר לישויות קטנות יותר.

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

// String input format for setting thinning ranking based on 3 rules.
'my-property DESC, .geometryType ASC, .minZoomLevel ASC'

// List of strings input format for setting thinning ranking based on 3 rules.
['my-property DESC', '.geometryType ASC', '.minZoomLevel ASC']

הכללים שלמעלה מכוונים את אלגוריתם הדילול לתת עדיפות לתכונות עם ערך גדול יותר של המאפיין 'my-property' (קודם מדללים תכונות עם ערך קטן יותר של המאפיין 'my-property'), לתת עדיפות לתכונות עם סוג גיאומטריה קטן יותר (לדוגמה, מדללים פוליגונים לפני קווים וקווים לפני נקודות) ולתת עדיפות לתכונות עם רמת זום מינימלית קטנה יותר (נקודות לפני פוליגונים גדולים לפני פוליגונים קטנים).

בטבלה הבאה מוסבר איך שינוי של הכלל thinningRanking בנכס size משפיע על התכונות שמוצגות. המספר הכולל של הישויות לכל משבצת (עמודה All features) גדול מ-5, לכן מתבצע דילול כדי להגביל את הישויות שמוצגות (עמודה thinningRanking: 5). בשורה הראשונה, המאפיינים ממוינים לפי size מהגדול ביותר לקטן ביותר, כלומר מאפיינים גדולים יותר מקבלים עדיפות על פני מאפיינים קטנים יותר (המאפיינים מצוירים בסדר יורד לפי גודל עד שמגיעים ל-maxFeaturesPerTile). בשורה השנייה, התכונות ממוינות לפי גודל עולה, כך שהתכונות הקטנות ביותר מצוירות קודם, לפי גודל, עד שמגיעים ל-maxFeaturesPerTile.

thinningRanking כל התכונות (לעיון) maxFeaturesPerTile: 5

'size DESC'

לתעדף תכונות עם ערך size גדול יותר (קודם מחסלים תכונות עם ערך size קטן יותר).

'size ASC'

לתת עדיפות לתכונות עם size קטן יותר (קודם צריך להפחית את מספר התכונות עם size גדול יותר)

אסטרטגיית דילול

הפרמטר של שיטת הדילול (thinningStrategy) משמש לצד דירוג הדילול (thinningRanking) כדי לדלל את הנתונים בזמן הייצוא ולשפר את ביצועי הרינדור. יש שתי אסטרטגיות נתמכות: HIGHER_DENSITY ו-GLOBALLY_CONSISTENT. כשמבצעים דילול ברמת זום מסוימת, שימוש בשיטת דילול עם צפיפות גבוהה יותר מאפשר לכל משבצת להתקרב ככל האפשר למגבלה של maxFeaturesPerTile, בלי קשר לדירוג של התכונות במשבצות אחרות. המשמעות של שימוש בשיטת דילול עקבית ברמת המערכת היא שאם תכונה מסוימת תוסר על ידי דילול מאריחים כלשהם, כל התכונות עם דירוג דילול שווה או נמוך יותר יוסרו מכל האריחים, ללא קשר לצורך בדילול של אריח מסוים (מעבר למגבלה maxFeaturesPerTile). מומלץ להשתמש בשיטה HIGHER_DENSITY כדי לבצע אופטימיזציה לצפיפות התכונות, ולהשתמש בשיטה GLOBALLY_CONSISTENT כדי לבצע אופטימיזציה לייצוג עקבי של דירוג התכונות בין המשבצות.

בטבלה הבאה אפשר לראות איך שינוי הערך של thinningStrategy משפיע על הדילול. בדוגמה הזו, הנתונים נדחסים לפי הצורה או הצבע של הנקודות. לעיגולים כחולים, למרובעים ירוקים ולמשושים אדומים יש דרגות דילול בהתאמה, מהטובה ביותר לגרוע ביותר. לכל thinningStrategy (HIGHER_DENSITY ו-GLOBALLY_CONSISTENT) מוגדרים שלושה ערכים שונים של maxFeaturesPerTile: מספר גדול מספיק כדי להציג את כל התכונות, 10 תכונות ו-9 תכונות.

כשהערך של HIGHER_DENSITY הוא 10 ו-maxFeaturesPerTile הוא 10, 6 משולשים אדומים (העדיפות הנמוכה ביותר בדירוג הדילול) נדלים מהמשבצת הימנית העליונה, ומשבצת אדומה אחת נדלה מהמשבצת הימנית התחתונה. כשמשתמשים ב-HIGHER_DENSITY וב-9maxFeaturesPerTile, 7 משולשים אדומים נדחסים משביעית השמאלית העליונה, ומשולשים אדומים וריבועים ירוקים נדחסים משביעית השמאלית התחתונה. בדוגמאות האלה, כל משבצת מדללת בנפרד, בלי להביא בחשבון את דירוג הדילול של תכונות במשבצות שכנות. בהתאם למאפייני הנתונים, שיטת הדילול הזו עשויה לגרום לכך ששיבושים סמוכים במפה ייראו שונים זה מזה, אבל היא מאפשרת להציג את מספר התכונות המקסימלי.

חשוב לזכור: אם תכונה מסוימת תוסר מאחד מהשבבים באמצעות דילול GLOBALLY_CONSISTENT, כל התכונות האחרות עם thinningRank שווה או נמוך יותר גם יוסרו. כשהערך של maxFeaturesPerTile מוגדר כ-10, המשולשים האדומים לא מופיעים באף אריח כי משולש אדום מודגש פחות באריחים שבפינה הימנית העליונה ובפינה הימנית התחתונה. כשהערך של maxFeaturesPerTile מוגדר ל-9, גם הריבוע הירוק לא מופיע באף משבצת כי הוא מצומצם במשבצת השמאלית התחתונה. בשיטת הדילול הזו יש פחות סיכוי ליצור את המראה הייחודי של המשבצות, כמו שאפשר לעשות בשיטה HIGHER_DENSITY, אבל יש לה פוטנציאל לדלל את המשבצות למספר תכונות שנמצא הרבה מתחת למגבלה של maxFeaturesPerTile.

thinningStrategy כל התכונות (לעיון) maxFeaturesPerTile: ‏ 10 maxFeaturesPerTile: ‏ 9

'HIGHER_DENSITY'

דילול פחות אגרסיבי.

שמירה על צפיפות גבוהה של תכונות באמצעות דילול בתוך המשבצת.

'GLOBALLY_CONSISTENT'

דילול אגרסיבי יותר.

שמירה על דירוג דילול מינימלי עקבי ברחבי העולם באמצעות דילול בין המשבצות.

דירוג לפי סדר Z

הפרמטר של דירוג z-order (zOrderRanking) קובע את הסדר של תכונות חופפות. הוא מקבל קבוצת כללים שמגדירים אילו תכונות צריכות להופיע מתחת או מעל תכונות אחרות כשהן חופפות. הלוגיקה והפורמט של הכללים להגדרת סדר התכונות זהים לאלה של צמצום הדירוג. פרטים נוספים זמינים בקטע הזה.

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

// String input format for setting z-order ranking based on 3 rules.
'my-property DESC, .geometryType ASC, .minZoomLevel ASC'

// List of strings input format for setting z-order ranking based on 3 rules.
['my-property DESC', '.geometryType ASC', '.minZoomLevel ASC']

הכללים שלמעלה קובעים שתכונות עם ערך גדול יותר של 'my-property' צריכות להופיע מתחת לתכונות עם ערך קטן יותר, תכונות עם סוג גיאומטריה קטן יותר צריכות להופיע מתחת לתכונות עם סוג גיאומטריה גדול יותר (לדוגמה, נקודות מתחת לקווים וקווים מתחת לפוליגונים), ותכונות עם רמת זום מינימלית קטנה יותר (תכונות גדולות יותר) צריכות להופיע מתחת לתכונות עם רמת זום מינימלית גדולה יותר (תכונות קטנות יותר).

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

zOrderRanking: 'size DESC'

תכונות עם size קטן יותר מופיעות מעל תכונות עם size גדול יותר.

zOrderRanking: 'size ASC'

תכונות עם size גדול יותר מופיעות מעל תכונות עם size קטן יותר.