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

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

گزینه های GroundOverlay

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

گزینه هایی را برای پوشش زمین تعریف می کند.

خلاصه ثابت

شناور NO_DIMENSION زمانی که هیچ ابعادی برای ارتفاع مشخص نشده باشد، پرچم گذاری کنید.

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

از رابط android.os.Parcelable

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

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

گزینه های GroundOverlay ()

مجموعه جدیدی از گزینه های پوشش زمین ایجاد می کند.

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

گزینه های GroundOverlay	لنگر (شناور u، شناور v) لنگر را مشخص می کند.
گزینه های GroundOverlay	بلبرینگ (بلبرینگ شناور) یاتاقان پوشش زمین را بر حسب درجه در جهت عقربه های ساعت از شمال مشخص می کند.
گزینه های GroundOverlay	قابل کلیک (قابل کلیک بولی) مشخص می کند که آیا روکش زمین قابل کلیک است یا خیر.
شناور	getAnchorU () لنگر نسبی افقی; `0.0` و `1.0` به ترتیب لبه های چپ و راست را نشان می دهند.
شناور	getAnchorV () لنگر نسبی عمودی؛ `0.0` و `1.0` به ترتیب لبه های بالا و پایین را نشان می دهند.
شناور	getBearing () مجموعه بلبرینگ را برای این شی `GroundOverlayOptions` دریافت می کند.
LatLngBounds	getBounds () محدوده های تنظیم شده برای این شی `GroundOverlayOptions` را دریافت می کند.
شناور	دریافت قد () ارتفاع تنظیم شده برای این شی `GroundOverlayOptions` را دریافت می کند.
BitmapDescriptor	getImage () مجموعه توصیفگر تصویر را برای این شی `GroundOverlayOptions` دریافت می کند.
LatLng	getLocation () مکان تنظیم شده برای این شی `GroundOverlayOptions` را دریافت می کند.
شناور	شفاف سازی () مجموعه شفافیت را برای این شی `GroundOverlayOptions` دریافت می کند.
شناور	getWidth () تنظیم عرض برای این شی `GroundOverlayOptions` را دریافت می کند.
شناور	getZIndex () مجموعه zIndex را برای این شی `GroundOverlayOptions` دریافت می کند.
گزینه های GroundOverlay	تصویر ( BitmapDescriptor imageDescriptor) تصویر را برای این پوشش زمین مشخص می کند.
بولی	قابل کلیک است () تنظیم قابلیت کلیک را برای این شی `GroundOverlayOptions` دریافت می کند.
بولی	قابل مشاهده است () تنظیمات دید را برای این شی `GroundOverlayOptions` دریافت می کند.
گزینه های GroundOverlay	موقعیت (موقعیت LatLng ، عرض شناور) موقعیت این پوشش زمین را با استفاده از یک نقطه لنگر (a `LatLng` ) و عرض (بر حسب متر) مشخص می کند.
گزینه های GroundOverlay	موقعیت (موقعیت LatLng ، عرض شناور، ارتفاع شناور) موقعیت این پوشش زمین را با استفاده از یک نقطه لنگر (یک `LatLng` )، عرض و ارتفاع (هر دو بر حسب متر) مشخص می کند.
گزینه های GroundOverlay	positionFromBounds (حدود LatLngBounds ) موقعیت این پوشش زمین را مشخص می کند.
گزینه های GroundOverlay	شفافیت (شفافیت شناور) شفافیت پوشش زمین را مشخص می کند.
گزینه های GroundOverlay	قابل مشاهده (بولی قابل مشاهده) میزان دید را برای پوشش زمین مشخص می کند.
گزینه های GroundOverlay	zIndex (zIndex شناور) zIndex روکش زمین را مشخص می کند، یعنی ترتیب ترسیم آن را مشخص می کند.

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

از کلاس java.lang.Object

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

از رابط android.os.Parcelable

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

ثابت ها

شناور نهایی استاتیک عمومی NO_DIMENSION

زمانی که هیچ ابعادی برای ارتفاع مشخص نشده باشد، پرچم گذاری کنید.

مقدار ثابت: -1.0

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

عمومی GroundOverlayOptions ()

مجموعه جدیدی از گزینه های پوشش زمین ایجاد می کند.

روش های عمومی

لنگر عمومی GroundOverlayOptions (float u، float v)

لنگر را مشخص می کند.

لنگر با محل روکش زمین هماهنگ است.

