خريطة Google

الفئة النهائية العامة GoogleMaps تعمل على توسيع الكائن

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

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

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

دليل مطوّري البرامج

وللبدء، يمكنك الاطّلاع على دليل مطوّري برامج "خرائط Google" SDK لأجهزة Android.

ملخّص الصفوف المتداخلة

محسّنة GoogleMaps.CancelableCallback واجهة معاودة الاتصال لإعداد التقارير عند اكتمال مهمة أو إلغاؤها. 
محسّنة GoogleMaps.InfoWindowAdaptiveer يوفّر هذا الخيار عروضًا مخصّصة لنوافذ المعلومات. 
محسّنة GoogleMaps.OnCameraChangeListener تم إيقاف هذه الواجهة. تم استبدال GoogleMap.OnCameraMoveStartedListener وGoogleMap.OnCameraMoveListener وGoogleMap.OnCameraIdleListener. وتجدر الإشارة إلى أن الترتيب الذي سيتم به استدعاء طريقة onCameraChange التي تم إيقافها نهائيًا بناءً على الطرق في أداة تغيير الكاميرا الجديدة لم يتم تعريفه.  
محسّنة GoogleMaps.OnCameraIdleListener واجهة معاودة الاتصال عندما تنتهي حركة الكاميرا. 
محسّنة GoogleMaps.OnCameramovecancelListener واجهة معاودة الاتصال عندما يتم إيقاف حركة الكاميرا أو عندما تبدأ الكاميرا في الحركة لسبب جديد. 
محسّنة GoogleMaps.OnCameramoveListener واجهة معاودة الاتصال عندما تغير الكاميرا موضعها. 
محسّنة GoogleMaps.OnCameramoveStartedListener واجهة معاودة الاتصال عندما تبدأ حركة الكاميرا. 
محسّنة GoogleMaps.OnCircleClickListener واجهة معاودة الاتصال عندما يتم النقر على دائرة. 
محسّنة GoogleMaps.OnGroundتراكبClickListener واجهة معاودة الاتصال عندما يتم النقر على تراكب الأرض. 
محسّنة GoogleMaps.OnIndoorStateChangeListener سيتم الاستماع عندما تتغير الحالة الداخلية. 
محسّنة GoogleMaps.OnInfoWindowClickListener واجهة معاودة الاتصال لأحداث النقر/النقر على نافذة معلومات محدّد الموقع. 
محسّنة GoogleMaps.OnInfoWindowCloseListener واجهة معاودة الاتصال للأحداث القريبة في نافذة معلومات محدّد الموقع. 
محسّنة GoogleMaps.OnInfoWindowlongClickListener واجهة معاودة الاتصال عندما يضغط المستخدم مع الاستمرار على نافذة معلومات أداة التحديد. 
محسّنة GoogleMaps.On MapClickListener واجهة معاودة الاتصال عندما ينقر المستخدم على الخريطة. 
محسّنة GoogleMaps.OnMapLoadedCallback واجهة معاودة الاتصال عندما تنتهي من عرض الخريطة. 
محسّنة Googleخريطة.OnmaplongClickListener واجهة معاودة الاتصال عندما يضغط المستخدم مع الاستمرار على الخريطة. 
محسّنة Googleخريطة.OnMarkerClickListener لتعريف التوقيعات للطرق التي يتم طلبها عند النقر على العلامة أو النقر عليها. 
محسّنة Googleخريطة.OnMarkerسحبListener واجهة معاودة الاتصال لأحداث سحب العلامات. 
محسّنة GoogleMaps.OnMyLocationButtonClickListener واجهة معاودة الاتصال عندما يتم النقر على الزر "موقعي الجغرافي".
محسّنة GoogleMaps.OnMyLocationChangeListener تم إيقاف هذه الواجهة. استخدم com.google.android.gms.location.FusedLocationProviderApi بدلاً من ذلك. توفّر FuseLocationProviderApi طريقة محسّنة للبحث عن المواقع الجغرافية واستخدام الطاقة، وتستخدِمه النقطة الزرقاء والنقطة الجغرافية. راجِع البرنامج التعليمي "تحديد المكان الحالي" الذي يستخدم FuseLocationProviderApi أو دليل مطوّري البرامج للموقع الجغرافي.  
محسّنة GoogleMaps.OnMyLocationClickListener واجهة معاودة الاتصال عندما يتم النقر على نقطة الموقع الجغرافي (التي تشير إلى موقع المستخدم الجغرافي).
محسّنة GoogleMaps.OnPoiClickListener مستمع يكتفي بالنقر على نقطة اهتمام
محسّنة GoogleMaps.OnPolygonClickListener واجهة معاودة الاتصال عندما يتم النقر على المضلع. 
محسّنة GoogleMaps.OnPolylineClickListener واجهة معاودة الاتصال عندما يتم النقر على خط متعدد. 
محسّنة Googleخريطة.SnapshotReadyCallback واجهة معاودة الاتصال للإشعار عند التقاط اللقطة. 

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

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

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

