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

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

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

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

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

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

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

الاتجاه

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

الإمالة

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

النطاق

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

الدوران

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

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

توضّح عيّنة التعليمات البرمجية التالية كيفية التحكّم في الكاميرا آليًا من خلال استدعاء 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
    }
)