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

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

خريطة Google

الفئة النهائية العامة GoogleMap توسّع الكائن

هذه هي الفئة الرئيسية من حزمة تطوير البرامج (SDK) لخرائط Google لنظام التشغيل Android، وهي نقطة الدخول لجميع الطرق ذات الصلة بالخريطة. لا يمكنك إنشاء مثيل لكائن GoogleMap مباشرةً، بل عليك الحصول على نموذج من طريقة getMapAsync() في MapFragment أو MapView أضفته إلى تطبيقك.

ملاحظة: كما هو الحال مع كائن View، لا يمكن قراءة GoogleMap وتعديله إلا من خلال سلسلة محادثات واجهة مستخدم Android. وسيؤدي طلب طُرق GoogleMap من سلسلة محادثات أخرى إلى استخدام استثناء.

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

دليل المطوِّر

للبدء، اقرأ دليل مطوّري البرامج حزمة تطوير البرامج (SDK) لخرائط Google لنظام التشغيل Android) .

ملخص الفئة المدمَجة

واحدة	GoogleMap.CancelableCallback	واجهة معاودة الاتصال لإعداد التقارير عند اكتمال مهمة أو إلغاؤها
واحدة	GoogleMap.InfoWindowAdapter	يوفّر طرق عرض لعرض نوافذ المعلومات بطريقة مخصّصة.
واحدة	GoogleMap.OnCameraChangeListener	تم إيقاف هذه الواجهة. تم استبداله بـ `GoogleMap.OnCameraMoveStartedListener` و`GoogleMap.OnCameraMoveListener` و`GoogleMap.OnCameraIdleListener`. إنّ ترتيب استدعاء طريقة `onCameraChange` المتوقّفة نهائيًا بالنسبة إلى الطرق في أدوات معالجة تغيير الكاميرا الجديدة غير معروف.
واحدة	GoogleMap.OnCameraIdleListener	واجهة معاودة الاتصال عند انتهاء حركة الكاميرا
واحدة	GoogleMap.OnCameraMoveCanceledListener	واجهة معاودة الاتصال عند إيقاف حركة الكاميرا أو عند بدء تحريك الكاميرا لسبب جديد
واحدة	GoogleMap.OnCameraMoveListener	واجهة معاودة الاتصال عندما يتم تغيير موضع الكاميرا
واحدة	GoogleMap.OnCameraMoveStartedListener	واجهة معاودة الاتصال لاستخدامها عند بدء حركة الكاميرا
واحدة	GoogleMap.OnCircleClickListener	واجهة معاودة الاتصال عند النقر على دائرة.
واحدة	GoogleMap.OnGroundOverlayClickListener	واجهة معاودة الاتصال عند النقر على تراكب أرضي
واحدة	GoogleMap.OnIndoorStateChangeListener	أداة معالجة عند تغيُّر الحالة الداخلية
واحدة	GoogleMap.OnInfoWindowClickListener	واجهة معاودة الاتصال لأحداث النقر/النقر على نافذة معلومات العلامة
واحدة	GoogleMap.OnInfoWindowCloseListener	واجهة معاودة الاتصال للأحداث المغلقة على نافذة معلومات العلامة.
واحدة	GoogleMap.OnInfoWindowLongClickListener	واجهة رد الاتصال عندما يضغط المستخدم مع الاستمرار على نافذة معلومات العلامة.
واحدة	GoogleMap.OnMapClickListener	واجهة معاودة الاتصال لاستخدامها عندما ينقر المستخدم على الخريطة
واحدة	GoogleMap.OnMapLoadedCallback	واجهة معاودة الاتصال عند الانتهاء من عرض الخريطة
واحدة	GoogleMap.OnMapLongClickListener	واجهة رد الاتصال عندما يضغط المستخدم مع الاستمرار على الخريطة.
واحدة	GoogleMap.OnMarkerClickListener	يحدد التوقيعات للطرق التي يتم استدعاؤها عند النقر على علامة أو النقر عليها.
واحدة	GoogleMap.OnMarkerDragListener	واجهة معاودة الاتصال لأحداث السحب على العلامات
واحدة	GoogleMap.OnMyLocationButtonClickListener	واجهة معاودة الاتصال عند النقر على زر "موقعي".
واحدة	GoogleMap.OnMyLocationChangeListener	تم إيقاف هذه الواجهة. استخدِم com.google.android.gms.location.FusedLocationProviderApi بدلاً من ذلك. يوفّر FusedLocationProviderApi ميزة مُحسَّنة للبحث عن الموقع الجغرافي واستخدام الطاقة وتستخدمه النقطة الزرقاء في "موقعي". اطّلِع على البرنامج التعليمي "اختيار المكان الحالي"، الذي يستخدم FusedLocationProviderApi أو دليل مطوّر برامج الموقع الجغرافي.
واحدة	GoogleMap.OnMyLocationClickListener	واجهة معاودة الاتصال التي تظهر عند النقر على نقطة "موقعي الجغرافي" (التي تشير إلى الموقع الجغرافي للمستخدم)
واحدة	GoogleMap.OnPoiClickListener	أداة معالجة للنقرات على نقاط الاهتمام
واحدة	GoogleMap.OnPolygonClickListener	واجهة معاودة الاتصال عند النقر على مضلّع
واحدة	GoogleMap.OnPolylineClickListener	واجهة معاودة الاتصال عند النقر على خطوط متعدّدة
واحدة	GoogleMap.SnapshotReadyCallback	واجهة معاودة الاتصال لإرسال إشعار عند أخذ اللقطة

الملخّص الثابت

int	MAP_TYPE_HYBRID	خرائط القمر الصناعي مع طبقة شفافة من الشوارع الرئيسية.
int	MAP_TYPE_NONE	لا تتوفر مربعات خريطة أساسية.
int	MAP_TYPE_NORMAL	الخرائط الأساسية.
int	MAP_TYPE_SATELLITE	خرائط القمر الصناعي بدون تصنيفات
int	MAP_TYPE_TERRAIN	خرائط التضاريس.

