مرجع کلاس GMSMarker


بررسی اجمالی

نشانگر نمادی است که در نقطه خاصی از سطح نقشه قرار می گیرد.

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

GMSOverlay را به ارث می برد.

توسط GMSAdvancedMarker به ارث رسیده است.

توابع اعضای عمومی استاتیک

(نوع نمونه) + نشانگر با موقعیت:
سازنده راحتی برای یک نشانگر پیش فرض.
(تصویر UII *) + markerImageWithColor:
یک نسخه رنگی از تصویر نشانگر پیش فرض را برای استفاده به عنوان نماد ایجاد می کند.

خواص

CLLlocationCoordinate2D موقعیت
موقعیت نشانگر.
NSString * قطعه
متن قطعه، هنگام انتخاب در زیر عنوان در پنجره اطلاعات نشان داده می شود.
تصویر UII * آیکون
نماد نشانگر برای ارائه.
UIVView * iconView
نمای نشانگر برای ارائه.
BOOL tracksViewChanges
کنترل می کند که آیا نماد این نشانگر باید در هر فریم دوباره ترسیم شود.
BOOL tracksInfoWindowChanges
کنترل می کند که آیا پنجره اطلاعات این نشانگر باید در هر فریم دوباره ترسیم شود.
CGPoint لنگر زمین
لنگر زمینی نقطه ای را در تصویر نماد مشخص می کند که به موقعیت نشانگر روی سطح زمین متصل شده است.
CGPoint infoWindowAnchor
لنگر پنجره اطلاعات نقطه ای را در تصویر نماد مشخص می کند که در آن پنجره اطلاعات لنگر می گیرد، که مستقیماً بالای این نقطه نمایش داده می شود.
GMSMarkerAnimation انیمیشن ظاهر
وقتی این نشانگر روی GMSMapView قرار می‌گیرد، انیمیشن مورد استفاده را کنترل می‌کند (پیش‌فرض kGMSMarkerAnimationNone، بدون انیمیشن).
BOOL قابل کشیدن
کنترل می کند که آیا این نشانگر می تواند به صورت تعاملی کشیده شود (NO پیش فرض).
BOOL تخت
کنترل می کند که آیا این نشانگر باید روی سطح زمین صاف باشد (YES) یا یک بیلبورد رو به دوربین (نه، پیش فرض).
CLLlocationدرجات چرخش
چرخش نشانگر را بر حسب درجه در جهت عقربه های ساعت در مورد نقطه لنگر نشانگر تنظیم می کند.
شناور کدورت
کدورت نشانگر را بین 0 (کاملا شفاف) و 1 (پیش فرض) شامل می شود.
GMSMarkerLayer * لایه
لایه Core Animation را برای این GMSMarker فراهم می کند.
GMSPanoramaView * پانوراما
panoramaView مشخص می کند که کدام نمای پانوراما سعی خواهد کرد این نشانگر را نشان دهد.
NSString * عنوان
عنوان، توضیح کوتاهی از همپوشانی.
GMSMapView * نقشه
نقشه ای که این پوشش روی آن قرار دارد.
BOOL قابل ضربه زدن
اگر این همپوشانی باید باعث اعلان ضربه شود.
بین المللی zIndex
همپوشانی‌های با ارزش zIndex بالاتر روی لایه‌ها و روکش‌های کاشی با ارزش zIndex پایین‌تر کشیده می‌شوند.
شناسه داده های کاربر
داده های همپوشانی

مستندات عملکرد اعضا

+ (نمونه) نشانگرWithPosition: (CLLlocationCoordinate2D) موقعیت

سازنده راحتی برای یک نشانگر پیش فرض.

+ (UIImage *) markerImageWithColor: (UIColor nullable *) رنگ

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


اسناد ملکی

- موقعیت (CLLocationCoordinate2D) [read, write, assign]

موقعیت نشانگر.

متحرک.

- قطعه (NSString*) [read, write, copy]

متن قطعه، هنگام انتخاب در زیر عنوان در پنجره اطلاعات نشان داده می شود.

- نماد (UIImage*) [read, write, assign]

نماد نشانگر برای ارائه.

اگر صفر باقی بماند، از نشانگر مکان پیش‌فرض SDK استفاده می‌کند.

از تصاویر متحرک پشتیبانی می کند، اما هر فریم باید اندازه یکسانی داشته باشد یا رفتار آن تعریف نشده است.

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

- (UIView*) iconView [read, write, assign]

نمای نشانگر برای ارائه.

اگر صفر باقی بماند، به جای آن به ویژگی icon باز می گردد.

پشتیبانی از انیمیشن از تمام ویژگی های متحرک UIView، به جز frame و center . تغییر این ویژگی ها یا نسخه CALayer مربوط به آنها، از جمله position ، پشتیبانی نمی شود.

توجه داشته باشید که نما بدون توجه به مقدار واقعی آن به گونه ای رفتار می کند که گویی clipsToBounds روی YES تنظیم شده است.

- (BOOL) tracksViewChanges [read, write, assign]

کنترل می کند که آیا نماد این نشانگر باید در هر فریم دوباره ترسیم شود.

توجه داشته باشید که وقتی از NO به بله تغییر می کند، آیکون تضمین می شود که فریم بعدی دوباره ترسیم شود.

به طور پیش فرض بله. اگر iconView صفر باشد اثری ندارد.

