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

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

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

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

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

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

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

الاتجاه

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

الإمالة

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

النطاق

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

الدوران

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

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

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