ملخّص الطريقة العلنية

دائرة	addCircle(خيارات CircleOptions) إضافة دائرة إلى هذه الخريطة.
GroundOverlay	addGroundOverlay(خيارات GroundOverlayOptions) لإضافة صورة إلى هذه الخريطة.
محدِّد الموقع	addMarker(خيارات MarkerOptions) لإضافة علامة إلى هذه الخريطة.
المضلّع	addPolygon(خيارات PolygonOptions) لإضافة مضلّع إلى هذه الخريطة.
الخطوط المتعددة	addPolyline(خيارات PolylineOptions) لإضافة خط متعدد إلى هذه الخريطة.
TileOverlay	addTileOverlay(خيارات TileOverlayOptions) تضيف تراكب الصور إلى هذه الخريطة.
void	animateCamera(تحديثCameraUpdate) يؤدي هذا الخيار إلى تحريك حركة الكاميرا من الموضع الحالي إلى الموضع المحدّد في التحديث.
void	animateCamera(CameraUpdate ، GoogleMap.CancelableCallback معاودة الاتصال) تعمل هذه الميزة على تحريك حركة الكاميرا من الموضع الحالي إلى الموضع المحدّد في التحديث، ثم طلب معاودة الاتصال اختياريًا عند الانتهاء.
void	animateCamera(تحديث CameraUpdate وint durationMs وGoogleMap.CancelableCallback) لتحريك الخريطة وفقًا للتحديث باستخدام صورة متحركة خلال مدة محدّدة، ويستدعي معاودة الاتصال اختياريًا عند الانتهاء.
void	clear() إزالة جميع العلامات والخطوط المتعددة والمضلعات والتراكبات وغيرها من الخريطة.
CameraPosition	getCameraPosition() للحصول على الموضع الحالي للكاميرا.
IndoorBuilding	getFocusedBuilding() الوصول إلى المبنى محلّ التركيز حاليًا
int	getMapType() للحصول على نوع الخريطة المعروضة حاليًا.
float	getMaxZoomLevel() لعرض الحد الأقصى لمستوى التكبير أو التصغير للموضع الحالي للكاميرا.
float	getMinZoomLevel() لعرض الحد الأدنى لمستوى التكبير أو التصغير.
الموقع الجغرافي	getMyLocation() تم إيقاف هذه الطريقة نهائيًا. use com.google.android.gms.location.FusedLocationProviderApi instead. يوفّر FusedLocationProviderApi ميزة مُحسَّنة للبحث عن الموقع الجغرافي واستخدام الطاقة وتستخدمه النقطة الزرقاء في "موقعي". اطّلِع على MyLocationDemoActivity في مجلد نماذج التطبيقات، مثل الرموز البرمجية، أو دليل المطوّر للمواقع الجغرافية.
التوقّع	getProjection() تعرض عنصر `Projection` يمكنك استخدامه للتحويل بين إحداثيات الشاشة وإحداثيات خطوط العرض/الطول.
UiSettings	getUiSettings() الحصول على إعدادات واجهة المستخدم للخريطة.
boolean	isBuildingsEnabled() لعرض ما إذا كانت طبقة المباني الثلاثية الأبعاد مُفعَّلة.
boolean	isIndoorEnabled() معرفة ما إذا كانت الخرائط الداخلية مفعَّلة حاليًا
boolean	isMyLocationEnabled() للحصول على حالة طبقة موقعي.
boolean	isTrafficEnabled() يتحقّق مما إذا كانت الخريطة ترسم بيانات حركة المرور.
void	moveCamera(تحديث CameraUpdate) تغيير موضع الكاميرا وفقًا للتعليمات المحدّدة في التحديث.
void	resetMinMaxZoomPreference() لإزالة أي حدود تكبير/تصغير علوية ودنيا تم تحديدها مسبقًا.
void	setBuildingsEnabled(تفعيل منطقي) لتفعيل طبقة المباني الثلاثية الأبعاد أو إيقافها.
void	setContentDescription(وصف السلسلة) لتعيين contentDescription للخريطة.
boolean	setIndoorEnabled(تفعيل منطقي) تحدِّد هذه السياسة ما إذا كان يجب تفعيل الخرائط الداخلية.
void	setInfoWindowAdapter(محوّل GoogleMap.InfoWindowAdapter) لضبط عارض مخصَّص لمحتويات نوافذ المعلومات
void	setLatLngBoundsForCameraTarget(حدود LatLngBounds) وتحدِّد هذه العلامة خط الطول والعرض لتقييد هدف الكاميرا، وبالتالي عندما يقوم المستخدمون بالتمرير وتحريك الخريطة، لا يتحرك هدف الكاميرا خارج هذه الحدود.
void	setLocationSource(مصدر LocationSource) لاستبدال مصدر الموقع لطبقة موقعي.
boolean	setMapStyle(نمط MapStyleOptions) لضبط تصميم الخريطة الأساسية
void	setMapType(نوع int) تعيين نوع مربعات الخرائط التي يجب عرضها.
void	setMaxZoomPreference(float maxZoomPreferences) لضبط الحد الأعلى المفضّل لتكبير/تصغير الكاميرا.
void	setMinZoomPreference(float minZoomPreferences) لضبط الحد الأدنى المفضّل لتكبير/تصغير الكاميرا.
void	setMyLocationEnabled(تفعيل منطقي) لتفعيل طبقة موقعي أو إيقافها.
void	setOnCameraChangeListener(GoogleMap.OnCameraChangeListener مستمع)) تم إيقاف هذه الطريقة نهائيًا. تم استبداله بـ `setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)` و`setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)` و`setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)` و`setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)`.
void	setOnCameraIdleListener(GoogleMap.OnCameraIdleListener مستمع)) تعمل هذه السياسة على ضبط معاودة الاتصال التي يتم استدعاؤها عند انتهاء حركة الكاميرا.
void	setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener مستمع)) لضبط معاودة الاتصال التي يتم استدعاءها عند إيقاف حركة الكاميرا أو مقاطعتها بسبب نوع جديد من الصور المتحركة.
void	setOnCameraMoveListener(GoogleMap.OnCameraMoveListener مستمع)) لضبط معاودة الاتصال التي يتم استدعاؤها بشكل متكرر عندما تكون الكاميرا تتحرك.
void	setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener مستمع)) تضبط هذه السياسة معاودة الاتصال التي يتم استدعاءها عند بدء حركة الكاميرا أو تغيّر سبب حركة الكاميرا.
void	setOnCircleClickListener(GoogleMap.OnCircleClickListener مستمع) لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على دائرة.
void	setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener مستمع) تحدِّد معاودة الاتصال التي يتم استدعاؤها عند النقر على تركيب أرضي.
void	setOnIndoorStateChangeListener(GoogleMap.OnIndoorStateChangeListener مستمع)) تعمل هذه السياسة على ضبط المستمِع أو محوه للأحداث الداخلية.
void	setOnInfoWindowClickListener(GoogleMap.OnInfoWindowClickListener مستمع)) لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على نافذة معلومات العلامة.
void	setOnInfoWindowCloseListener(GoogleMap.OnInfoWindowCloseListener مستمع)) لضبط معاودة الاتصال التي يتم استدعاؤها عند إغلاق نافذة معلومات العلامة.
void	setOnInfoWindowLongClickListener(GoogleMap.OnInfoWindowLongClickListener مستمع)) لضبط معاودة الاتصال التي يتم استدعاؤها عند الضغط لفترة طويلة على نافذة معلومات العلامة.
void	setOnMapClickListener(GoogleMap.OnMapClickListener مستمع) لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على الخريطة.
void	setOnMapLoadedCallback(معاودة الاتصال في GoogleMap.OnMapLoadedCallback) تحدِّد هذه السياسة معاودة الاتصال التي يتم استدعاؤها عند الانتهاء من عرض هذه الخريطة.
void	setOnMapLongClickListener(GoogleMap.OnMapLongClickListener مستمع) لضبط معاودة الاتصال التي يتم استدعاؤها عند الضغط لفترة طويلة على الخريطة.
void	setOnMarkerClickListener(GoogleMap.OnMarkerClickListener مستمع) لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على علامة.
void	setOnMarkerDragListener(GoogleMap.OnMarkerDragListener مستمع)) لضبط معاودة الاتصال التي يتم استدعاؤها عند سحب علامة.
void	setOnMyLocationButtonClickListener(GoogleMap.OnMyLocationButtonClickListener مستمع) لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على زر موقعي.
void	setOnMyLocationChangeListener(GoogleMap.OnMyLocationChangeListener مستمع)) تم إيقاف هذه الطريقة نهائيًا. use com.google.android.gms.location.FusedLocationProviderApi instead. يوفّر FusedLocationProviderApi ميزة مُحسَّنة للبحث عن الموقع الجغرافي واستخدام الطاقة وتستخدمه النقطة الزرقاء في "موقعي". اطّلِع على MyLocationDemoActivity في مجلد نماذج التطبيقات، مثل الرموز البرمجية، أو دليل المطوّر للمواقع الجغرافية.
void	setOnMyLocationClickListener(GoogleMap.OnMyLocationClickListener مستمع)) تعمل على ضبط معاودة الاتصال التي يتم استدعاءها عند النقر على نقطة "موقعي الجغرافي" (التي تدل على الموقع الجغرافي للمستخدم).
void	setOnPoiClickListener(GoogleMap.OnPoiClickListener مستمع) لضبط أداة معالجة يتم تشغيلها عند النقر على نقطة اهتمام أو النقر عليها.
void	setOnPolygonClickListener(GoogleMap.OnPolygonClickListener مستمع) لتعيين معاودة الاتصال التي يتم استدعاؤها عند النقر على مضلّع.
void	setOnPolylineClickListener(GoogleMap.OnPolylineClickListener مستمع) تحدِّد هذه الدالة معاودة الاتصال التي يتم استدعاؤها عند النقر على خطوط متعدّدة.
void	setPadding(int left, int top, int right, int below) لضبط المساحة المتروكة على الخريطة.
void	setTrafficEnabled(تفعيل منطقي) تفعيل طبقة حركة المرور أو إيقافها.
void	snapshot(معاودة الاتصال بـ GoogleMap.SnapshotReadyCallback) أخذ لقطة للخريطة.
void	snapshot(معاودة الاتصال في GoogleMap.SnapshotReadyCallback، الصورة النقطية للصور النقطية) أخذ لقطة للخريطة.
void	stopAnimation() يوقف الصورة المتحركة للكاميرا إذا كانت هناك واحدة قيد التقدم.

