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