AltitudeMode ویژگیای است که جایگاه عمودی عنصر نقشه را تعریف میکند.
این ویژگی تعیین میکند که آیا شیء نسبت به عوارض زمینی، نسبت به عوارض بالای زمین (مانند ساختمانها)، یا در ارتفاع مطلق نسبت به سطح دریا رندر شود.
AltitudeMode ویژگیای است که تعیین میکند عناصری که به نقشه سهبعدی اضافه میکنید، مانند نشانگرها، چندخطیها، چندضلعیها، و مدلها، نسبت به سطح زمین کجا رندر شوند. علاوهبراین، AltitudeMode کنترل میکند که دوربین درطول پویانماییهای flyCameraTo و flyCameraAround کجا قرار بگیرد.
راهنمای زیر اطلاعاتی درباره استفاده مؤثر از AltitudeMode
و ملاحظاتی درباره عواملی که بر نحوه ارائه عناصر تأثیر میگذارند ارائه میدهد.
مدلهای ارتفاع دیجیتال
جایگذاری عارضه توسط دو «مدل رقومی ارتفاع» (DEM) زیربنایی که در میانای برنامهسازی کاربردی قابلدسترسی است کنترل میشود:
- مدل زمین دیجیتال (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)، مقدار ارتفاع ارائهشده یک انحراف از سطح پایه انتخابشده است، نه یک ارتفاع ثابت از سطح دریا. برای مثال، ارتفاع ۱۰۰ ویژگی را ۱۰۰ متر بالاتر از DTM یا DSM قرار میدهد.
اگر دادههای عارضه شامل ارتفاع نباشد، حالت نسبی مانند
RELATIVE_TO_MESH عارضه را مستقیماً در بالای مش/سطح قرار میدهد.
اما برای چندخطیها و چندضلعیها، اتصالات بین نقاط خطوط مستقیم خواهد بود که اگر از درونیابی استفاده نکنید، ممکن است باعث شود خط از میان مش بین نقاط عبور کند.