ملخّص الطريقة المكتسبة

من الفئة java.lang.Object

boolean	equals(كائن arg0)
الفئة النهائية<?>	getClass()
int	hashCode()
الفراغ الأخير	notify()
الفراغ الأخير	notifyAll()
سلسلة	toString()
الفراغ الأخير	انتظار(long arg0, int arg1)
الفراغ الأخير	انتظار(طول طويل arg0)
الفراغ الأخير	نحن()

الثوابت

عدد صحيح نهائي ثابت علني MAP_TYPE_HYBRID

خرائط القمر الصناعي مع طبقة شفافة من الشوارع الرئيسية.

القيمة الثابتة: 4

عدد صحيح نهائي ثابت علني MAP_TYPE_NONE

لا تتوفر مربعات خريطة أساسية.

القيمة الثابتة: 0

عدد صحيح نهائي ثابت متاح للجميع MAP_TYPE_NORMAL

الخرائط الأساسية.

القيمة الثابتة: 1

عدد صحيح نهائي ثابت علني MAP_TYPE_SATELLITE

خرائط القمر الصناعي بدون تصنيفات

القيمة الثابتة: 2

عدد صحيح نهائي ثابت علني MAP_TYPE_TERRAIN

خرائط التضاريس.

القيمة الثابتة: 3

الطرق العامة

عامة دائرة addCircle (خيارات CircleOptions)

