خيارات GoogleMaps

الفئة النهائية العامة GoogleMapOptions توسّع الكائن
تنفّذ Parcelable

تُحدِّد هذه السياسة ضبط GoogleMapOptions لـ GoogleMap. ويمكن استخدام هذه الخيارات عند إضافة خريطة إلى تطبيقك بشكل آلي (بدلاً من استخدامها عبر XML). وإذا كنت تستخدم MapFragment، يمكنك ضبط هذه الخيارات باستخدام طريقة المصنع الثابتة newInstance(GoogleMapOptions). إذا كنت تستخدم MapView، يمكنك ضبط هذه الخيارات باستخدام الدالة الإنشائية MapView(Context, GoogleMapOptions).

إذا أضفت خريطة باستخدام XML، يمكنك تطبيق هذه الخيارات باستخدام علامات XML مخصّصة.

ملخّص ثابت مكتسَب

ملخّص عام للمنشئ

GoogleMapOptions()
تنشئ كائن GoogleMapOptions جديدًا.

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

GoogleMapOptions
ambientEnabled(تفعيل منطقي)
تحدّد هذه السياسة ما إذا كان يجب تفعيل نمط "وضع الإضاءة السينمائية".
GoogleMapOptions
الكاميرا(كاميرا CameraPosition)
تحدِّد هذه السياسة موضع الكاميرا الأوّلي للخريطة.
GoogleMapOptions
compassEnabled(تفعيل منطقي)
تحدِّد هذه السياسة ما إذا كان يجب تفعيل البوصلة.
ثابت GoogleMapOptions
createFromAttributes(سياق السياق، AttributeSet attrs)
تنشئ Google MapsOptions من AttributeSet.
منطقي
CameraPosition
منطقي
LatLngBounds
منطقي
منطقي
int
عدد عائم
عدد عائم
منطقي
منطقي
منطقي
منطقي
منطقي
منطقي
منطقي
منطقي
GoogleMapOptions
latLngBoundsForCameraTarget(LatLngBounds llbounds)
وتحدِّد هذه العلامة خط الطول والعرض لتقييد هدف الكاميرا، وبالتالي عندما يقوم المستخدمون بالتمرير وتحريك الخريطة، لا يتحرك هدف الكاميرا خارج هذه الحدود.
GoogleMapOptions
liteMode(تفعيل منطقي)
تحدِّد هذه السياسة ما إذا كان يجب إنشاء الخريطة في الوضع البسيط.
GoogleMapOptions
mapId(معرّف خريطة السلسلة)
لتحديد معرّف الخريطة.
GoogleMapOptions
mapToolbarEnabled(تفعيل منطقي)
تحدِّد هذه السياسة ما إذا كان يجب تفعيل شريط أدوات الخريطة أم لا.
GoogleMapOptions
mapType(int mapType)
تحدد هذه السمة تغييرًا على نوع الخريطة الأولي.
GoogleMapOptions
maxZoomPreference(float maxZoomPreferences)
تحدِّد هذه السياسة الحد الأقصى المفضّل لتكبير/تصغير الكاميرا.
GoogleMapOptions
minZoomPreference(float minZoomPreferences)
تحدِّد هذه السياسة الحد الأدنى المفضّل لتكبير/تصغير الكاميرا.
GoogleMapOptions
rotateGesturesEnabled(تفعيل منطقي)
تحدِّد هذه السياسة ما إذا كان يجب تفعيل إيماءات التدوير أم لا.
GoogleMapOptions
scrollGesturesEnabled(تفعيل منطقي)
تحدِّد هذه السياسة ما إذا كان يجب تفعيل إيماءات التمرير.
GoogleMapOptions
scrollGesturesEnabledDuringRotateOrZoom(تم تفعيل القيمة المنطقية)
تحدِّد هذه السياسة ما إذا كان يجب تفعيل إيماءات التمرير أثناء إيماءات التدوير والتكبير/التصغير.
GoogleMapOptions
setInstrumentClusterMap(منطقي isinstrumentCluster)
GoogleMapOptions
tiltGesturesEnabled(تفعيل منطقي)
تحدِّد هذه السياسة ما إذا كان يجب تفعيل إيماءات الإمالة.
سلسلة
GoogleMapOptions
useViewLifecycleInFragment(منطقي useViewLifecycleInFragment)
عند استخدام العلامة MapFragment، تحدّد هذه العلامة ما إذا كان يجب ربط دورة حياة الخريطة بعرض الجزء أو الجزء نفسه.
GoogleMapOptions
zOrderOnTop(منطقية zOrderOnTop)
يمكنك التحكم في ما إذا كان سيتم وضع سطح عرض الخريطة أعلى نافذته.
GoogleMapOptions
zoomControlsEnabled(تفعيل منطقي)
تحدِّد هذه السياسة ما إذا كان يجب تفعيل عناصر التحكّم في التكبير أو التصغير.
GoogleMapOptions
zoomGesturesEnabled(تفعيل منطقي)
تحدِّد هذه السياسة ما إذا كان يجب تفعيل إيماءات التكبير/التصغير.

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

