کاربران میتوانند زوم، شیب، موقعیت و چرخش دوربین را با استفاده از حرکات روی نقشه کنترل کنند. همچنین میتوانید دوربین را از طریق برنامهنویسی پیکربندی کنید.
موقعیت دوربین
نمای نقشه به صورت دوربینی مدلسازی میشود که به یک نقطه خاص در فضا نگاه میکند. موقعیت و جهت دوربین توسط مختصات عرض/طول جغرافیایی/ارتفاع (که به عنوان "مرکز" تعریف میشود، جایی که دوربین به آن اشاره میکند)، عنوان، شیب، برد و چرخش تعریف میشود.
مرکز (عرض جغرافیایی، طول جغرافیایی، ارتفاع)
مرکز، نقطه خاصی را در فضای سهبعدی که دوربین مشاهده میکند، تعریف میکند. این با استفاده از کلاس LatLngAltitude مشخص میشود که مقادیر عرض جغرافیایی، طول جغرافیایی و ارتفاع را با هم ترکیب میکند. این امر امکان تعیین دقیق نقطه کانونی دوربین را در فضای سهبعدی فراهم میکند.
عرض جغرافیایی میتواند بین ۹۰- تا ۹۰ درجه باشد. طول جغرافیایی بین ۱۸۰- تا ۱۸۰ درجه متغیر است. ارتفاع از سطح دریا بر حسب متر مشخص میشود.
عنوان
عنوان، جهت قطبنمای نقشه را مشخص میکند که بر حسب درجه در جهت عقربههای ساعت از شمال حقیقی اندازهگیری میشود. شمال با ۰ درجه، شرق با ۹۰ درجه، جنوب با ۱۸۰ درجه و غرب با ۲۷۰ درجه مطابقت دارد.
شیب
شیب ، زاویه دوربین را نسبت به محور عمودی مشخص میکند که بر حسب درجه اندازهگیری میشود. شیب ۰ درجه به این معنی است که دوربین مستقیماً به سمت زمین ( نادیر ) نشانه رفته است. شیب ۹۰ درجه به این معنی است که دوربین به صورت افقی در جهت مشخص شده توسط عنوان قرار گرفته است.
محدوده
این محدوده، فاصله بین موقعیت خود دوربین و مرکز نقشه را بر حسب متر تعریف میکند. این محدوده میتواند از صفر متر (بسیار نزدیک) تا شصت و سه میلیون متر متغیر باشد و امکان مشاهده از نمای بسیار نزدیک تا یک پرسپکتیو واقعاً کلی را فراهم میکند. این امر به طور مؤثر میزان «بزرگنمایی» یا «کوچکنمایی» نقشه را کنترل میکند.
رول
رول ، زاویه دوربین را نسبت به افق، که بر حسب درجه اندازهگیری میشود، تنظیم میکند. این پارامتر میتواند برای ایجاد جلوههایی مانند چرخش عمودی در طول شبیهسازیهای پرواز یا حتی چرخش کامل لوله، که دوربین را حول محور دید خود میچرخاند، استفاده شود.
کنترل دوربین
نمونه کد زیر نحوه کنترل دوربین را به صورت برنامهنویسی شده با فراخوانی متدsetCamera نشان میدهد. برای استفاده از این نمونه کد، دستورالعملهای موجود در Setup و Add 3D map to your app را دنبال کنید تا پروژه اندروید استودیو خود را با یک نقشه سهبعدی پایه راهاندازی کنید. سپس، کد زیر را به فایل MainActivity.kt اضافه کنید:
// Add imports
import com.google.android.gms.maps3d.model.latLngAltitude
...
// Add to the onMap3DViewReady method, after the googleMap3D object has been initialized
googleMap3D.setCamera(
camera {
center = latLngAltitude {
latitude = 38.743502
longitude = -109.499374
altitude = 1467.0
}
heading = 350.0
tilt = 58.1
range = 138.2
roll = 0.0
}
)