ضبط عناصر التحكّم في الكاميرا

يمكن للمستخدمين التحكّم في التكبير أو التصغير والإمالة والموضع والتدوير للكاميرا باستخدام الإيماءات على الخريطة. يمكنك أيضًا ضبط إعدادات الكاميرا آليًا.

موضع الكاميرا

يتم تصميم عرض الخريطة على شكل كاميرا تنظر إلى نقطة معيّنة في الفضاء. يتم تحديد موضع الكاميرا واتجاهها من خلال إحداثيات خطوط العرض والطول والارتفاع (المحدّدة على أنّها "المركز"، أي المكان الذي تتّجه إليه الكاميرا)، والاتجاه، والإمالة، والمدى، والانحراف.

المركز (خط العرض وخط الطول والارتفاع)

يحدّد المركز النقطة المحدّدة في المساحة الثلاثية الأبعاد التي تراقبها الكاميرا. يتم تحديد ذلك باستخدام الفئة LatLngAltitude، التي تجمع بين قيم خطوط الطول والعرض والارتفاع. يتيح ذلك تحديد موضع نقطة تركيز الكاميرا بدقة في ثلاثة أبعاد.

يمكن أن يتراوح خط العرض بين 90- و90 درجة، مع تضمين القيمتين. تتراوح قيم خط الطول بين 180- و180 درجة، بما في ذلك هذان الرقمَان. يتم تحديد الارتفاع بالأمتار فوق مستوى سطح البحر.

العنوان

تحدّد الوجهة اتجاه البوصلة على الخريطة، ويتم قياسها بالدرجات في اتجاه عقارب الساعة من الشمال الحقيقي. يشير الشمال إلى 0 درجة، والشرق إلى 90 درجة، والجنوب إلى 180 درجة، والغرب إلى 270 درجة.

الإمالة

تحدّد زاوية الإمالة زاوية الكاميرا بالنسبة إلى المحور الرأسي، ويتم قياسها بالدرجات. تشير زاوية الميل البالغة 0 درجة إلى أنّ الكاميرا موجّهة للأسفل مباشرةً نحو الأرض (نقطة سمت القدم). يعني الميل بزاوية 90 درجة أنّ الكاميرا موجّهة أفقيًا في الاتجاه المحدّد بواسطة العنوان.

النطاق

يحدّد النطاق المسافة بالأمتار بين موضع الكاميرا ومركز الخريطة. يمكن أن يتراوح النطاق من صفر متر (لقطة مقرّبة جدًا) إلى ثلاثة وستين مليون متر، ما يتيح إمكانية عرض اللقطات من مسافة قريبة جدًا إلى منظور عالمي حقيقي. يتحكّم ذلك بشكل فعّال في درجة "التكبير" أو "التصغير" التي تظهر بها الخريطة.

الدوران

تحدّد قيمة الدوران زاوية الكاميرا بالنسبة إلى الأفق، ويتم قياسها بالدرجات. يمكن استخدام هذه المَعلمة لإنشاء تأثيرات مثل الميلان أثناء محاكاة الطيران أو حتى الدوران الكامل، وذلك بتدوير الكاميرا حول محور العرض.

التحكّم في الكاميرا

يوضّح نموذج الرمز البرمجي التالي كيفية التحكّم في الكاميرا آليًا من خلال استدعاء طريقة setCamera. لاستخدام عينة الرمز البرمجي هذه، اتّبِع التعليمات الواردة في الإعداد وإضافة خريطة ثلاثية الأبعاد إلى تطبيقك لإعداد مشروعك على Android Studio باستخدام خريطة ثلاثية الأبعاد أساسية. بعد ذلك، أضِف الرمز التالي إلى ملف 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
    }
)