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