بررسی اجمالی
نشانگر نمادی است که در نقطه خاصی از سطح نقشه قرار می گیرد.
نماد یک نشانگر بهجای سطح نقشه، در جهت روی صفحه دستگاه کشیده میشود. به عنوان مثال، به دلیل چرخش نقشه، کج شدن، یا زوم کردن، لزوما جهت را تغییر نمی دهد.
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 داشته باشد، در غیر این صورت ممکن است یک چرخه حفظ (جلوگیری از انتشار اشیا) ایجاد شود.