طراحی نقشه جدید به زودی به پلتفرم نقشه های گوگل ارائه می شود. این به‌روزرسانی برای استایل نقشه شامل یک پالت رنگ پیش‌فرض جدید و بهبودهایی در تجربیات نقشه و قابلیت استفاده است. همه سبک‌های نقشه به‌طور خودکار در مارس 2025 به‌روزرسانی می‌شوند. برای اطلاعات بیشتر در مورد در دسترس بودن و نحوه انتخاب زودتر، به سبک نقشه جدید برای پلتفرم Google Maps مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

GoogleMapOptions

کلاس نهایی عمومی GoogleMapOptions Object را گسترش می دهد
Parcelable را پیاده سازی می کند

تنظیمات GoogleMapOptions را برای GoogleMap تعریف می کند. این گزینه ها را می توان هنگام افزودن نقشه به برنامه خود به صورت برنامه ریزی شده (برخلاف از طریق XML) استفاده کرد. اگر از MapFragment استفاده می کنید، می توانید این گزینه ها را با استفاده از روش کارخانه ایستا newInstance(GoogleMapOptions) ارسال کنید. اگر از MapView استفاده می کنید، می توانید این گزینه ها را با استفاده از سازنده MapView(Context, GoogleMapOptions) منتقل کنید.

اگر نقشه ای را با استفاده از XML اضافه می کنید، می توانید این گزینه ها را با استفاده از تگ های XML سفارشی اعمال کنید.

خلاصه ثابت ارثی

از رابط android.os.Parcelable

بین المللی	CONTENTS_FILE_DESCRIPTOR
بین المللی	PARCELABLE_WRITE_RETURN_VALUE

خلاصه سازنده عمومی

GoogleMapOptions ()

یک شیء GoogleMapOptions جدید ایجاد می کند.

خلاصه روش عمومی

GoogleMapOptions	ambientEnabled (بولی فعال) مشخص می کند که آیا استایل حالت محیطی باید فعال باشد یا خیر.
GoogleMapOptions	دوربین ( دوربین موقعیت دوربین) موقعیت اولیه دوربین را برای نقشه مشخص می کند.
GoogleMapOptions	compassEnabled (بولی فعال) مشخص می کند که آیا قطب نما باید فعال باشد یا خیر.
استاتیک GoogleMapOptions	createFromAttributes (متن زمینه، AttributeSet attrs) یک GoogleMapsOptions از `AttributeSet` ایجاد می کند.
بولی	getAmbientEnabled ()
موقعیت دوربین	دریافت دوربین ()
بولی	getCompassEnabled ()
LatLngBounds	getLatLngBoundsForCameraTarget ()
بولی	getLiteMode ()
بولی	getMapToolbarEnabled ()
بین المللی	getMapType ()
شناور	getMaxZoomPreference ()
شناور	getMinZoomPreference ()
بولی	getRotateGesturesEnabled ()
بولی	getScrollGesturesEnabled ()
بولی	getScrollGesturesEnabledDuringRotateOrZoom ()
بولی	getTiltGesturesEnabled ()
بولی	getUseViewLifecycleInFragment ()
بولی	getZOrderOnTop ()
بولی	getZoomControlsEnabled ()
بولی	getZoomGesturesEnabled ()
GoogleMapOptions	latLngBoundsForCameraTarget ( LtLngBounds llbounds) یک LatLngBounds را برای محدود کردن هدف دوربین مشخص می کند، به طوری که وقتی کاربران نقشه را اسکرول و حرکت می دهند، هدف دوربین خارج از این محدوده حرکت نکند.
GoogleMapOptions	liteMode (بولی فعال) مشخص می کند که آیا نقشه باید در حالت ساده ایجاد شود یا خیر.
GoogleMapOptions	mapId (رشته mapId) شناسه نقشه را مشخص می کند.
GoogleMapOptions	mapToolbarEnabled (بولی فعال) مشخص می کند که آیا mapToolbar باید فعال باشد یا خیر.
GoogleMapOptions	mapType (int mapType) تغییر در نوع نقشه اولیه را مشخص می کند.
GoogleMapOptions	maxZoomPreference (float maxZoomPreference) یک کران بالای ترجیحی برای بزرگنمایی دوربین مشخص می کند.
GoogleMapOptions	minZoomPreference (float minZoomPreference) یک کران پایین ترجیحی برای بزرگنمایی دوربین مشخص می کند.
GoogleMapOptions	rotateGesturesEnabled (بولی فعال) مشخص می کند که آیا حرکات چرخشی باید فعال شوند یا خیر.
GoogleMapOptions	scrollGesturesEnabled (بولی فعال) مشخص می کند که آیا حرکات اسکرول باید فعال شوند یا خیر.
GoogleMapOptions	scrollGesturesEnabledDuringRotateOrZoom (بولی فعال است) مشخص می کند که آیا حرکات اسکرول باید در حین حرکات چرخش و زوم فعال شوند یا خیر.
GoogleMapOptions	setInstrumentClusterMap (بولی isInstrumentCluster)
GoogleMapOptions	tiltGesturesEnabled (بولی فعال) مشخص می کند که آیا حرکات شیب باید فعال شوند یا خیر.
رشته	toString ()
GoogleMapOptions	useViewLifecycleInFragment (useViewLifecycleInFragment بولی) هنگام استفاده از `MapFragment` ، این پرچم مشخص می‌کند که چرخه حیات نقشه باید به نمای قطعه یا خود قطعه مرتبط باشد.
GoogleMapOptions	zOrderOnTop (بولی zOrderOnTop) کنترل کنید که سطح نمای نقشه در بالای پنجره قرار گیرد یا خیر.
GoogleMapOptions	zoomControlsEnabled (بولی فعال) مشخص می کند که آیا کنترل های بزرگنمایی باید فعال شوند یا خیر.
GoogleMapOptions	zoomGesturesEnabled (بولی فعال) مشخص می کند که آیا حرکات زوم باید فعال شوند یا خیر.

