پیکربندی کنترل های دوربین، پیکربندی کنترل های دوربین

کاربران می‌توانند زوم، شیب، موقعیت و چرخش دوربین را با استفاده از حرکات روی نقشه کنترل کنند. همچنین می‌توانید دوربین را از طریق برنامه‌نویسی پیکربندی کنید.

موقعیت دوربین

نمای نقشه به صورت دوربینی مدل‌سازی می‌شود که به یک نقطه خاص در فضای سه‌بعدی نگاه می‌کند. موقعیت و جهت دوربین (و در نتیجه رندر نقشه) با ویژگی‌های زیر مشخص می‌شود: مرکز (مکان مورد نظر دوربین از نظر عرض/طول جغرافیایی/ارتفاع)، عنوان، شیب، برد و چرخش.

مرکز (عرض جغرافیایی/طول جغرافیایی/ارتفاع)

مرکز، نقطه خاصی را در فضای سه‌بعدی که دوربین مشاهده می‌کند، تعریف می‌کند. این با استفاده از کلاس 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
    }
)