إضافة دائرة إلى هذه الخريطة.

المَعلمات

الخيارات	كائن خيارات للدائرة يحدد كيفية عرض الدائرة

المرتجعات

عنصر Circle الذي تتم إضافته إلى الخريطة

عامة GroundOverlay addGroundOverlay (GroundOverlayOptions)

لإضافة صورة إلى هذه الخريطة.

المَعلمات

الخيارات	يشير ذلك المصطلح إلى كائن خيارات التراكب الأرضي الذي يحدّد كيفية عرض التراكب. يجب أن تحتوي الخيارات على صورة (AnchoredBitmap) وموضع محدّد.

المرتجعات

GroundOverlay التي تمت إضافتها إلى الخريطة.

الرميات

IllegalArgumentException	إذا لم يتم تحديد الصورة أو الموضع في الخيارات.

عامة Marker addMarker (MarkerOptions)

لإضافة علامة إلى هذه الخريطة.

يتم عرض رمز العلامة على الخريطة في موقع Marker.position. يؤدي النقر على العلامة إلى توسيط الكاميرا على العلامة. في حال تحديد Marker.title، ستعرض الخريطة مربّع معلومات مع عنوان العلامة ومقتطفها. إذا كانت العلامة قابلة للسحب، يؤدي النقر مع الاستمرار ثم سحب العلامة إلى نقلها.

المَعلمات

الخيارات	كائن خيارات العلامة الذي يحدد كيفية عرض العلامة.

المرتجعات

Marker التي تمت إضافتها إلى الخريطة.

عامة Polygon addPolygon (PolygonOptions خيارات)

لإضافة مضلّع إلى هذه الخريطة.

المَعلمات

الخيارات	كائن خيارات المضلع يحدد كيفية عرض المضلّع.

المرتجعات

تمثّل هذه السمة عنصر Polygon الذي تتم إضافته إلى الخريطة.

عامة Polyline addPolyline (PolylineOptions)

لإضافة خط متعدد إلى هذه الخريطة.

المَعلمات

الخيارات	يشير ذلك المصطلح إلى كائن خيارات خطوط متعدّدة يحدّد كيفية عرض الخط المتعدد.

المرتجعات

عنصر Polyline الذي تمت إضافته إلى الخريطة.

public TileOverlay addTileOverlay (خيارات TileOverlayOptions)

تضيف تراكب الصور إلى هذه الخريطة. يمكنك الاطّلاع على TileOverlay لمزيد من المعلومات.

يُرجى العِلم أنّه لا تتم استعادة العناصر المركّبة تلقائيًا، على عكس العناصر المركّبة الأخرى، في حال إعادة إنشاء الخريطة، ويجب إعادة إضافتها يدويًا.

المَعلمات

الخيارات	كائن خيارات تراكب الصور يحدد كيفية عرض التراكب. يجب أن تحتوي الخيارات على علامة `TileProvider` محدّدة، وإلا سيتم طرح `IllegalArgumentException`.

المرتجعات

TileOverlay التي تمت إضافتها إلى الخريطة.

الرميات

IllegalArgumentException	إذا لم يتم تحديد `TileProvider` في الخيارات

إلغاء علني animateCamera (CameraUpdate)

يؤدي هذا الخيار إلى تحريك حركة الكاميرا من الموضع الحالي إلى الموضع المحدّد في التحديث. أثناء العرض المتحرك، تعرض المكالمة إلى getCameraPosition() موقعًا متوسطًا للكاميرا.

يمكنك الانتقال إلى CameraUpdateFactory للاطّلاع على مجموعة من التحديثات.

المَعلمات

تحديث	التغيير الذي يجب تطبيقه على الكاميرا

عامة فارغة animateCamera (CameraUpdate ، GoogleMap.CancelableCallback معاودة الاتصال)

تعمل هذه الميزة على تحريك حركة الكاميرا من الموضع الحالي إلى الموضع المحدّد في التحديث، ثم طلب معاودة الاتصال اختياريًا عند الانتهاء. يمكنك الانتقال إلى CameraUpdateFactory للاطّلاع على مجموعة من التعديلات.

أثناء العرض المتحرك، تعرض المكالمة إلى getCameraPosition() موقعًا متوسطًا للكاميرا.

المَعلمات

تحديث التغيير الذي يجب تطبيقه على الكاميرا

رد الاتصال معاودة الاتصال المطلوب استدعاءها من سلسلة محادثات واجهة مستخدم Android عند توقف الصورة المتحركة. إذا اكتملت الصورة المتحركة بشكل طبيعي، يتم تسمية السمة onFinish()، وبخلاف ذلك، يتم تسمية العنصر onCancel(). يُرجى عدم تحديث الكاميرا أو تحريكها من داخل onCancel().

عامة فارغة animateCamera (CameraUpdate تحديث, int durationMs, GoogleMap.CancelableCallback معاودة الاتصال)

لتحريك الخريطة وفقًا للتحديث باستخدام صورة متحركة خلال مدة محدّدة، ويستدعي معاودة الاتصال اختياريًا عند الانتهاء. يمكنك الانتقال إلى CameraUpdateFactory للاطّلاع على مجموعة من التحديثات.

إذا تم استدعاء الدالة getCameraPosition() أثناء تشغيل الصورة المتحركة، سيتم عرض الموقع الجغرافي الحالي للكاميرا أثناء الطيران.

المَعلمات

تحديث
durationMs	مدة الحركة بالمللي ثانية. ويجب أن يكون هذا الحقل إيجابيًا تمامًا، وإلا سيتم تجاهل `IllegalArgumentException`.
رد الاتصال	معاودة الاتصال اختيارية ليتم إشعارها من سلسلة محادثات واجهة مستخدم Android عند إيقاف الصورة المتحركة. إذا توقّفت الصورة المتحركة بسبب اكتمالها بشكل طبيعي، سيتم إرسال إشعار إلى معاودة الاتصال عبر `onFinish()`. وإذا توقّفت الصورة المتحركة بسبب انقطاعها من خلال حركة لاحقة للكاميرا أو من خلال إيماءة مستخدم، سيتم الاتصال بـ `onCancel()`. ويجب ألا تحاول معاودة الاتصال تحريك الكاميرا أو تحريكها أثناء عملية الإلغاء. إذا لم تكن بحاجة إلى معاودة الاتصال، اتركه على `null`.