خلاصه روش ارثی

از کلاس java.lang.Object

بولی	برابر است (شیء arg0)
کلاس نهایی<?>	getClass ()
بین المللی	هش کد ()
باطل نهایی	اعلام کردن ()
باطل نهایی	اطلاع رسانی به همه ()
رشته	toString ()
باطل نهایی	صبر کنید (long arg0، int arg1)
باطل نهایی	صبر کنید (طولانی arg0)
باطل نهایی	صبر کن ()

از رابط android.os.Parcelable

انتزاعی	توصیف محتوا ()
خلأ انتزاعی	writeToParcel (Parcel arg0، int arg1)

سازندگان عمومی

GoogleMapOptions عمومی ()

یک شیء GoogleMapOptions جدید ایجاد می کند.

روش های عمومی

عمومی GoogleMapOptions ambientEnabled (بولی فعال)

مشخص می کند که آیا استایل حالت محیطی باید فعال باشد یا خیر. مقدار پیش فرض false است . وقتی یک دستگاه Ambiactive وارد حالت محیطی می‌شود، وقتی فعال باشد، نقشه‌های به سبک محیطی را می‌توان نمایش داد.

مولفه های

فعال شد

دوربین عمومی GoogleMapOptions (دوربین CameraPosition )

موقعیت اولیه دوربین را برای نقشه مشخص می کند.

مولفه های

دوربین

عمومی GoogleMapOptions compassEnabled (بولی فعال)

مشخص می کند که آیا قطب نما باید فعال باشد یا خیر. برای جزئیات بیشتر به setCompassEnabled(boolean) مراجعه کنید. مقدار پیش فرض true است .

مولفه های

فعال شد

عمومی استاتیک GoogleMapOptions createFromAttributes (زمینه متن، AttributeSet attrs)

یک GoogleMapsOptions از AttributeSet ایجاد می کند.

مولفه های

متن نوشته
attrs

عمومی Boolean getAmbientEnabled ()

برمی گرداند

گزینه ambientEnabled یا در صورت عدم مشخص بودن null.

عمومی CameraPosition getCamera ()

برمی گرداند

گزینه دوربین، یا اگر مشخص نشده باشد، null است.

عمومی بولی getCompassEnabled ()

برمی گرداند

گزینه compassEnabled یا اگر مشخص نشده باشد null است.

عمومی LatLngBounds getLatLngBoundsForCameraTarget ()

برمی گرداند

LatLngBounds برای محدود کردن هدف دوربین استفاده می شود، یا اگر مشخص نشده باشد، باطل می شود.

