ضبط الكاميرا
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك الكاميرا تغيير وجهة نظر المستخدم للخريطة. يمكنك استخدام أوضاع الكاميرا للتحكّم في سلوك عرض الخريطة أثناء التنقّل.
لضبط وضع الكاميرا، استدعِ إحدى الطرق التالية المرتبطة بالكاميرا:
اتّباع موقعي الجغرافي (GoogleMap.followMyLocation): وضع الكاميرا التلقائي للتنقّل يضبط هذا الوضع الكاميرا على الجهاز أو المركبة.
أثناء التنقّل، تتّجه الكاميرا تلقائيًا إلى اتجاه السير.
تثبيت الكاميرا في موقع جغرافي (GoogleMap.animateCamera وGoogleMap.moveCamera): يثبّت هذا الخيار الكاميرا في موقع جغرافي محدّد. عند استخدام هذا الوضع، يمكنك ضبط الموقع الجغرافي للكاميرا بالإضافة إلى خصائص الكاميرا الأخرى، مثل الاتجاه والميل والتكبير وغير ذلك. وعند اختيار طريقة العرض هذه وتهيئة "المستكشف"، يظهر الزر إعادة التوسيط.
عرض نظرة عامة على المسار (NavigationView.showRouteOverview أو SupportNavigationFragment.showRouteOverview): يعرض هذا الخيار نظرة عامة على المسار المتبقي (لمدة تصل إلى 45 دقيقة من وقت القيادة)، مع إمكانية تحريك الخريطة وتكبيرها أو تصغيرها حسب الحاجة لتناسب المسار مع عرض الخريطة. عند اختيار طريقة العرض هذه، يظهر الزر إعادة توسيط.
يؤدي النقر على الزر إعادة التوسيط إلى ضبط الكاميرا على الوضع followMyLocation.
اتّباع وضع الموقع الجغرافي
إنّ إعداد الكاميرا الأكثر شيوعًا هو ضبطها على الجهاز أو المركبة، ما يؤدي إلى عرض موضعها الحالي ضمن الرحلة. في وضع الكاميرا هذا، يمكنك عرض المسار مع توجيه السيارة دائمًا إلى أعلى الشاشة بزاوية مائلة (CameraPerspective.TILTED)، أو يمكنك عرض السيارة وهي تتنقّل مع الشمال (CameraPerspective.TOP_DOWN_NORTH_UP) أو مع الاتجاه (CameraPerspective.TOP_DOWN_HEADING_UP) دائمًا في أعلى الشاشة).
يستخدم جزء الرمز التالي منظور TILTED:
// Set the camera to follow the device (vehicle):
mNavFragment.getMapAsync(googleMap -> googleMap.followMyLocation(CameraPerspective.TILTED))
تثبيت في وضع الموقع
يمنحك الوضع Pinned أكبر قدر من التحكّم في الكاميرا. في هذا الوضع، يمكنك وضع الكاميرا في موقع جغرافي محدّد، وتحديد اتجاه لتوجيه عرض الكاميرا، وتغيير الميل لضبط زاوية العرض، وتحديد مستوى تكبير الكاميرا.
يوضّح مقتطف الرمز التالي بعض الطرق الشائعة لتحريك الكاميرا.
private static final LatLng SYDNEY = new LatLng(-33.88, 151.21);
private static final LatLng MOUNTAIN_VIEW = new LatLng(37.4, -122.1);
private GoogleMap map;
... // Obtain the map from a SupportNavigationFragment or NavigationView.
// Move the camera instantly to Sydney with a zoom of 15.
map.moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, 15));
// Zoom in, animating the camera.
map.animateCamera(CameraUpdateFactory.zoomIn());
// Zoom out to zoom level 10, animating with a duration of 2 seconds.
map.animateCamera(CameraUpdateFactory.zoomTo(10), 2000, null);
// Construct a CameraPosition focusing on Mountain View and animate the camera to that position.
CameraPosition cameraPosition = new CameraPosition.Builder()
.target(MOUNTAIN_VIEW) // Sets the center of the map to Mountain View
.zoom(17) // Sets the zoom
.bearing(90) // Sets the orientation of the camera to east
.tilt(30) // Sets the tilt of the camera to 30 degrees
.build(); // Creates a CameraPosition from the builder
map.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition));
عرض وضع النظرة العامة على المسار
يعرض إعداد showRouteOverview الكاميرا الرحلة بأكملها.
بالنسبة إلى الرحلات التي تتضمّن وجهات متعدّدة، يعرض هذا الوضع الجزء المتبقّي من المسار.
// Place the camera to see the remaining route:
mNavFragment.showRouteOverview();
الخطوة التالية
راجِع مقالة تخصيص واجهة مستخدم Navigation للتعرّف على كيفية تخصيص طريقة تفاعل المستخدمين مع خريطتك من خلال تحديد مكوّنات واجهة المستخدم المضمّنة التي تظهر على الخريطة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Navigation SDK offers three camera modes: \u003ccode\u003efollowMyLocation\u003c/code\u003e, \u003ccode\u003ePinned to location\u003c/code\u003e, and \u003ccode\u003eshowRouteOverview\u003c/code\u003e to control the user's viewpoint of the map during navigation.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003efollowMyLocation\u003c/code\u003e mode centers the map on the user's location and automatically adjusts during navigation, while \u003ccode\u003ePinned to location\u003c/code\u003e mode fixes the camera at a specific location with customizable properties.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eshowRouteOverview\u003c/code\u003e mode displays the entire route or remaining route, adjusting the view to fit the route on the screen.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize the camera's perspective, zoom level, bearing, and tilt to enhance the user experience.\u003c/p\u003e\n"],["\u003cp\u003eHigh detail setting, when enabled, displays 2-D building outlines when the zoom level is 19 or higher, which can be further customized using \u003ccode\u003eFollowMyLocationOptions\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Adjust the camera\n\nThe camera allows you to change the user's viewpoint of the map. You can\nuse camera modes to control the behavior of the map view during navigation.\nTo set the camera mode, call one of the following methods associated\nwith the camera:\n\n- Follow my location (`GoogleMap.followMyLocation`) --- The default camera\n mode for navigation. This mode sets the camera to the device or vehicle.\n During navigation, the camera automatically faces the direction of travel.\n\n- Pinned to location (`GoogleMap.animateCamera` and `GoogleMap.moveCamera`)\n --- Fixes the camera at a specific location. When using this mode, you can\n set the camera location along with other camera properties like bearing, tilt,\n zoom, etc. When this view is selected and the Navigator has been initialized,\n the **Re-center** button is visible.\n\n- Show route overview (`NavigationView.showRouteOverview` or\n `SupportNavigationFragment.showRouteOverview`) --- Displays an overview\n of the remaining route (up to the next 45 minutes of driving time), panning and zooming as needed to fit the route\n into the map view. When this view is selected, the **Re-center** button\n is visible.\n\nClicking the **Re-center** button sets the camera to `followMyLocation` mode.\n\nFollow my location mode\n-----------------------\n\nThe most common camera setting is to have the camera set to the\ndevice or vehicle, showing its current position within the journey. In\nthis camera mode, you can view the route with the car always headed up\nthe screen with an angled perspective (`CameraPerspective.TILTED`), or\nyou can see the car traveling with north (`CameraPerspective.TOP_DOWN_NORTH_UP`)\nor with heading (`CameraPerspective.TOP_DOWN_HEADING_UP)` always at the top of\nthe screen.\n\nThe following code fragment uses the `TILTED` perspective: \n\n // Set the camera to follow the device (vehicle):\n mNavFragment.getMapAsync(googleMap -\u003e googleMap.followMyLocation(CameraPerspective.TILTED))\n\nPinned to location mode\n-----------------------\n\nThe `Pinned` mode provides you with the most control of the\ncamera. In this mode, you place the camera in a specific location, assign\na bearing to orient the camera view, change the tilt to set the viewing angle, and\nset the camera's zoom level.\n\nThe following code snippet demonstrates some of the common ways to move the\ncamera. \n\n private static final LatLng SYDNEY = new LatLng(-33.88, 151.21);\n private static final LatLng MOUNTAIN_VIEW = new LatLng(37.4, -122.1);\n\n private GoogleMap map;\n ... // Obtain the map from a SupportNavigationFragment or NavigationView.\n\n // Move the camera instantly to Sydney with a zoom of 15.\n map.moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, 15));\n\n // Zoom in, animating the camera.\n map.animateCamera(CameraUpdateFactory.zoomIn());\n\n // Zoom out to zoom level 10, animating with a duration of 2 seconds.\n map.animateCamera(CameraUpdateFactory.zoomTo(10), 2000, null);\n\n // Construct a CameraPosition focusing on Mountain View and animate the camera to that position.\n CameraPosition cameraPosition = new CameraPosition.Builder()\n .target(MOUNTAIN_VIEW) // Sets the center of the map to Mountain View\n .zoom(17) // Sets the zoom\n .bearing(90) // Sets the orientation of the camera to east\n .tilt(30) // Sets the tilt of the camera to 30 degrees\n .build(); // Creates a CameraPosition from the builder\n map.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition));\n\nShow route overview mode\n------------------------\n\nThe `showRouteOverview` camera setting displays the entire journey.\nFor multiple-destination journeys, this mode displays the untraveled\nportion of the route. \n\n // Place the camera to see the remaining route:\n mNavFragment.showRouteOverview();\n\nNext step\n---------\n\nSee [Customize the Navigation UI](/maps/documentation/navigation/android-sdk/controls)\nto learn how to customize the way in which users interact with your map\nby determining which of the built-in UI components appear on the map."]]
