يمكن للمستخدمين التحكّم في التكبير أو التصغير والإمالة والموضع والتدوير للكاميرا باستخدام الإيماءات على الخريطة.
يمكنك أيضًا ضبط إعدادات الكاميرا آليًا.
موضع الكاميرا
يتم تصميم عرض الخريطة على شكل كاميرا تنظر إلى نقطة معيّنة في مساحة ثلاثية الأبعاد.
يتم تحديد موضع الكاميرا واتجاهها (وبالتالي عرض الخريطة) من خلال الخصائص التالية: المركز (موقع جغرافي يتضمّن خطوط الطول والعرض والارتفاع الذي تنظر إليه الكاميرا)، والاتجاه، والميل، والمدى، والانحراف.
المركز (خط العرض/خط الطول/الارتفاع)
يحدّد المركز النقطة المحدّدة في المساحة الثلاثية الأبعاد التي تراقبها الكاميرا.
يتم تحديدها باستخدام قيم خطوط الطول والعرض والارتفاع. يتيح ذلك تحديد موضع نقطة التركيز للكاميرا بدقة في ثلاثة أبعاد.
يمكن أن يتراوح خط العرض بين 90- و90 درجة، مع تضمين القيمتين. سيتم تقريب أي قيم خارج هذا النطاق إلى أقرب قيمة ضمنه. على سبيل المثال،
سيؤدي تحديد خط عرض بقيمة 100 إلى ضبط القيمة على 90. يتراوح خط الطول بين 180- و180 درجة، ضِمنًا. يتم تحديد الارتفاع بالأمتار فوق مستوى سطح البحر.
العنوان
تحدّد جهة الكاميرا الاتجاه الذي ستتّخذه الكاميرا، ويتم قياسه بالدرجات في اتجاه عقارب الساعة بدءًا من الشمال الحقيقي. يتوافق الشمال مع 0 درجة، والشرق مع 90 درجة، والجنوب مع 180 درجة، والغرب مع 270 درجة. يحدّد هذا الخيار اتجاه الكاميرا حول المحور العمودي للنقطة المركزية.
الإمالة
تحدّد زاوية الإمالة زاوية الكاميرا بالنسبة إلى المحور الرأسي، ويتم قياسها بالدرجات. تشير زاوية الميل البالغة 0 درجة إلى أنّ الكاميرا موجّهة إلى الأسفل مباشرةً نحو الأرض (نقطة سمت القدم). يعني الميل بزاوية 90 درجة أنّ الكاميرا موجّهة أفقيًا في الاتجاه المحدّد بواسطة الاتجاه.
النطاق
يحدّد النطاق المسافة بالأمتار بين موضع الكاميرا والنقطة المركزية التي تنظر إليها. يمكن أن يتراوح النطاق من صفر متر (لقطة مقرّبة جدًا) إلى ثلاثة وستين مليون متر، ما يتيح إمكانية عرض اللقطات من مسافة قريبة جدًا إلى منظور عالمي حقيقي. يتحكّم هذا الإعداد بشكل فعّال في درجة تكبير الخريطة أو تصغيرها.
الدوران
تحدّد قيمة الدوران زاوية الكاميرا بالنسبة إلى الأفق، ويتم قياسها بالدرجات. يمكن استخدام هذه المَعلمة لإنشاء تأثيرات مثل الميلان أثناء محاكاة الطيران أو حتى الدوران الكامل، وذلك بتدوير الكاميرا حول محور العرض.
التحكّم في الكاميرا
يوضّح نموذج الرمز البرمجي التالي كيفية التحكّم في الكاميرا آليًا.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Configure camera controls\n\nSelect platform: [Android](/maps/documentation/maps-3d/android-sdk/configure-camera-controls \"View this page for the Android platform docs.\") [iOS](/maps/documentation/maps-3d/ios-sdk/configure-camera-controls \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/3d/map-controls \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\n| This product or feature is Experimental (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google\n| Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage descriptions](/maps/launch-stages).\n\n\nUsers can control the zoom, tilt, position, and rotation of the camera using gestures on the map.\nYou can also configure the camera programmatically.\n\nThe Camera Position\n-------------------\n\nThe map view is modeled as a **camera** looking at a specific point in a 3D space.\nThe position and orientation of the camera (and hence the rendering of the map) are specified by\nthe following properties: center (a latitude/longitude/altitude location the camera is looking\nat), heading, tilt, range, and roll.\n\n### Center (Latitude/Longitude/Altitude)\n\nThe **center** defines the specific point in 3D space that the camera is observing.\nThis is\nspecified using values for latitude, longitude, and altitude. This allows for precise\npositioning of the camera's focal point in three dimensions.\n\n\nThe latitude can be between -90 and 90 degrees, inclusive. Values\nabove or below this range will be clamped to the nearest value within this range. For example,\nspecifying a latitude of 100 will set the value to 90. Longitude\nranges between -180 and 180 degrees, inclusive. Altitude is specified in meters above\nsea level.\n\n### Heading\n\nThe camera **heading** specifies the direction the camera will point, measured in\ndegrees clockwise from true North. North corresponds to 0 degrees, East to 90 degrees, South to\n180 degrees, and West to 270 degrees. This determines the orientation of the camera around the\nvertical axis of the [center point](#center_location).\n\n### Tilt\n\nThe **tilt** specifies the angle of the camera with respect to the vertical axis,\nmeasured in degrees. A tilt of 0 degrees means the camera is pointing straight down towards the\nEarth ([nadir](https://en.wikipedia.org/wiki/Nadir)). A tilt of 90\ndegrees means the camera is pointed horizontally in the direction\nspecified by the [heading](#heading_orientation).\n\n### Range\n\nThe **range** defines the distance in meters between the camera's own position and\nthe [center point](#center_location) it is looking at. The range can vary from zero\nmeters (very close up) up to sixty-three million meters, allowing for views from very close up all\nthe way to a truly global perspective. This effectively controls how \"zoomed in\" or \"zoomed out\"\nthe map appears.\n\n### Roll\n\n\nThe **roll** sets the angle of the camera with respect to the horizon,\nmeasured in degrees. This parameter can be used to create effects like banking during flight\nsimulations or even a full barrel roll, rotating the camera around its viewing axis.\n\nControlling the camera\n----------------------\n\nThe following code sample demonstrates how to control the camera programmatically. \n\n### Swift\n\n```swift\npublic static var sanFrancisco: Camera = .init(\n latitude: 37.7845812,\n longitude: -122.3660241,\n altitude: 585,\n heading: 288.0,\n tilt: 75.0,\n roll: 0.0,\n range: 100)\n\n \n```"]]