فارغ علني واضح ()

إزالة جميع العلامات والخطوط المتعددة والمضلعات والتراكبات وغيرها من الخريطة.

عامة CameraPosition getCameraPosition ()

للحصول على الموضع الحالي للكاميرا.

إنّ القيمة CameraPosition المعروضة هي لقطة للموضع الحالي، ولن يتم تعديلها تلقائيًا عندما تتحرك الكاميرا.

لمزيد من المعلومات حول تغيير موضع الكاميرا، يُرجى الاطّلاع على الكاميرا والعرض.

المرتجعات

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

public IndoorBuilding getFocusedBuilding ()

الوصول إلى المبنى محلّ التركيز حاليًا

المرتجعات

المبنى محل التركيز حاليًا أو null إذا لم يكن هناك مبنى محل التركيز.

public int getMapType ()

للحصول على نوع الخريطة المعروضة حاليًا. يمكنك الاطّلاع على MAP_TYPE_NORMAL وMAP_TYPE_SATELLITE وMAP_TYPE_TERRAIN لمعرفة القيم المحتمَلة.

المرتجعات

نوع الخريطة.

عامة عائمة getMaxZoomLevel ()

لعرض الحد الأقصى لمستوى التكبير أو التصغير للموضع الحالي للكاميرا. ويضع ذلك في الاعتبار نوع الخريطة المستخدَم حاليًا، على سبيل المثال، قد يكون للقمر الصناعي أو التضاريس مستوى تكبير أقل من مربّعات الخرائط الأساسية.

لمزيد من المعلومات حول تغيير مستوى تكبير/تصغير الكاميرا، راجع الكاميرا والعرض.

المرتجعات

الحد الأقصى لمستوى التكبير أو التصغير المتاح في موضع الكاميرا الحالي

عامة عائمة getMinZoomLevel ()

لعرض الحد الأدنى لمستوى التكبير أو التصغير. وينطبق ذلك على كل موقع جغرافي (على عكس الحد الأقصى لمستوى التكبير) ولكنّه قد يختلف باختلاف الأجهزة وأحجام الخرائط.

لمزيد من المعلومات حول تغيير مستوى تكبير/تصغير الكاميرا، راجع الكاميرا والعرض.

المرتجعات

الحدّ الأدنى لمستوى التكبير أو التصغير المتاح.

Public Location getMyLocation ()

تم إيقاف هذه الطريقة نهائيًا.
استخدِم com.google.android.gms.location.FusedLocationProviderApi بدلاً من ذلك. يوفّر FusedLocationProviderApi ميزة مُحسَّنة للبحث عن الموقع الجغرافي واستخدام الطاقة وتستخدمه النقطة الزرقاء في "موقعي". اطّلِع على MyLocationDemoActivity في مجلد نماذج التطبيقات للحصول على رمز مثال أو دليل المطوّر للمواقع الجغرافية.

تعرض هذه الدالة الموقع الجغرافي المعروض حاليًا للمستخدم، أو تعرض القيمة null إذا لم تتوفر بيانات عن الموقع الجغرافي.

المرتجعات

القيمة المعروضة حاليًا هي user location.

الرميات

IllegalStateException	إذا كانت طبقة موقعي غير مفعَّلة.

عامة مشروع getProjection ()

تعرض عنصر Projection يمكنك استخدامه للتحويل بين إحداثيات الشاشة وإحداثيات خطوط العرض/الطول.

إنّ Projection التي يتم عرضها هي لقطة للإسقاط الحالي، ولن يتم تعديلها تلقائيًا عندما تتحرك الكاميرا. وبما أنّ هذه العملية مكلفة، سيظهر العرض مرة واحدة فقط لكل شاشة. تستخدم "خرائط Google" إسقاط ماركتور لإنشاء خرائطه من البيانات الجغرافية وتحويل النقاط على الخريطة إلى إحداثيات جغرافية.

المرتجعات

Projection للخريطة في حالتها الحالية.

عامة UiSettings getUiSettings ()

الحصول على إعدادات واجهة المستخدم للخريطة.

المرتجعات

UiSettings لهذه الخريطة.

public منطقي isBuildingsEnabled ()

لعرض ما إذا كانت طبقة المباني الثلاثية الأبعاد مُفعَّلة.

المرتجعات

true إذا تم تفعيل المباني، وfalse بخلاف ذلك.

عامة منطقية isIndoorEnabled ()

معرفة ما إذا كانت الخرائط الداخلية مفعَّلة حاليًا

المرتجعات

true في حال تفعيل الخرائط الداخلية، وfalse في حال إيقاف الخرائط الداخلية

عامة منطقية isMyLocationEnabled ()

للحصول على حالة طبقة موقعي.

المرتجعات

true إذا كانت طبقة موقعي الجغرافي مفعَّلة، وfalse بخلاف ذلك.

public منطقي isTrafficEnabled ()

يتحقّق مما إذا كانت الخريطة ترسم بيانات حركة المرور. ويعتمد ذلك على مدى توفُّر بيانات حركة المرور.

المرتجعات

true إذا تم تفعيل بيانات حركة المرور، وfalse بخلاف ذلك.

إلغاء علني moveCamera (CameraUpdate)

تغيير موضع الكاميرا وفقًا للتعليمات المحدّدة في التحديث. تتم عملية النقل بشكل فوري، وستعكس قيمة getCameraPosition() اللاحقة الموضع الجديد. يمكنك الانتقال إلى CameraUpdateFactory للاطّلاع على مجموعة من التعديلات.

المَعلمات

تحديث	التغيير الذي يجب تطبيقه على الكاميرا

إبطال عام resetMinMaxZoomPreference ()

لإزالة أي حدود تكبير/تصغير علوية ودنيا تم تحديدها مسبقًا.