getLiteMode عمومی Boolean ()

برمی گرداند

گزینه liteMode یا اگر مشخص نشده باشد null است.

بولی عمومی getMapToolbarEnabled ()

برمی گرداند

گزینه mapToolbarEnabled یا اگر مشخص نشده باشد null.

عمومی int getMapType ()

برمی گرداند

گزینه mapType یا -1 اگر مشخص نشده باشد.

عمومی Float getMaxZoomPreference ()

برمی گرداند

حداکثر ترجیح سطح زوم، یا اگر مشخص نشده باشد، صفر است.

عمومی Float getMinZoomPreference ()

برمی گرداند

حداقل ترجیح سطح بزرگنمایی، یا اگر مشخص نشده باشد، صفر است.

عمومی بولی getRotateGesturesEnabled ()

برمی گرداند

گزینه rotateGesturesEnabled یا اگر مشخص نشده باشد null شود.

عمومی بولی getScrollGesturesEnabled ()

برمی گرداند

گزینه scrollGesturesEnabled یا اگر مشخص نشده باشد null شود.

بولین عمومی getScrollGesturesEnabledDuringRotateOrZoom ()

برمی گرداند

گزینه scrollGesturesEnabledDuringRotateOrZoom، یا اگر مشخص نشده باشد، خالی است.

عمومی بولی getTiltGesturesEnabled ()

برمی گرداند

گزینه tiltGesturesEnabled یا اگر مشخص نشده باشد null شود.

بولی عمومی getUseViewLifecycleInFragment ()

برمی گرداند

گزینه useViewLifecycleInFragment یا اگر مشخص نشده باشد null.

عمومی بولی getZOrderOnTop ()

برمی گرداند

گزینه zOrderOnTop یا اگر مشخص نشده باشد null است.

عمومی بولی getZoomControlsEnabled ()

برمی گرداند

گزینه zoomControlsEnabled یا اگر مشخص نشده باشد null شود.

بولی عمومی getZoomGesturesEnabled ()

برمی گرداند

گزینه zoomGesturesEnabled یا در صورت نامشخص null.

عمومی GoogleMapOptions latLngBoundsForCameraTarget ( LatLngBounds llbounds)

یک LatLngBounds را برای محدود کردن هدف دوربین مشخص می کند، به طوری که وقتی کاربران نقشه را اسکرول و حرکت می دهند، هدف دوربین خارج از این محدوده حرکت نکند.

برای جزئیات به setLatLngBoundsForCameraTarget(LatLngBounds) مراجعه کنید.

مولفه های

llbounds

عمومی GoogleMapOptions liteMode (بولی فعال)

مشخص می کند که آیا نقشه باید در حالت ساده ایجاد شود یا خیر. مقدار پیش فرض false است . اگر حالت Lite فعال باشد، نقشه ها به عنوان تصاویر ثابت بارگیری می شوند. این کار را در مواردی بهبود می‌بخشد که نقشه‌های زیادی باید به طور همزمان نمایش داده شوند، به عنوان مثال در یک لیست پیمایشی، با این حال نقشه‌های حالت ساده توسط کاربر نمی‌توانند حرکت یا بزرگ‌نمایی یا کج یا چرخش را اصلاً انجام دهند.

مولفه های

فعال شد

mapId عمومی GoogleMapOptions (String mapId)

شناسه نقشه را مشخص می کند.

مولفه های

mapId

GoogleMapOptions mapToolbar عمومی فعال (بولی فعال)

مشخص می کند که آیا mapToolbar باید فعال باشد یا خیر. برای جزئیات بیشتر به setMapToolbarEnabled(boolean) مراجعه کنید. مقدار پیش فرض true است .

مولفه های

فعال شد

MapType عمومی GoogleMapOptions (int mapType)

تغییر در نوع نقشه اولیه را مشخص می کند.

مولفه های

نوع نقشه

maxZoomPreference عمومی GoogleMapOptions (float maxZoomPreference)

یک کران بالای ترجیحی برای بزرگنمایی دوربین مشخص می کند.

برای جزئیات به setMaxZoomPreference(float) مراجعه کنید.

مولفه های

maxZoomPreference

عمومی GoogleMapOptions minZoomPreference (float minZoomPreference)