- (BOOL) tracksInfoWindowChanges [read, write, assign]

کنترل می کند که آیا پنجره اطلاعات این نشانگر باید در هر فریم دوباره ترسیم شود.

توجه داشته باشید که وقتی این از NO به بله تغییر می کند، پنجره اطلاعات تضمین می شود که فریم بعدی دوباره ترسیم شود.

پیش‌فرض NO است.

- (CGPoint) groundAnchor [read, write, assign]

لنگر زمینی نقطه ای را در تصویر نماد مشخص می کند که به موقعیت نشانگر روی سطح زمین متصل شده است.

این نقطه در فضای پیوسته [0.0, 1.0] x [0.0، 1.0] مشخص می شود، جایی که (0,0) گوشه سمت چپ بالای تصویر و (1,1) گوشه پایین سمت راست است.

اگر تصویر دارای تراز RectInsets غیر صفر باشد، بالا-چپ و پایین-راست ذکر شده در بالا به بخش inset تصویر مراجعه می کنند.

- (CGPoint) infoWindowAnchor [read, write, assign]

لنگر پنجره اطلاعات نقطه ای را در تصویر نماد مشخص می کند که در آن پنجره اطلاعات لنگر می گیرد، که مستقیماً بالای این نقطه نمایش داده می شود.

این نقطه در همان فضای زمین Anchor مشخص شده است.

- ( GMSMarkerAnimation ) appearAnimation [read, write, assign]

وقتی این نشانگر روی GMSMapView قرار می‌گیرد، انیمیشن مورد استفاده را کنترل می‌کند (پیش‌فرض kGMSMarkerAnimationNone، بدون انیمیشن).

- (BOOL) قابل کشیدن [read, write, assign]

کنترل می کند که آیا این نشانگر می تواند به صورت تعاملی کشیده شود (NO پیش فرض).

- (BOOL) مسطح [read, write, assign]

کنترل می کند که آیا این نشانگر باید روی سطح زمین صاف باشد (YES) یا یک بیلبورد رو به دوربین (نه، پیش فرض).

- چرخش (CLLocationDegrees) [read, write, assign]

چرخش نشانگر را بر حسب درجه در جهت عقربه های ساعت در مورد نقطه لنگر نشانگر تنظیم می کند.

محور چرخش عمود بر نشانگر است. چرخش 0 با موقعیت پیش فرض نشانگر مطابقت دارد. متحرک.

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

- (شناور) کدورت [read, write, assign]

کدورت نشانگر را بین 0 (کاملا شفاف) و 1 (پیش فرض) شامل می شود.

- ( GMSMarkerLayer *) لایه [read, assign]

لایه Core Animation را برای این GMSMarker فراهم می کند.

- ( GMSPanoramaView *) panoramaView [read, write, assign]

panoramaView مشخص می کند که کدام نمای پانوراما سعی خواهد کرد این نشانگر را نشان دهد.

توجه داشته باشید که اگر position نشانگر خیلی دور از مکان پانورامای فعلی panoramaView باشد، نمایش داده نخواهد شد زیرا خیلی کوچک است.

می توان آن را روی صفر تنظیم کرد تا نشانگر را از هر نمای پانورامای فعلی که به آن متصل است حذف کند.

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

- عنوان (NSString*) [read, write, copy, inherited]

عنوان، توضیح کوتاهی از همپوشانی.

برخی از همپوشانی ها، مانند نشانگرها، عنوان را روی نقشه نمایش می دهند. عنوان همچنین متن دسترسی پیش فرض است.

- ( GMSMapView *) نقشه [read, write, assign, inherited]

نقشه ای که این پوشش روی آن قرار دارد.

با تنظیم این ویژگی، همپوشانی به نقشه اضافه می شود. با تنظیم آن روی صفر، این پوشش از نقشه حذف می شود. یک پوشش ممکن است در هر زمان معین حداکثر روی یک نقشه فعال باشد.

- (BOOL) قابل لمس [read, write, assign, inherited]

اگر این همپوشانی باید باعث اعلان ضربه شود.

برخی از پوشش‌ها، مانند نشانگرها، به‌طور پیش‌فرض قابل لمس هستند.

- (int) zIndex [read, write, assign, inherited]

همپوشانی‌های با ارزش zIndex بالاتر روی لایه‌ها و روکش‌های کاشی با ارزش zIndex پایین‌تر کشیده می‌شوند.

مقادیر مساوی منجر به ترتیب نامشخص قرعه کشی می شود. نشانگرها یک استثنا هستند که صرف نظر از zIndex ، همیشه بالای لایه‌های کاشی و دیگر پوشش‌های غیر نشانگر کشیده می‌شوند. آنها به طور موثر در یک گروه z-index جداگانه در مقایسه با دیگر پوشش ها در نظر گرفته می شوند.

- (id) userData [read, write, assign, inherited]

داده های همپوشانی

می توانید از این ویژگی برای مرتبط کردن یک شی دلخواه با این همپوشانی استفاده کنید. Google Maps SDK برای iOS این ویژگی را نه می‌خواند و نه می‌نویسد.

توجه داشته باشید که userData نباید هیچ ارجاع قوی به هیچ یک از اشیاء Maps داشته باشد، در غیر این صورت ممکن است یک چرخه حفظ (جلوگیری از انتشار اشیا) ایجاد شود.