إبطال عام setBuildingsEnabled (boolean enabled)

لتفعيل طبقة المباني الثلاثية الأبعاد أو إيقافها.

المَعلمات

مفعّلة	`true` لتفعيل طبقة المباني الثلاثية الأبعاد، و`false` لإيقاف المباني الثلاثية الأبعاد.

إلغاء عام setContentDescription (وصف السلسلة)

لتعيين contentDescription للخريطة.

يستخدم هذا لتقديم وصف منطوق للخريطة في وضع إمكانية الوصول. القيمة التلقائية هي "خرائط Google".

المَعلمات

الوصف	سلسلة لاستخدامها كوصف.

منطقية عامة setIndoorEnabled (boolean enabled)

تحدِّد هذه السياسة ما إذا كان يجب تفعيل الخرائط الداخلية. في الوقت الحالي، يمكن عرض الخرائط الداخلية على خريطة واحدة فقط في كل مرة، وتكون هذه هي الخريطة الأولى التي تتم إضافتها إلى تطبيقك تلقائيًا. لتفعيل الخرائط الداخلية على خريطة أخرى، يجب أولاً إيقاف الخرائط الداخلية على الخريطة الأصلية. إذا حاولت تفعيل الخرائط الداخلية بعد تفعيلها على خريطة أخرى، لن يحدث أي شيء وسيعرض false. عند عدم تفعيل "داخلي" لإحدى الخرائط، ستعرض جميع الطرق ذات الصلة بـ "داخل المنزل" null أو false.

المَعلمات

مفعّلة	`true` لمحاولة تفعيل الخرائط الداخلية، `false` لإيقاف الخرائط الداخلية.

المرتجعات

ما إذا كان من الممكن تفعيل الخرائط الداخلية.

عامة إلغاء setInfoWindowAdapter (GoogleMap.InfoWindowAdapter)

لضبط عارض مخصَّص لمحتويات نوافذ المعلومات

مثل أدوات معالجة الأحداث على الخريطة، لا يتم إنشاء سلسلة من هذه الولاية مع الخريطة. في حال إعادة إنشاء الخريطة (على سبيل المثال، بسبب تغيير في الإعدادات)، يجب الحرص على استدعاء هذه الطريقة مرة أخرى من أجل الحفاظ على التخصيص.

المَعلمات

محوّل	المحوِّل المطلوب استخدامه لعرض محتوى نافذة المعلومات، أو `null` لاستخدام المحتوى التلقائي الذي يتم عرضه في نوافذ المعلومات.

إلغاء علني setLatLngBoundsForCameraTarget (LatLngBounds)

وتحدِّد هذه العلامة خط الطول والعرض لتقييد هدف الكاميرا، وبالتالي عندما يقوم المستخدمون بالتمرير وتحريك الخريطة، لا يتحرك هدف الكاميرا خارج هذه الحدود.

اضبط القيمة على قيمة فارغة لمحو مربّع الإحاطة بالكامل. وتحلّ الحدود الجديدة محلّ أي مربّع حدود سبق تحديده.

وعند تغيير LatLngBounds، تضبط حزمة تطوير البرامج (SDK) جميع تحديثات الكاميرا اللاحقة لمراعاة تلك الحدود إن أمكن. يُرجى العلم أنّ هناك اعتبارات فنية قد تمنع حزمة تطوير البرامج (SDK) من إبقاء الكاميرا المستهدفة ضمن الحدود المسموح بها تمامًا. على سبيل المثال، أخطاء تقريب دقة النقطة العائمة أو مستوى التكبير أو التصغير منخفض جدًا.

المَعلمات

حدود	الحدود التي ستضيق نطاق هدف الكاميرا.

إلغاء عام setLocationSource (LocationSource المصدر)

لاستبدال مصدر الموقع لطبقة موقعي.

المَعلمات

source	مصدر موقع لاستخدامه في طبقة موقعي. اضبط القيمة على `null` لاستخدام المصدر التلقائي للموقع الجغرافي.

عامة منطقية setMapStyle (نمط MapStyleOptions)

لضبط تصميم الخريطة الأساسية

باستخدام خيارات النمط، يمكنك تطبيق أنماط مخصصة على الميزات والعناصر على الخريطة. راجع MapStyleOptions للحصول على تفاصيل تعريف النمط.

ويمكنك ضبطها على قيمة فارغة لمحو أيّ تصميم مخصّص سابق.

المَعلمات

style

المرتجعات

true إذا تم تحليل النمط بنجاح، أو false إذا تم رصد مشاكل في MapStyleOptions، بما في ذلك، على سبيل المثال، تنسيق JSON غير قابل للتحليل أو نوع الميزة غير المعروفة أو نوع العنصر الذي لم يتم التعرّف عليه أو مفاتيح المصمم غير الصالحة. وإذا كانت القيمة المعروضة هي false، يتم ترك النمط الحالي بدون تغيير.

إبطال عام setMapType (int type)

تعيين نوع مربعات الخرائط التي يجب عرضها. القيم المسموح بها هي:

MAP_TYPE_NORMAL: الخريطة الأساسية
MAP_TYPE_SATELLITE: صور القمر الصناعي
MAP_TYPE_HYBRID: صور القمر الصناعي مع الطرق والتصنيفات
MAP_TYPE_TERRAIN: البيانات الطبوغرافية
MAP_TYPE_NONE: ما مِن مربّعات خرائط أساسية.

المَعلمات

كتابة	نوع الخريطة المراد عرضها.

إلغاء علني setMaxZoomPreference (float maxZoomPreferences)

لضبط الحد الأعلى المفضّل لتكبير/تصغير الكاميرا.

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

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

المَعلمات

maxZoomPreference	الحد الأعلى المفضل.

إلغاء عام setMinZoomPreference (float minZoomPreferences)

لضبط الحد الأدنى المفضّل لتكبير/تصغير الكاميرا.

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

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

المَعلمات

minZoomPreference	الحد الأدنى المفضل.

إلغاء عام setMyLocationEnabled (boolean enabled)