یک کران پایین ترجیحی برای بزرگنمایی دوربین مشخص می کند.

برای جزئیات به setMinZoomPreference(float) مراجعه کنید.

مولفه های

minZoomPreference

عمومی GoogleMapOptions rotateGesturesEnabled (بولی فعال)

مشخص می کند که آیا حرکات چرخشی باید فعال شوند یا خیر. برای جزئیات بیشتر به setRotateGesturesEnabled(boolean) مراجعه کنید. مقدار پیش فرض true است .

مولفه های

فعال شد

عمومی GoogleMapOptions scrollGesturesEnabled (بولی فعال)

مشخص می کند که آیا حرکات اسکرول باید فعال شوند یا خیر. برای جزئیات بیشتر به setScrollGesturesEnabled(boolean) مراجعه کنید. مقدار پیش فرض true است .

مولفه های

فعال شد

عمومی GoogleMapOptions scrollGesturesEnabledDuringRotateOrZoom (بولی فعال است)

مشخص می کند که آیا حرکات اسکرول باید در حین حرکات چرخش و زوم فعال شوند یا خیر. برای جزئیات بیشتر به setScrollGesturesEnabledDuringRotateOrZoom(boolean) مراجعه کنید. مقدار پیش فرض true است .

مولفه های

فعال شد

GoogleMapOptions setInstrumentClusterMap عمومی (بولی isInstrumentCluster)

مولفه های

isInstrumentCluster است

عمومی GoogleMapOptions tiltGesturesEnabled (بولی فعال)

مشخص می کند که آیا حرکات شیب باید فعال شوند یا خیر. برای جزئیات بیشتر به setTiltGesturesEnabled(boolean) مراجعه کنید. مقدار پیش فرض true است .

مولفه های

فعال شد

رشته عمومی toString ()

عمومی GoogleMapOptions useViewLifecycleInFragment (useBooleanViewLifecycleInFragment)

هنگام استفاده از MapFragment ، این پرچم مشخص می‌کند که چرخه حیات نقشه باید به نمای قطعه یا خود قطعه مرتبط باشد. مقدار پیش‌فرض false است و چرخه حیات نقشه را به قطعه گره می‌زند.

استفاده از چرخه حیات قطعه امکان رندر سریعتر نقشه را زمانی که قطعه جدا شده و مجدداً متصل می شود، می دهد، زیرا زمینه GL زیرین حفظ می شود. این هزینه دارد که جدا کردن قطعه، اما از بین نرفتن آن، حافظه مورد استفاده نقشه را آزاد نمی کند.

استفاده از چرخه حیات نمای یک قطعه به این معنی است که وقتی قطعه جدا شده و مجدداً متصل می شود، از نقشه مجدداً استفاده نمی شود. این باعث می شود که نقشه دوباره از ابتدا رندر شود که ممکن است چند ثانیه طول بکشد. همچنین به این معنی است که در حالی که یک قطعه جدا شده است، و بنابراین هیچ دیدگاهی ندارد، تمام متدهای GoogleMap NullPointerException را پرتاب می‌کنند.

مولفه های

useViewLifecycleInFragment

عمومی GoogleMapOptions zOrderOnTop (zOrderOnTop بولی)

کنترل کنید که سطح نمای نقشه در بالای پنجره قرار گیرد یا خیر. برای جزئیات بیشتر به setZOrderOnTop(boolean) مراجعه کنید. توجه داشته باشید که این همه نماهایی را که ممکن است روی نقشه ظاهر شوند (به عنوان مثال، کنترل‌های بزرگنمایی، دکمه مکان من) پوشش می‌دهد.

مولفه های

zOrderOnTop

عمومی GoogleMapOptions zoomControlsEnabled (بولی فعال)

مشخص می کند که آیا کنترل های بزرگنمایی باید فعال شوند یا خیر. برای جزئیات بیشتر به setZoomControlsEnabled(boolean) مراجعه کنید. مقدار پیش فرض true است .

مولفه های

فعال شد

عمومی GoogleMapOptions zoomGesturesEnabled (بولی فعال)

مشخص می کند که آیا حرکات زوم باید فعال شوند یا خیر. برای جزئیات بیشتر به setZoomGesturesEnabled(boolean) مراجعه کنید. مقدار پیش فرض true است .

مولفه های

فعال شد