نقطه لنگر در فضای پیوسته دوبعدی مشخص می شود که در آن (0.0)، (1،0)، (0،1) و (1،1) نشانگر بالا-چپ، بالا-راست، پایین-چپ و پایین-راست است. به ترتیب گوشه ها

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*

پارامترها

تو	مختصات u لنگر
v	v- مختصات لنگر

برمی گرداند

این شی GroundOverlayOptions با یک مجموعه لنگر جدید.

بلبرینگ عمومی GroundOverlayOptions (بلبرینگ شناور)

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

توجه داشته باشید که کران طول و عرض جغرافیایی قبل از چرخش اعمال می شود.

پارامترها

بلبرینگ	بلبرینگ بر حسب درجه در جهت عقربه های ساعت از شمال. مقادیر خارج از محدوده [0، 360) نرمال می شوند.

برمی گرداند

این شی GroundOverlayOptions با یک مجموعه یاتاقان جدید.

عمومی GroundOverlayOptions قابل کلیک (قابل کلیک بولین)

مشخص می کند که آیا روکش زمین قابل کلیک است یا خیر. قابلیت کلیک پیش فرض false است.

پارامترها

قابل کلیک	تنظیم جدید قابلیت کلیک

برمی گرداند

این شی GroundOverlayOptions با تنظیم قابلیت کلیک جدید.

عمومی float getAnchorU ()

لنگر نسبی افقی; 0.0 و 1.0 به ترتیب لبه های چپ و راست را نشان می دهند. سایر مقادیر لنگر بر این اساس درون یابی می شوند.

برمی گرداند

محل لنگر نسبی لبه افقی.

عمومی float getAnchorV ()

لنگر نسبی عمودی؛ 0.0 و 1.0 به ترتیب لبه های بالا و پایین را نشان می دهند. سایر مقادیر لنگر بر این اساس درون یابی می شوند.

برمی گرداند

محل لنگر نسبی لبه عمودی.

عمومی float getBearing ()

مجموعه بلبرینگ را برای این شی GroundOverlayOptions دریافت می کند.

برمی گرداند

یاتاقان پوشش زمین

عمومی LatLngBounds getBounds ()

محدوده های تنظیم شده برای این شی GroundOverlayOptions را دریافت می کند.

برمی گرداند

مرزهای پوشش زمین اگر موقعیت با استفاده از position(LatLng, float) یا position(LatLng, float, float) تنظیم شده باشد، این null خواهد بود.

دریافت ارتفاع شناور عمومی ()

ارتفاع تنظیم شده برای این شی GroundOverlayOptions را دریافت می کند.

برمی گرداند

ارتفاع روکش زمین

عمومی BitmapDescriptor getImage ()

مجموعه توصیفگر تصویر را برای این شی GroundOverlayOptions دریافت می کند.

برمی گرداند

یک BitmapDescriptor که تصویر همپوشانی زمین را نشان می دهد.

عمومی LatLng getLocation ()

مکان تنظیم شده برای این شی GroundOverlayOptions را دریافت می کند.

برمی گرداند

محل قرار دادن لنگر روکش زمین. اگر موقعیت با استفاده از positionFromBounds(LatLngBounds) تنظیم شده باشد، این null خواهد بود.

عمومی float getTransparency ()

مجموعه شفافیت را برای این شی GroundOverlayOptions دریافت می کند.

برمی گرداند

شفافیت پوشش زمین

دریافت عرض شناور عمومی ()

تنظیم عرض برای این شی GroundOverlayOptions را دریافت می کند.

برمی گرداند

عرض روکش زمین

عمومی float getZIndex ()

مجموعه zIndex را برای این شی GroundOverlayOptions دریافت می کند.

برمی گرداند

zIndex پوشش زمین.

تصویر عمومی GroundOverlayOptions ( BitmapDescriptor imageDescriptor)

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

برای بارگذاری یک تصویر به عنوان یک بافت (که برای ترسیم تصویر روی نقشه استفاده می شود)، باید آن را به تصویری با اضلاع با توان دو تبدیل کرد. این به این دلیل است که می‌توان یک mipmap به منظور ارائه بافت در سطوح مختلف زوم ایجاد کرد - برای جزئیات بیشتر به Mipmap (ویکی‌پدیا) مراجعه کنید. از این رو، برای حفظ حافظه با اجتناب از این تبدیل، توصیه می شود که ابعاد تصویر توان دو باشد.

پارامترها

تصویر توصیفگر	`BitmapDescriptor` برای استفاده برای این همپوشانی زمین

برمی گرداند

این شی GroundOverlayOptions با یک مجموعه تصویر جدید.

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