لتفعيل طبقة موقعي أو إيقافها.

عندما يكون الموقع الجغرافي مفعلاً ومتاحًا، ترسم طبقة موقعي باستمرار إشارة إلى الموقع الحالي للمستخدم واتجاهه، كما تعرض عناصر التحكم في واجهة المستخدم التي تتيح للمستخدم التفاعل مع موقعه (على سبيل المثال، لتفعيل أو إيقاف تتبُّع الكاميرا للموقع الجغرافي واتجاهه).

لاستخدام ميزة موقعي الجغرافي وطبقة الموقع، عليك طلب إذن إما في ACCESS_COARSE_LOCATION أو ACCESS_FINE_LOCATION ما لم يتم ضبط مصدر موقع جغرافي مخصّص.

في حال ضبط مصدر مخصّص للموقع الجغرافي من خلال setLocationSource(LocationSource)، لن تتأكد حزمة تطوير البرامج (SDK) الخاصة بـ "خرائط Google" لنظام التشغيل Android مما إذا كان قد تم منح الأذونات أعلاه أم لا. ومع ذلك، يجب التأكّد من أنّ المستخدم قد منحك جميع الأذونات المطلوبة لمصدر موقعك الجغرافي المخصّص.

المَعلمات

مفعّلة	`true` للتفعيل، و`false` للإيقاف.

الرميات

SecurityException	إذا لم يتم منح إذن تحديد الموقع الجغرافي

عامة فارغة setOnCameraChangeListener (GoogleMap.OnCameraChangeListener مستمع)

تم إيقاف هذه الطريقة نهائيًا.تم استبدال
بـ setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener) وsetOnCameraMoveListener(GoogleMap.OnCameraMoveListener) وsetOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) وsetOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

تعمل هذه السياسة على ضبط معاودة الاتصال التي يتم استدعاءها عند تغيير الكاميرا.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي تم استدعاءه عند تغيير الكاميرا. لإلغاء ضبط معاودة الاتصال، استخدِم `null`.

عامة فارغة setOnCameraIdleListener (GoogleMap.OnCameraIdleListener مستمع)

تعمل هذه السياسة على ضبط معاودة الاتصال التي يتم استدعاؤها عند انتهاء حركة الكاميرا.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال التي تم استدعاؤها. لإلغاء ضبط معاودة الاتصال، استخدِم `null`.

عامة باطلة setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاءها عند إيقاف حركة الكاميرا أو مقاطعتها بسبب نوع جديد من الصور المتحركة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال التي تم استدعاؤها. لإلغاء ضبط معاودة الاتصال، استخدِم `null`. يُرجى عدم تحديث الكاميرا أو تحريكها من داخل `onCameraMoveCanceled()`.

خطأ علني setOnCameraMoveListener (GoogleMap.OnCameraMoveListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها بشكل متكرر عندما تكون الكاميرا تتحرك. ويمكن استدعاء معاودة الاتصال عدة مرات في كل إطار، وبالتالي يجب عدم إجراء عمليات مكلفة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال التي تم استدعاؤها. لإلغاء ضبط معاودة الاتصال، استخدِم `null`.

إلغاء عام setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener المستمع)

تضبط هذه السياسة معاودة الاتصال التي يتم استدعاءها عند بدء حركة الكاميرا أو تغيّر سبب حركة الكاميرا.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال التي تم استدعاؤها. لإلغاء ضبط معاودة الاتصال، استخدِم `null`. يُرجى عدم تحديث الكاميرا أو تحريكها من داخل `onCameraMoveStarted()`.

إبطال عام setOnCircleClickListener (GoogleMap.OnCircleClickListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على دائرة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال التي يتم استدعاؤها عند النقر على دائرة. لإلغاء ضبط معاودة الاتصال، استخدِم `null`.

public void setOnGroundOverlayClickListener (GoogleMap.OnGroundOverlayClickListener مستمع)

تحدِّد معاودة الاتصال التي يتم استدعاؤها عند النقر على تركيب أرضي.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال التي يتم استدعاؤها عند النقر على تراكب أرضي. لإلغاء ضبط عملية معاودة الاتصال، استخدِم `null`.

public void setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener المستمع)

تعمل هذه السياسة على ضبط المستمِع أو محوه للأحداث الداخلية. يمكن ضبط مستمِع واحد فقط. سيؤدي ضبط مستمِع جديد إلى إزالة المستمع السابق.

المَعلمات

أداة معالجة الحدث	المستمع في الأحداث الداخلية إذا لم يكن صفرًا؛ وإلا، سيتم محو المستمع