مقاولات عامة

عامة GoogleMapOptions ()

تنشئ كائن GoogleMapOptions جديدًا.

الطرق العامة

عامة GoogleMapOptions ambientEnabled (boolean enabled)

تحدّد هذه السياسة ما إذا كان يجب تفعيل نمط "وضع الإضاءة السينمائية". ستكون القيمة التلقائية false. عند تفعيل هذه الميزة، يمكن عرض الخرائط ذات التصميم المحيط عندما يدخل جهاز Ambiactive في وضع الصوت المحيط.

المَعلمات
مفعّلة

عامة GoogleMapOptions الكاميرا (CameraPosition)

تحدِّد هذه السياسة موضع الكاميرا الأوّلي للخريطة.

المَعلمات
كاميرا

عامة GoogleMapOptions compassEnabled (boolean enabled)

تحدِّد هذه السياسة ما إذا كان يجب تفعيل البوصلة. لمزيد من التفاصيل، يُرجى الانتقال إلى setCompassEnabled(boolean). القيمة التلقائية هي true.

المَعلمات
مفعّلة

عامة ثابتة GoogleMapOptions createFromAttributes (سياق السياق، AttributeSet attrs)

تنشئ Google MapsOptions من AttributeSet.

المَعلمات
سياق
attrs

public Boolean getAmbientEnabled ()

المرتجعات
  • خيار ambiEnabled أو null إذا لم يتم تحديده.

public CameraPosition getCamera ()

المرتجعات
  • خيار الكاميرا، أو قيمة فارغة في حال عدم تحديدها.

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

المرتجعات
  • الخيار compassEnabled أو قيمة فارغة إذا لم يتم تحديدها.

متاح للجميع LatLngBounds getLatLngBoundsForCameraTarget ()

المرتجعات
  • لـ LatLngBounds المستخدم لتقييد هدف الكاميرا، أو قيمة فارغة في حال عدم التحديد.

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

المرتجعات
  • أو الخيار liteMode ، أو قيمة فارغة في حال عدم تحديدها.

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

المرتجعات
  • خيار mapToolbarEnabled أو قيمة فارغة إذا لم يتم تحديدها.

public int getMapType ()

المرتجعات
  • خيار mapType أو -1 إذا لم يتم تحديده.

public Float getMaxZoomPreference ()

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

public Float getMinZoomPreference ()

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

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

المرتجعات
  • الخيار rotateActivitysEnabled، أو قيمة خالية في حالة عدم التحديد.

public Boolean getScrollGesturesEnabled ()

المرتجعات
  • خيار ScrollAnimationsEnabled أو قيمة فارغة في حال عدم تحديدها.

public Boolean getScrollGesturesEnabledDuringRotateOrZoom ()

المرتجعات
  • الخيار ScrollAnimationsEnabledDringSessionOrZoom أو قيمة فارغة في حال عدم تحديدها.

public Boolean getTiltGesturesEnabled ()

المرتجعات
  • الخيار إمالة الإيماءاتEnabled أو قيمة فارغة في حال عدم التحديد.

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

المرتجعات
  • الخيار useViewLifecycleInFragment، أو قيمة فارغة إذا لم يتم تحديدها.

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

المرتجعات
  • خيار zOrderOnTop أو قيمة فارغة إذا لم يتم تحديدها.

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

المرتجعات
  • الخيار ZoomControlsEnabled، أو قيمة فارغة في حال عدم تحديدها.

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

المرتجعات
  • خيار ZoomOptionsEnabled أو القيمة فارغة في حال عدم تحديدها.

عامة GoogleMapOptions latLngBoundsForCameraTarget (LatLngBounds llbounds)

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