دائرة
addCircle(خيارات CircleOptions)
إضافة دائرة إلى هذه الخريطة.
التراكب على الأرض
addGroundتراكب(خيارات GroundتراكبOptions)
لإضافة صورة إلى هذه الخريطة.
محدِّد الموقع
addMarker(خيارات MarkerOptions)
إضافة محدّد موقع إلى هذه الخريطة.
المضلع
addPolygon(خيارات PolygonOptions)
لإضافة مضلع إلى هذه الخريطة.
بوليبولين
addPolyline(خيارات PolylineOptions)
إضافة خط متعدد إلى هذه الخريطة.
تراكب
addTileتراكب (خيارات Tile تظهر الخيارات)
يضيف تراكب الأجزاء إلى هذه الخريطة.
باطلة
animateCamera(تحديث CameraUpdate)
تنقل حركة الكاميرا من الموضع الحالي إلى الموضع المحدد في التحديث.
باطلة
animateCamera(تحديث كاميراUpdate واستدعاء GoogleMaps.CancelableCallback)
تنقل حركة الكاميرا من الموضع الحالي إلى الموضع المحدد في التحديث وتطلب معاودة اتصال اختيارية عند الاكتمال.
باطلة
animateCamera(تحديث CameraUpdate، والمدة int periods، وGoogleMaps.CancelableCallback)
تحريك الخريطة وفقًا للتحديث باستخدام صورة متحركة خلال مدة محدّدة، واستدعاء معاودة اتصال اختيارية عند الاكتمال
باطلة
محو()
إزالة جميع العلامات والخطوط المتعددة والمضلعات والتراكبات وما إلى ذلك من الخريطة.
موضع الكاميرا
getCameraPosition()
يحصل على الوضع الحالي للكاميرا.
مبنى داخلي
getالتركيزedBuilding()
الحصول على المبنى الذي يتم التركيز عليه حاليًا
int
getmapType()
تحصل على نوع الخريطة التي يتم عرضها حاليًا.
عدد عائم
getMaxZoomLevel()
عرض الحد الأقصى لمستوى التكبير/التصغير لموضع الكاميرا الحالي.
عدد عائم
getMinZoomLevel()
عرض الحد الأدنى لمستوى التكبير/التصغير.
الموقع
getMyLocation()
تم إيقاف هذه الطريقة. وبدلاً من ذلك، استخدِم com.google.android.gms.location.FusedLocationProviderApi. توفّر FuseLocationProviderApi طريقة محسّنة للبحث عن المواقع الجغرافية واستخدام الطاقة، وتستخدِمه النقطة الزرقاء والنقطة الجغرافية. اطّلِع على MyLocationDemoActivity في نموذج المجلد "التطبيقات" للحصول على مثال للرمز أو دليل مطوّري برامج الموقع الجغرافي.
التوقع
getProjection()
لعرض عنصر Projection يمكنك استخدامه للتحويل بين إحداثيات الشاشة وإحداثيات خطوط الطول/العرض.
إعدادات Ui
getUiSettings()
الحصول على إعدادات واجهة المستخدم للخريطة.
منطقي
isBuildingsEnabled()
يعرض ما إذا تم تفعيل طبقة المباني الثلاثية الأبعاد.
منطقي
isIndoorEnabled()
يحدّد ما إذا كانت الخرائط الداخلية مفعّلة حاليًا.
منطقي
isMyLocationEnabled()
يحصل على حالة طبقة موقعي الجغرافي.
منطقي
isحركةEnabled()
التحقق مما إذا كانت الخريطة ترسم بيانات حركة المرور.
باطلة
moveCamera(تحديث CameraUpdate)
تغيير موضع الكاميرا وفقًا للتعليمات المحدّدة في التحديث
باطلة
resetMinMaxMaxPreferences()
إزالة أي حد أقصى سابق وحد أدنى للتكبير أو التصغير.
باطلة
setBuildingsEnabled(منطقي مفعّل)
تفعيل طبقة المباني الثلاثية الأبعاد أو إيقافها
باطلة
setContentDescription(وصف السلسلة)
إعداد contentDescription للخريطة.
منطقي
setIndoorEnabled (تم تفعيل القيمة المنطقية)
لتحديد ما إذا كان يجب تفعيل الخرائط الداخلية أم لا.
باطلة
setInfoWindowAdaptiveer(محوّل GoogleMaps.InfoWindowAdaptiveer)
تضبط عارضًا مخصصًا لمحتويات نوافذ المعلومات.
باطلة
setLatLngBoundsForCameraTarget(LatLngBounds حدود
تحدِّد LatLngBounds لتقييد هدف الكاميرا، بحيث لا يتحرّك هدف الكاميرا خارج هذه الحدود عند انتقال المستخدمين إلى الخريطة وتحريكها.
باطلة
setLocationSource (المصدر LocationSource)
لاستبدال مصدر الموقع الجغرافي لطبقة موقعي الجغرافي.
منطقي
set MapStyle(نمط StyleStyleOptions)
لضبط نمط الخريطة الأساسية.
باطلة
setMapType(نوع int)
تعمل على ضبط نوع مربعات الخرائط التي يجب عرضها.
باطلة
setMaxZoomPreferences(الحدّ الأقصى ZoomZoomPreferences)
تضبط هذه السياسة الحدّ الأقصى المفضّل لتكبير/تصغير الكاميرا.
باطلة
setMinZoomPreferences(اختيار الحد الأدنى من ZoomZoom دقيقة)
تضبط هذه السياسة الحد الأدنى المفضّل لتكبير/تصغير الكاميرا.
باطلة
setMyLocationEnabled(تفعيل منطقي)
تفعيل طبقة موقعي الجغرافي أو إيقافها.
باطلة
setOnCameraChangeListener(مستمع GoogleMaps.OnCameraChangeListener)
تم إيقاف هذه الطريقة. تم الاستبدال بـ setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener) وsetOnCameraMoveListener(GoogleMap.OnCameraMoveListener) وsetOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) وsetOnCameraIdleListener(GoogleMap.OnCameraIdleListener).
باطلة
setOnCameraIdleListener(مستمع GoogleMaps.OnCameraIdleListener)
تضبط معاودة الاتصال التي يتم استدعاؤها عند انتهاء حركة الكاميرا.
باطلة
setOnCameramovecancelListener(GoogleMaps.OnCameramovecancelListener مستمع))
تحدد معاودة الاتصال التي يتم استدعاؤها عند إيقاف حركة الكاميرا أو مقاطعتها بواسطة نوع جديد من الصور المتحركة.
باطلة
setOnCameramoveListener(مستمع GoogleMaps.OnCameramoveListener)
تعمل على ضبط معاودة الاتصال التي يتم استدعاؤها بشكل متكرر أثناء تحريك الكاميرا.
باطلة
setOnCameramoveStartedListener(مستمع (GoogleMaps.OnCameramoveStartedListener)
تضبط استدعاءً يتم استدعاؤه عند بدء الكاميرا في الحركة أو تغيير سبب حركة الكاميرا.
باطلة
setOnCircleClickListener(مستمع GoogleGoogleOnOnClickListener)
تحدد استدعاءً يمكن استدعاءه عند النقر على دائرة.
باطلة
setOnGroundتراكبClickListener(GoogleMaps.OnGroundتراكبClickListener المستمع
تحدد استدعاءً يمكن استدعاءه عند النقر على تراكب أرضي.
باطلة
setOnIndoorStateChangeListener(GoogleMaps.OnIndoorStateChangeListener مستمع))
تضبط المستمع أو يمحوه للأحداث الداخلية.
باطلة
setOnInfoWindowClickListener(مستمع (GoogleMaps.OnInfoWindowClickListener)
تضبط استدعاءً يمكن استدعاؤه عند النقر على نافذة معلومات محدّد الموقع.
باطلة
setOnInfoWindowCloseListener(مستمع (GoogleMaps.OnInfoWindowCloseListener)
ضبط معاودة الاتصال التي تم استدعاءها عند إغلاق نافذة معلومات محدّد الموقع.
باطلة
setOnInfoWindowlongClickListener(مستمع GoogleGoogleOnOnWinWindowlongListener)
لضبط استدعاء يتم استدعاءه عند الضغط مع الاستمرار على نافذة معلومات محدّد الموقع.
باطلة
setOn MapClickListener(مستمع GoogleMaps.OnMapClickListener)
تضبط معاودة الاتصال التي تم استدعاءها عند النقر على الخريطة.
باطلة
setOn MapLoadedCallback(طلب GoogleGoogleOnOnLoadLoadedCallback)
تتيح هذه السياسة ضبط معاودة اتصال تم استدعاءها عند الانتهاء من عرض هذه الخريطة.
باطلة
setOnmaplongClickListener(مستمع على GoogleMaps.On MaplongClickListener)
تحدد استدعاءً يمكن استدعاءه عند الضغط مع الاستمرار على الخريطة.
باطلة
setOnMarkerClickListener(أداة GoogleMaps.OnMarkerClickListener مستمع)
تحدد استدعاءً يمكن استدعاءه عند النقر على علامة.
باطلة
setOnMarkerسحبListener(GoogleMaps.OnMarkerسحبListener مستمع)
لضبط معاودة اتصال تم استدعاءها عند سحب إحدى العلامات.
باطلة
setOnMyLocationButtonClickListener(أداة خريطة Google.OnMyLocationButtonClickListener)
ضبط معاودة اتصال تم استدعاءها عند النقر على زر موقعي.
باطلة
setOnMyLocationChangeListener(المستمع على GoogleMaps.OnMyLocationChangeListener)
تم إيقاف هذه الطريقة. وبدلاً من ذلك، استخدِم com.google.android.gms.location.FusedLocationProviderApi. توفّر FuseLocationProviderApi طريقة محسّنة للبحث عن المواقع الجغرافية واستخدام الطاقة، وتستخدِمه النقطة الزرقاء والنقطة الجغرافية. اطّلِع على MyLocationDemoActivity في نموذج المجلد "التطبيقات" للحصول على مثال للرمز أو دليل مطوّري برامج الموقع الجغرافي.
باطلة
setOnMyLocationClickListener(المستمع على GoogleMaps.OnMyLocationClickListener)
لضبط استدعاء يتم استدعاءه عند النقر على نقطة موقعي (التي تشير إلى موقع المستخدم).
باطلة
setOnPoiClickListener(أداة دمج GoogleMaps.OnPoiClickListener)
يتم ضبط مستمع يتم تشغيله عند النقر على نقطة اهتمام أو النقر عليها.
باطلة
setOnPolygonClickListener(المستمع (GoogleMaps.OnPolygonClickListener)
لضبط استدعاء يتم استدعاءه&#39؛ عند النقر على المضلع.
باطلة
setOnPolylineClickListener(أداة خريطة GoogleGoogle.OnPolylineClickListener)
تحدد استدعاءً يمكن استدعاءه عند النقر على خط متعدد.
باطلة
setP جارٍ (الإدخال إلى اليسار أو int في الأعلى أو int لليمين أو int في الأسفل)
ضبط المساحة المتروكة على الخريطة
باطلة
settrafficEnabled (تم تفعيل القيمة المنطقية)
لتفعيل طبقة حركة المرور أو إيقافها
باطلة
snapshot(استدعاء GoogleMaps.SnapshotReadyCallback)
التقط لقطة شاشة للخريطة.
باطلة
snapshot(_خريطة Google SnapshotReadyCallback، صورة نقطية على Bitmap)
التقط لقطة شاشة للخريطة.
باطلة
stopAnimation()
لإيقاف الصورة المتحركة في الكاميرا إذا كان هناك واحد قيد التقدم.

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

الثوابت

علنية ثابتة نهائية int MAP_TYPE_HYBRID

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

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

Public static Final int MAP_TYPE_NONE

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

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

Public Static Final int MAP_TYPE_NORMAL

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

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

Public Static Final int MAP_TYPE_SATELLITE

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

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

Public Static Final int MAP_TYPE_TERRAIN

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

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

الأساليب العامة

علني الدائرة إضافة الدائرة (خيارات الدائرة)

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

المَعلمات
الخيارات عنصر خيارات الدائرة الذي يحدد كيفية عرض الدائرة
المرتجعات
  • العنصر Circle الذي تمت إضافته إلى الخريطة

علنية Groundتراكب addGroundتراكب (خيارات Groundتراكب)

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

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

Public Marker add Marker (خيارات Marker)

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

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

المَعلمات
الخيارات عنصر خيارات العلامة يحدّد كيفية عرض العلامة.
المرتجعات
  • Marker التي تمت إضافتها إلى الخريطة.

Public Polygon addPolygon (خيارات Poly)

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

المَعلمات
الخيارات كائن خيارات المضلّع الذي يحدّد كيفية عرض المضلّع.
المرتجعات
  • العنصر Polygon الذي تمت إضافته إلى الخريطة.

متاح للجميع Polyline addPolyline (خيارات Polylyline)

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

المَعلمات
الخيارات كائن خيارات خط متعدد يحدّد كيفية عرض خط متعدد.
المرتجعات
  • العنصر Polyline الذي تمت إضافته إلى الخريطة.

علنية Tileتراكب addTileتراكب (خيارات Teileتراكب)

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

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

المَعلمات
الخيارات عنصر خيارات تراكب الصور يحدد كيفية عرض التراكب. يجب تحديد TileProvider لخيارات، وإلا سيتم طرح IllegalArgumentException.
المرتجعات
  • TileOverlay التي تمت إضافتها إلى الخريطة.
طرح
استثناء غير قانوني إذا لم يتم تحديد TileProvider في الخيارات.

علني باطل كاميرا متحركة (تحديث UpdateCamera)

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

يُرجى الاطّلاع على CameraUpdateFactory للاطّلاع على مجموعة التعديلات.

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

علني باطل كاميرا متحركة (تحديث كاميرا، GoogleMaps.CancelableCallback)

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

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

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

علنية باطلة كاميرا متحركة (تحديث UpdateUpdate (الكاميرا)، int periodMs، GoogleMaps.CancelableCallback)

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

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

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

Public Empty محو ()

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

Public CameraPosition getCameraPosition ()

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

تمثّل السمة CameraPosition المعروضة نبذة عن الموضع الحالي، ولن يتم تعديلها تلقائيًا عند تحريك الكاميرا.

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

المرتجعات
  • الموضع الحالي للكاميرا.

Public IndoorBuilding getالتركيزedBuilding ()

الحصول على المبنى الذي يتم التركيز عليه حاليًا

المرتجعات
  • المبنى الحالي المُركّز أو null إذا لم يتم التركيز على أي مبنى

public int getMapType ()

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

المرتجعات
  • نوع الخريطة

Public العائم getMaxZoomLevel ()

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

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

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

Public العائم getMinZoomLevel ()

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

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

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

Public Location getMyLocation ()

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

عرض الموقع الجغرافي المعروض حاليًا للمستخدم، أو null في حال عدم توفّر بيانات الموقع الجغرافي

المرتجعات
طرح
استثناء غير قانوني في حالة عدم تفعيل طبقة موقعي الجغرافي.

Public Projection getProjection ()

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

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

المرتجعات
  • Projection للخريطة بحالتها الحالية.

علنية UiSettings getUiSettings ()

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

المرتجعات

Public boolean isBuildingsEnabled ()

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

المرتجعات
  • true إذا تم تفعيل المباني؛ false بخلاف ذلك.

Public boolean isIndoorEnabled ()

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

المرتجعات
  • true في حال تفعيل الخرائط الداخلية، false إذا تم إيقاف الخرائط الداخلية،

Public boolean isMyLocationEnabled ()

يحصل على حالة طبقة موقعي الجغرافي.

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

Public boolean istrafficEnabled ()

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

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

علني باطل moveCamera (تحديث UpdateCamera)

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

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

Public Empty resetMinMaxMaxPreferences ()

إزالة أي حد أقصى سابق وحد أدنى للتكبير أو التصغير.

علنية باطلة setBuildingsEnabled (منطقي مفعّل)

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

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

Public Empty setContentDescription (وصف السلسلة)

إعداد contentDescription للخريطة.

يُستخدم هذا الوصف لتقديم وصف شفهي للخريطة في وضع تسهيل الاستخدام. تكون القيمة التلقائية هي ";خريطة Google&&quot؛

المَعلمات
الوصف سلسلة لاستخدامها في الوصف.

Public boolean setIndoorEnabled (مفعَّل منطقي)

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

المَعلمات
تم التفعيل true لمحاولة تفعيل الخرائط الداخلية، false لإيقاف الخرائط الداخلية.
المرتجعات
  • ما إذا كان من الممكن تفعيل الخرائط الداخلية.

علنية باطلة setInfoWindowAdaptiveer (محوّل GoogleMaps.InfoWindowAdaptiveer)

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

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

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

Public Empty setLatLngBoundsForCameraTarget (حدود LatLngBounds)

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

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

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

المَعلمات
حدود تؤدي القيود إلى تقييد هدف الكاميرا ضمن.

عامة باطلة setLocationSource (LocationSource المصدر)

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

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

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

لضبط نمط الخريطة الأساسية.

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

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

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

Public Empty set MapType (int type)

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

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

Public Empty setMaxZoomPreferences (Fmax maxZoomPreferences)

تضبط هذه السياسة الحدّ الأقصى المفضّل لتكبير/تصغير الكاميرا.

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

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

المَعلمات
maxZoomPreferences الحد العلوي المفضَّل.

Public Empty setMinZoomPreferences (FminminZoomPreferences)

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

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

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

المَعلمات
MinZoomPreferences الحد الأدنى المفضَّل.

Public Empty setMyLocationEnabled (مفعَّل منطقي)

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

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

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

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

المَعلمات
تم التفعيل true لتفعيلها؛ false لإيقافها.
طرح
استثناء الأمان إذا لم يتم منح إذن تحديد الموقع الجغرافي.

Public Empty setOnCameraChangeListener (GoogleMaps.OnCameraChangeListener مستمع)

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

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

المَعلمات
أداة معالجة الحدث معاودة الاتصال التي تم استدعاءها عند تغيير الكاميرا. لإلغاء إعداد معاودة الاتصال، استخدم null.

علني باطل setOnCameraIdleListener (أداة GoogleMapsId.OnCameraIdleListener)

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

المَعلمات
أداة معالجة الحدث معاودة الاتصال التي تم استدعاءها's. لإلغاء إعداد معاودة الاتصال، استخدم null.

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

المَعلمات
أداة معالجة الحدث معاودة الاتصال التي تم استدعاءها's. لإلغاء إعداد معاودة الاتصال، استخدم null. يُرجى عدم تعديل الكاميرا أو تحريكها من داخل onCameraMoveCanceled().

علنية باطلة setOnCameramoveListener (مستمع على GoogleMaps.OnCameraMotionListener)

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

المَعلمات
أداة معالجة الحدث معاودة الاتصال التي تم استدعاءها's. لإلغاء إعداد معاودة الاتصال، استخدم null.

تضبط استدعاءً يتم استدعاؤه عند بدء الكاميرا في الحركة أو تغيير سبب حركة الكاميرا.

المَعلمات
أداة معالجة الحدث معاودة الاتصال التي تم استدعاءها's. لإلغاء إعداد معاودة الاتصال، استخدم null. يُرجى عدم تعديل الكاميرا أو تحريكها من داخل onCameraMoveStarted().

تحدد استدعاءً يمكن استدعاءه عند النقر على دائرة.

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

تحدد استدعاءً يمكن استدعاءه عند النقر على تراكب أرضي.

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

Public Empty setOnIndoorStateChangeListener (Googleخريطة.OnIndoorStateChangeListener)

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

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

Public Empty setOnInfoWindowClickListener (مستمع GoogleGoogle.OnInfoWindowClickListener)

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

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

Public Empty setOnInfoWindowCloseListener (أداة الاستماع إلى GoogleMaps.OnInfoWindowCloseListener)

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

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

لضبط استدعاء يتم استدعاءه عند الضغط مع الاستمرار على نافذة معلومات محدّد الموقع.

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

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

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

Public Empty setOn MapLoadedCallback (GoogleMaps.OnMapLoadedCallback))

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

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

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

تحدد استدعاءً يمكن استدعاءه عند الضغط مع الاستمرار على الخريطة.

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

Public Empty setOnMarkerClickListener (GoogleMaps.OnMarkerClickListener مستمع)

تحدد استدعاءً يمكن استدعاءه عند النقر على علامة.

المَعلمات
أداة معالجة الحدث معاودة الاتصال التي تم استدعاءها&#39؛ عند النقر على علامة. لإلغاء إعداد معاودة الاتصال، استخدِم null.

Public Empty setOnMarkerسحبListener (GoogleMaps.OnMarkerسحبListener مستمع)

لضبط معاودة اتصال تم استدعاءها عند سحب إحدى العلامات.

المَعلمات
أداة معالجة الحدث معاودة الاتصال التي تم استدعاءها's في أحداث سحب العلامة. لإلغاء إعداد معاودة الاتصال، استخدم null.

Public Empty setOnMyLocationButtonClickListener (GoogleMaps.OnMyLocationButtonClickListener مستمع)

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

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

المَعلمات
أداة معالجة الحدث معاودة الاتصال التي تم استدعاءها&#39؛ عند النقر على زر موقعي.

Public Empty setOnMyLocationChangeListener (GoogleMaps.OnMyLocationChangeListener مستمع)

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

لضبط استدعاء يتم استدعاءه&#39؛ عند تغيير نقطة موقعي الجغرافي.

المَعلمات
أداة معالجة الحدث معاودة الاتصال التي تم استدعاؤها&#39؛ عند تغيير نقطة موقعي.

Public Empty setOnMyLocationClickListener (GoogleMaps.OnMyLocationClickListener مستمع)

لضبط استدعاء يتم استدعاءه عند النقر على نقطة موقعي (التي تشير إلى موقع المستخدم).

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

Public Empty setOnPoiClickListener (GoogleMaps.OnPoiClickListener مستمع)

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

مرِّر null لمحو المستمع.

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

Public Empty setOnPolygonClickListener (أداة GoogleMaps.OnPolygonClickListener)

لضبط استدعاء يتم استدعاءه&#39؛ عند النقر على المضلع.

المَعلمات
أداة معالجة الحدث معاودة الاتصال التي تم استدعاءها&#39؛ عند النقر على المضلع. لإلغاء إعداد معاودة الاتصال، استخدِم null.

Public Empty setOnPolylineClickListener (GoogleMaps.OnPolylineClickListener مستمع)

تحدد استدعاءً يمكن استدعاءه عند النقر على خط متعدد.

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

public إمكانية باطلة setPaving (int left, int up, intright, int down)

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

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

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

Public Empty settrafficEnabled (منطقي مفعّل)

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

المَعلمات
تم التفعيل

Public Empty snapshot (Googleخريطة.SnapshotReadyCallback)

التقط لقطة شاشة للخريطة.

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

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

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

Public Empty snapshot (GoogleMaps.SnapshotReadyCallback، معاينة صورة نقطية على Bitmap)

التقط لقطة شاشة للخريطة.

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

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

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

Public Empty stopAnimation ()

لإيقاف الصورة المتحركة في الكاميرا إذا كان هناك واحد قيد التقدم. وعندما يتم طلب الطريقة، تتوقّف الكاميرا عن الحركة على الفور وتبقى في هذا الموضع.