تنظیم قابلیت کلیک را برای این شی GroundOverlayOptions دریافت می کند.

برمی گرداند

اگر روکش زمین قابل کلیک باشد true . false اگر نباشد

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

تنظیمات دید را برای این شی GroundOverlayOptions دریافت می کند.

برمی گرداند

true اگر این پوشش زمین قابل مشاهده باشد. false اگر نباشد

موقعیت عمومی GroundOverlayOptions (مکان LatLng ، عرض شناور)

موقعیت این پوشش زمین را با استفاده از یک نقطه لنگر (a LatLng ) و عرض (بر حسب متر) مشخص می کند. ارتفاع بر این اساس برای حفظ نسبت ابعاد تطبیق داده می شود.

پارامترها

مکان	مکان روی نقشه `LatLng` که نقطه لنگر در تصویر داده شده ثابت می ماند. لنگر در هنگام اعمال تغییر شکل روی زمین ثابت می ماند (به عنوان مثال، setDimensions، setBearing، و غیره).
عرض	عرض روکش (بر حسب متر). ارتفاع بر اساس نسبت تصویر به طور خودکار تعیین می شود.

برمی گرداند

این شی GroundOverlayOptions با یک مجموعه موقعیت جدید.

پرتاب می کند

IllegalArgumentException	اگر لنگر `null` باشد
IllegalArgumentException	اگر عرض منفی باشد
IllegalStateException	اگر موقعیت قبلاً با استفاده از `positionFromBounds(LatLngBounds)` تنظیم شده بود

موقعیت عمومی GroundOverlayOptions (موقعیت LatLng ، عرض شناور، ارتفاع شناور)

موقعیت این پوشش زمین را با استفاده از یک نقطه لنگر (یک LatLng )، عرض و ارتفاع (هر دو بر حسب متر) مشخص می کند. هنگامی که رندر می شود، تصویر برای تناسب با ابعاد مشخص شده کوچک می شود.

پارامترها

مکان	مکان روی نقشه `LatLng` که نقطه لنگر در تصویر داده شده ثابت می ماند. لنگر در هنگام اعمال تغییر شکل روی زمین ثابت می ماند (به عنوان مثال، setDimensions، setBearing، و غیره).
عرض	عرض روکش (بر حسب متر)
ارتفاع	ارتفاع روکش (بر حسب متر)

برمی گرداند

این شی GroundOverlayOptions با یک مجموعه موقعیت جدید.

پرتاب می کند

IllegalArgumentException	اگر لنگر `null` باشد
IllegalArgumentException	اگر عرض یا ارتفاع منفی باشد
IllegalStateException	اگر موقعیت قبلاً با استفاده از `positionFromBounds(LatLngBounds)` تنظیم شده بود

پوزیشن عمومی GroundOverlayOptionsFromBounds (حدود LatLngBounds )

موقعیت این پوشش زمین را مشخص می کند.

پارامترها

محدوده	یک `LatLngBounds` که در آن روکش زمین قرار می گیرد

برمی گرداند

این شی GroundOverlayOptions با یک مجموعه موقعیت جدید.

پرتاب می کند

IllegalStateException	اگر موقعیت قبلاً با استفاده از `position(LatLng, float)` یا `position(LatLng, float, float)` تنظیم شده بود.

شفافیت عمومی GroundOverlayOptions (شفافیت شناور)

شفافیت پوشش زمین را مشخص می کند. شفافیت پیش‌فرض 0 (مادر) است.

پارامترها

شفافیت	یک شناور در محدوده `[0..1]` که در آن `0` به این معنی است که روکش زمین مات است و `1` به معنای شفاف بودن پوشش زمین است.

برمی گرداند

این شی GroundOverlayOptions با یک تنظیم شفافیت جدید.

پرتاب می کند

IllegalArgumentException	اگر شفافیت خارج از محدوده [0..1] باشد.

عمومی GroundOverlayOptions قابل مشاهده (بولی قابل مشاهده)

میزان دید را برای پوشش زمین مشخص می کند. مشاهده پیش فرض true است.

پارامترها

قابل مشاهده است

برمی گرداند

این شی GroundOverlayOptions با یک تنظیم دید جدید.

zIndex عمومی GroundOverlayOptions (zIndex شناور)

zIndex روکش زمین را مشخص می کند، یعنی ترتیب ترسیم آن را مشخص می کند. برای اطلاعات بیشتر درباره zIndex به مستندات بالای این کلاس مراجعه کنید.

پارامترها

zIndex

برمی گرداند

این شی GroundOverlayOptions با مجموعه zIndex جدید.