ولمزيد من التفاصيل، يمكنك الاطّلاع على setLatLngBoundsForCameraTarget(LatLngBounds).

المَعلمات
إلبوند

عامة GoogleMapOptions liteMode (boolean enabled)

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

المَعلمات
مفعّلة

خيار متاح للجميع GoogleMapOptions mapId (معرّف خريطة السلسلة)

لتحديد معرّف الخريطة.

المَعلمات
mapId

عامة GoogleMapOptions mapToolbarEnabled (boolean enabled)

تحدِّد هذه السياسة ما إذا كان يجب تفعيل شريط أدوات الخريطة أم لا. لمزيد من التفاصيل، يُرجى الانتقال إلى setMapToolbarEnabled(boolean). القيمة التلقائية هي true.

المَعلمات
مفعّلة

عامة GoogleMapOptions mapType (int mapType)

تحدد هذه السمة تغييرًا على نوع الخريطة الأولي.

المَعلمات
mapType

عامة GoogleMapOptions maxZoomPreference (float maxZoomPreferences)

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

ولمزيد من التفاصيل، يمكنك الاطّلاع على setMaxZoomPreference(float).

المَعلمات
maxZoomPreference

خيار متاح للجميع GoogleMapOptions minZoomPreference (float minZoomPreferences)

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

ولمزيد من التفاصيل، يمكنك الاطّلاع على setMinZoomPreference(float).

المَعلمات
minZoomPreference

عامة GoogleMapOptions rotateGesturesEnabled (boolean enabled)

تحدِّد هذه السياسة ما إذا كان يجب تفعيل إيماءات التدوير أم لا. لمزيد من التفاصيل، يُرجى الانتقال إلى setRotateGesturesEnabled(boolean). القيمة التلقائية هي true.

المَعلمات
مفعّلة

عامة GoogleMapOptions scrollGesturesEnabled (boolean enabled)

تحدِّد هذه السياسة ما إذا كان يجب تفعيل إيماءات التمرير. لمزيد من التفاصيل، يُرجى الانتقال إلى setScrollGesturesEnabled(boolean). القيمة التلقائية هي true.

المَعلمات
مفعّلة

متاحة للجميع GoogleMapOptions scrollGesturesEnabledDuringRotateOrZoom (boolean enabled)

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

المَعلمات
مفعّلة

public GoogleMapOptions setInstrumentClusterMap (boolean isInstrumentCluster)

المَعلمات
isInstrumentCluster

عامة GoogleMapOptions tiltGesturesEnabled (boolean enabled)

تحدِّد هذه السياسة ما إذا كان يجب تفعيل إيماءات الإمالة. لمزيد من التفاصيل، يُرجى الانتقال إلى setTiltGesturesEnabled(boolean). القيمة التلقائية هي true.

المَعلمات
مفعّلة

public سلسلة toString ()

عامة GoogleMapOptions useViewLifecycleInFragment (boolean useViewLifecycleInFragment)

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

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

عند استخدام مراحل نشاط عرض الجزء، لا تتم إعادة استخدام الخريطة عند فصل الجزء وإعادة تركيبه. سيؤدي هذا إلى إعادة عرض الخريطة من نقطة الصفر، الأمر الذي قد يستغرق بضع ثوانٍ. ويعني ذلك أيضًا أنّه على الرغم من فصل الجزء المحدَّد بدون عرض، وبالتالي فإن جميع طُرق GoogleMap ستعرض NullPointerException.

المَعلمات
useViewLifecycleInFragment

عامة GoogleMapOptions zOrderOnTop (boolean zOrderOnTop)

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

المَعلمات
zOrderOnTop

عامة GoogleMapOptions zoomControlsEnabled (boolean enabled)

تحدِّد هذه السياسة ما إذا كان يجب تفعيل عناصر التحكّم في التكبير أو التصغير. لمزيد من التفاصيل، يُرجى الانتقال إلى setZoomControlsEnabled(boolean). القيمة التلقائية هي true.

المَعلمات
مفعّلة

عامة GoogleMapOptions zoomGesturesEnabled (boolean enabled)

تحدِّد هذه السياسة ما إذا كان يجب تفعيل إيماءات التكبير/التصغير. لمزيد من التفاصيل، يُرجى الانتقال إلى setZoomGesturesEnabled(boolean). القيمة التلقائية هي true.

المَعلمات
مفعّلة