إبطال عام setOnInfoWindowClickListener (GoogleMap.OnInfoWindowClickListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على نافذة معلومات العلامة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال التي يتم استدعاؤها عند النقر على نافذة معلومات العلامة. لإلغاء ضبط عملية معاودة الاتصال، استخدِم `null`.

إبطال عام setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند إغلاق نافذة معلومات العلامة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي تم استدعاءه عند إغلاق نافذة معلومات العلامة. لإلغاء ضبط عملية معاودة الاتصال، استخدِم `null`.

إبطال عام setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند الضغط لفترة طويلة على نافذة معلومات العلامة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال التي يتم استدعاؤها عند الضغط لفترة طويلة على نافذة معلومات العلامة. ولإلغاء ضبط طلب معاودة الاتصال، استخدِم `null`.

public void setOnMapClickListener (GoogleMap.OnMapClickListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على الخريطة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي يتم استدعاؤه عند النقر على الخريطة. لإلغاء ضبط معاودة الاتصال، استخدِم `null`.

إلغاء عام setOnMapLoadedCallback (GoogleMap.OnMapLoadedCallback معاودة الاتصال)

تحدِّد هذه السياسة معاودة الاتصال التي يتم استدعاؤها عند الانتهاء من عرض هذه الخريطة. وسيتم استدعاء معاودة الاتصال مرة واحدة فقط.

إذا تم طلب هذه الطريقة عند عرض الخريطة بالكامل، سيتم استدعاء معاودة الاتصال على الفور. لن يتم تنشيط هذا الحدث إذا لم يتم تحميل الخريطة مطلقًا بسبب مشاكل في الاتصال أو إذا كانت الخريطة تتغير باستمرار ولم يكتمل التحميل مطلقًا بسبب تفاعل المستخدم باستمرار مع الخريطة.

المَعلمات

رد الاتصال	تم تفعيل معاودة الاتصال عند الانتهاء من عرض الخريطة. لإلغاء ضبط عملية معاودة الاتصال، استخدِم `null`.

public void setOnMapLongClickListener (GoogleMap.OnMapLongClickListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند الضغط لفترة طويلة على الخريطة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي يتم استدعاؤه عند الضغط لفترة طويلة على الخريطة. لإلغاء ضبط عملية معاودة الاتصال، استخدِم `null`.

إبطال عام setOnMarkerClickListener (GoogleMap.OnMarkerClickListener المستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على علامة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي يتم استدعاؤه عند النقر على علامة. لإلغاء ضبط معاودة الاتصال، استخدِم `null`.

إبطال عام setOnMarkerDragListener (GoogleMap.OnMarkerDragListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند سحب علامة.

المَعلمات

أداة معالجة الحدث	رد الاتصال الذي تم استدعاؤه في أحداث سحب العلامة. لإلغاء ضبط معاودة الاتصال، استخدِم `null`.

إبطال عام setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على زر موقعي.

وإذا عرضت السمة listener القيمة true، سيتم استهلاك الحدث ولن يحدث السلوك التلقائي. وإذا عرضت الكاميرا false، سيتم تطبيق السلوك التلقائي (أي تحرك الكاميرا بحيث تكون في مركز المستخدم على الموقع الجغرافي).

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي تم استدعاءه عند النقر على زر "موقعي".

إبطال عام setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند تغيير نقطة "موقعي" الجغرافي.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي تم استدعاءه عند تغيير نقطة "موقعي".

إبطال عام setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener مستمع)

تعمل على ضبط معاودة الاتصال التي يتم استدعاءها عند النقر على نقطة "موقعي الجغرافي" (التي تدل على الموقع الجغرافي للمستخدم).

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي يتم استدعاءه عند النقر على نقطة "موقعي".

إلغاء عام setOnPoiClickListener (GoogleMap.OnPoiClickListener مستمع)

لضبط أداة معالجة يتم تشغيلها عند النقر على نقطة اهتمام أو النقر عليها.

اضغط على null لمحو تطبيق المستمع.

المَعلمات

أداة معالجة الحدث

إبطال عام setOnPolygonClickListener (GoogleMap.OnPolygonClickListener مستمع)

لتعيين معاودة الاتصال التي يتم استدعاؤها عند النقر على مضلّع.

المَعلمات

أداة معالجة الحدث	رد الاتصال الذي يتم استدعاؤه عند النقر على مضلّع. لإلغاء ضبط معاودة الاتصال، استخدِم `null`.

إبطال عام setOnPolylineClickListener (GoogleMap.OnPolylineClickListener مستمع)

تحدِّد هذه الدالة معاودة الاتصال التي يتم استدعاؤها عند النقر على خطوط متعدّدة.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي يتم استدعاؤه عند النقر على خط متعدد. لإلغاء ضبط معاودة الاتصال، استخدِم `null`.

إلغاء عام setPadding (int left, int top, int right, int below)

لضبط المساحة المتروكة على الخريطة.

تسمح لك هذه الطريقة بتحديد منطقة مرئية على الخريطة لإرسال إشارة إلى الخريطة بأنّه قد يتم إخفاء أجزاء من الخريطة حول الحواف من خلال ضبط مساحة متروكة على كل حواف من الخريطة الأربع. سيتم تكييف دوال الخريطة مع المساحة المتروكة. على سبيل المثال، سيتم نقل عناصر التحكم في التكبير أو التصغير والبوصلة وإشعارات حقوق الطبع والنشر وشعار Google لتلائم المنطقة المحددة، وستكون حركات الكاميرا بالنسبة إلى وسط المنطقة المرئية، وما إلى ذلك.

المَعلمات

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

خطأ عام setTrafficEnabled (boolean enabled)

تفعيل طبقة حركة المرور أو إيقافها.

المَعلمات

مفعّلة

إلغاء علني لقطة (GoogleMap.SnapshotReadyCallback)

أخذ لقطة للخريطة.

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

ملاحظة: يجب عدم إرسال صور الخريطة إلى خوادمك أو استخدامها خارج التطبيق. إذا كنت بحاجة إلى إرسال خريطة إلى تطبيق آخر أو مستخدم آخر، أرسِل البيانات التي تتيح له إعادة إنشاء الخريطة للمستخدم الجديد بدلاً من أخذ لقطة.

المَعلمات

رد الاتصال	تم استدعاء طريقة معاودة الاتصال عند التقاط اللقطة.

إلغاء علني لقطة (GoogleMap.SnapshotReadyCallback معاودة الاتصال، الصورة النقطية للصور النقطية)

أخذ لقطة للخريطة.

هذه الطريقة تعادل snapshot(SnapshotReadyCallback)، ولكنّها تتيح لك توفير Bitmap تم تخصيصه مسبقًا. إذا لم تتطابق الصورة النقطية مع الأبعاد الحالية للخريطة، سيتم تخصيص صورة نقطية أخرى تناسب أبعاد الخريطة.

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

المَعلمات

رد الاتصال	تم استدعاء طريقة معاودة الاتصال عند التقاط اللقطة.
صورة نقطية	صورة نقطية تم تخصيصها مسبقًا إذا كان `null`، يتصرف مثل `snapshot(SnapshotReadyCallback)`.

فراغ علني stopAnimation ()

يوقف الصورة المتحركة للكاميرا إذا كانت هناك واحدة قيد التقدم. عند استدعاء الطريقة، تتوقف الكاميرا عن التحرك فورًا وتظل في ذلك الموضع.