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

اختيار النظام الأساسي: Android iOS JavaScript

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

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

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

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

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

يحدِّد المركز النقطة المحدّدة في المساحة الثلاثية الأبعاد التي ترصدها الكاميرا. يتم تحديد ذلك باستخدام فئة 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
    }
)