AltitudeMode הוא המאפיין שמגדיר את המיקום האנכי של אלמנט במפה.
הוא קובע אם אובייקט מוצג ביחס לפני השטח, ביחס למאפיינים מעל פני הקרקע (כמו בניינים) או בגובה מוחלט מעל פני הים.
AltitudeMode הוא המאפיין שקובע איפה רכיבים שמוסיפים למפה התלת-ממדית, כמו סמנים, קווים שבורים, פוליגונים ומודלים, מוצגים ביחס לפני השטח של כדור הארץ. בנוסף, AltitudeMode קובעת את המיקום של המצלמה במהלך אנימציות של flyTo ושל flyAround.
במדריך הבא מוסבר איך להשתמש ב-AltitudeMode בצורה יעילה, ומוצגים שיקולים לגבי גורמים שמשפיעים על אופן העיבוד של רכיבים.
מודלים דיגיטליים של גובה פני השטח
מיקום התכונות נקבע על ידי שני מודלים בסיסיים של גבהים דיגיטליים (DEM) שאפשר לגשת אליהם ב-API:
- מודל פני שטח דיגיטלי (DTM) / 'קרקע': תצוגה של 'קרקע חשופה' שבה מוצג הגובה של פני השטח הבסיסיים, ללא אובייקטים מעל פני הקרקע.
- מודל פני שטח דיגיטלי (DSM) / "רשת": ייצוג של פני השטח שכולל את גובה השטח וגם מאפיינים מעל פני השטח כמו בניינים ועצים.
התמונה הבאה מציגה את ההבדל בין עיבוד DTM לבין עיבוד DSM של אזור עירוני:

AltitudeMode אפשרויות
הבחירה ב-AltitudeMode קובעת את אופן הפרשנות של ערך הגובה של התכונה (אם הוא מסופק) ביחס למודלים הדיגיטליים של הגובה.
-
ABSOLUTE: האובייקט מוצג ביחס לגובה פני הים הממוצע, שמחושב באמצעות EGM96. -
CLAMP_TO_GROUND: האובייקט מוצג ישירות ב-DTM (הקרקע), בלי להתחשב בגובה שצוין ובלי להתאים את עצמו לפני השטח. -
RELATIVE_TO_GROUND: עיבוד האובייקט ביחס למשטח DTM (קרקע). -
RELATIVE_TO_MESH: האובייקט מוצג ביחס ל-DSM (רשת) – פני השטח הגבוהים ביותר, כולל קרקע, מבנים ומים.
בדוגמה הבאה אפשר לשנות את AltitudeMode של קו פוליגוני כדי לראות איך מצבים שונים משפיעים על העיבוד של הקו הפוליגוני בגיאומטריה מורכבת בסביבה חצי-עירונית:
ערכי גובה במצבים יחסיים
כשמשתמשים במצבים יחסיים (RELATIVE_TO_GROUND או RELATIVE_TO_MESH), ערך הגובה שסופק הוא היסט מפני השטח שנבחרו כבסיס, ולא גובה קבוע מעל פני הים. לדוגמה, אם הגובה הוא 100, התכונה תוצב 100 מטרים מעל ה-DTM או ה-DSM.
אם נתוני התכונה לא כוללים גובה, מצב יחסי כמו RELATIVE_TO_MESH יציב את התכונה ישירות מעל הרשת או פני השטח.
עם זאת, במקרה של קווים שבורים ומצולעים, הקווים שמחברים בין הנקודות יהיו ישרים, ולכן אם לא משתמשים באינטרפולציה, יכול להיות שהקו יעבור דרך הרשת בין הנקודות.
השלבים הבאים
- בנושא הזה במרכז הארכיטקטורה יש סקירה מפורטת יותר של
AltitudeMode, כולל מידע עלAltitudeModeועל סמנים.