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

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