نشانگرها مکان های منفرد را روی نقشه نشان می دهند.
به طور پیشفرض، نشانگرها از یک نماد استاندارد استفاده میکنند که ظاهر و احساس رایج Google Maps را دارد. اگر میخواهید نشانگر خود را سفارشی کنید، میتوانید رنگ نشانگر پیشفرض را تغییر دهید، یا تصویر نشانگر را با یک نماد سفارشی جایگزین کنید، یا سایر ویژگیهای نشانگر را تغییر دهید.
در پاسخ به رویداد کلیک روی یک نشانگر، میتوانید پنجره اطلاعات را باز کنید. یک پنجره اطلاعات متن یا تصاویر را در یک پنجره گفتگوی بالای نشانگر نمایش می دهد. میتوانید از یک پنجره اطلاعات پیشفرض برای نمایش متن استفاده کنید، یا پنجره اطلاعات سفارشی خود را برای کنترل کامل محتوای آن ایجاد کنید.
اضافه کردن نشانگر
برای افزودن یک نشانگر، یک شی GMSMarker
ایجاد کنید که شامل position
و title
باشد و map
آن را تنظیم کنید.
مثال زیر نحوه اضافه کردن نشانگر به یک شی GMSMapView
موجود را نشان می دهد. نشانگر در مختصات 10,10
ایجاد می شود و رشته "Hello world" را در پنجره اطلاعات با کلیک روی آن نمایش می دهد.
سویفت
let position = CLLocationCoordinate2D(latitude: 10, longitude: 10) let marker = GMSMarker(position: position) marker.title = "Hello World" marker.map = mapView
هدف-C
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10); GMSMarker *marker = [GMSMarker markerWithPosition:position]; marker.title = @"Hello World"; marker.map = mapView;
میتوانید با تنظیم ویژگی marker.appearAnimation
اضافه شدن نشانگرهای جدید به نقشه را متحرک کنید:
-
kGMSMarkerAnimationPop
باعث می شود که نشانگر هنگام اضافه شدن ازgroundAnchor
خود خارج شود. -
kGMSMarkerAnimationFadeIn
باعث می شود که نشانگر در هنگام اضافه شدن محو شود.
حذف یک نشانگر
با تنظیم ویژگی map
GMSMarker
بر روی nil
، می توانید یک نشانگر را از نقشه حذف کنید. از طرف دیگر، میتوانید با فراخوانی روش clear
GMSMapView
، همه پوششها (از جمله نشانگرها) را که در حال حاضر روی نقشه هستند حذف کنید.
سویفت
let camera = GMSCameraPosition.camera( withLatitude: -33.8683, longitude: 151.2086, zoom: 6 ) let mapView = GMSMapView.map(withFrame: .zero, camera: camera) // ... mapView.clear()
هدف-C
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.8683 longitude:151.2086 zoom:6]; mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera]; // ... [mapView clear];
اگر میخواهید پس از افزودن نشانگر به نقشه، تغییراتی در آن ایجاد کنید، مطمئن شوید که شی GMSMarker
را نگه دارید. بعداً میتوانید با ایجاد تغییرات در این شی، نشانگر را تغییر دهید.
سویفت
let position = CLLocationCoordinate2D(latitude: 10, longitude: 10) let marker = GMSMarker(position: position) marker.map = mapView // ... marker.map = nil
هدف-C
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10); GMSMarker *marker = [GMSMarker markerWithPosition:position]; marker.map = mapView; // ... marker.map = nil;
تغییر رنگ نشانگر
میتوانید رنگ تصویر نشانگر پیشفرض را با درخواست یک نسخه رنگی از نماد پیشفرض با markerImageWithColor:
و ارسال تصویر بهدستآمده به ویژگی نماد GMSMarker
سفارشی کنید.
سویفت
marker.icon = GMSMarker.markerImage(with: .black)
هدف-C
marker.icon = [GMSMarker markerImageWithColor:[UIColor blackColor]];
سفارشی کردن تصویر نشانگر
اگر میخواهید تصویر نشانگر پیشفرض را تغییر دهید، میتوانید با استفاده از icon
نشانگر یا ویژگی iconView
یک نماد سفارشی تنظیم کنید. اگر iconView
تنظیم شده باشد، API ویژگی icon
را نادیده می گیرد.
با استفاده از ویژگی icon
نشانگر
قطعه زیر یک نشانگر با یک نماد سفارشی ارائه شده به عنوان UIImage
در ویژگی icon
ایجاد می کند. این نماد در لندن، انگلستان قرار دارد. این قطعه فرض می کند که برنامه شما حاوی تصویری به نام "house.png" است.
سویفت
let positionLondon = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127) let london = GMSMarker(position: positionLondon) london.title = "London" london.icon = UIImage(named: "house") london.map = mapView
هدف-C
CLLocationCoordinate2D positionLondon = CLLocationCoordinate2DMake(51.5, -0.127); GMSMarker *london = [GMSMarker markerWithPosition:positionLondon]; london.title = @"London"; london.icon = [UIImage imageNamed:@"house"]; london.map = mapView;
اگر چندین نشانگر با یک تصویر ایجاد می کنید، از نمونه مشابهی از UIImage
برای هر یک از نشانگرها استفاده کنید. این به بهبود عملکرد برنامه شما در هنگام نمایش بسیاری از نشانگرها کمک می کند.
این تصویر ممکن است چندین فریم داشته باشد. علاوه بر این، ویژگی alignmentRectInsets
رعایت می شود، که در صورتی مفید است که نشانگر دارای یک سایه یا منطقه غیرقابل استفاده باشد.
با استفاده از ویژگی iconView
نشانگر
قطعه زیر با تنظیم ویژگی iconView
نشانگر یک نشانگر با یک نماد سفارشی ایجاد می کند و تغییر رنگ نشانگر را متحرک می کند. این قطعه فرض می کند که برنامه شما حاوی تصویری به نام "house.png" است.
سویفت
import CoreLocation import GoogleMaps class MarkerViewController: UIViewController, GMSMapViewDelegate { var mapView: GMSMapView! var london: GMSMarker? var londonView: UIImageView? override func viewDidLoad() { super.viewDidLoad() let camera = GMSCameraPosition.camera( withLatitude: 51.5, longitude: -0.127, zoom: 14 ) let mapView = GMSMapView.map(withFrame: .zero, camera: camera) view = mapView mapView.delegate = self let house = UIImage(named: "House")!.withRenderingMode(.alwaysTemplate) let markerView = UIImageView(image: house) markerView.tintColor = .red londonView = markerView let position = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127) let marker = GMSMarker(position: position) marker.title = "London" marker.iconView = markerView marker.tracksViewChanges = true marker.map = mapView london = marker } func mapView(_ mapView: GMSMapView, idleAt position: GMSCameraPosition) { UIView.animate(withDuration: 5.0, animations: { () -> Void in self.londonView?.tintColor = .blue }, completion: {(finished) in // Stop tracking view changes to allow CPU to idle. self.london?.tracksViewChanges = false }) } }
هدف-C
@import CoreLocation; @import GoogleMaps; @interface MarkerViewController : UIViewController <GMSMapViewDelegate> @property (strong, nonatomic) GMSMapView *mapView; @end @implementation MarkerViewController { GMSMarker *_london; UIImageView *_londonView; } - (void)viewDidLoad { [super viewDidLoad]; GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:51.5 longitude:-0.127 zoom:14]; _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera]; self.view = _mapView; _mapView.delegate = self; UIImage *house = [UIImage imageNamed:@"House"]; house = [house imageWithRenderingMode:UIImageRenderingModeAlwaysTemplate]; _londonView = [[UIImageView alloc] initWithImage:house]; _londonView.tintColor = [UIColor redColor]; CLLocationCoordinate2D position = CLLocationCoordinate2DMake(51.5, -0.127); _london = [GMSMarker markerWithPosition:position]; _london.title = @"London"; _london.iconView = _londonView; _london.tracksViewChanges = YES; _london.map = self.mapView; } - (void)mapView:(GMSMapView *)mapView idleAtCameraPosition:(GMSCameraPosition *)position { [UIView animateWithDuration:5.0 animations:^{ self->_londonView.tintColor = [UIColor blueColor]; } completion:^(BOOL finished) { // Stop tracking view changes to allow CPU to idle. self->_london.tracksViewChanges = NO; }]; } @end
از آنجایی که iconView
یک UIView
را میپذیرد، میتوانید سلسله مراتبی از کنترلهای استاندارد UI داشته باشید که نشانگرهای شما را تعریف میکنند، هر نما دارای مجموعه استانداردی از قابلیتهای انیمیشن است. میتوانید تغییراتی در اندازه نشانگر، رنگ و سطوح آلفا و همچنین اعمال تبدیلهای دلخواه اعمال کنید. ویژگی iconView
از انیمیشن تمام ویژگیهای متحرک UIView
به جز frame
و center
پشتیبانی میکند.
لطفاً هنگام استفاده از iconView
به نکات زیر توجه کنید:
- زمانی که
tracksViewChanges
رویYES
تنظیم شده باشد،UIView
میتواند منابع زیادی را طلب کند، که ممکن است منجر به افزایش مصرف باتری شود. در مقایسه،UIImage
یک فریم ثابت است و نیازی به رندر مجدد ندارد. - اگر نشانگرهای زیادی روی صفحه دارید و هر نشانگر
UIView
خاص خود را دارد و همه نشانگرها همزمان تغییرات را ردیابی میکنند، ممکن است برخی دستگاهها برای ارائه نقشه مشکل داشته باشند. - یک
iconView
به تعامل کاربر پاسخ نمی دهد، زیرا یک عکس فوری از نما است. - نمایش به گونهای عمل میکند که گویی
clipsToBounds
بدون توجه به مقدار واقعی آن رویYES
تنظیم شده است. میتوانید تبدیلهایی را اعمال کنید که خارج از محدوده کار میکنند، اما شیئی که ترسیم میکنید باید در محدوده شیء باشد. همه تبدیل ها/تغییرها نظارت و اعمال می شوند. به طور خلاصه: بازدیدهای فرعی باید در نما باشد.
برای تصمیم گیری در مورد زمان تنظیم ویژگی tracksViewChanges
، باید ملاحظات عملکرد را در مقابل مزایای ترسیم مجدد خودکار نشانگر بسنجید. به عنوان مثال:
- اگر یک سری تغییرات برای ایجاد دارید، می توانید ویژگی را به
YES
تغییر دهید و سپس بهNO
برگردید. - هنگامی که یک انیمیشن در حال اجرا است یا محتویات به صورت ناهمزمان بارگذاری می شوند، باید ویژگی را روی
YES
تنظیم کنید تا زمانی که اقدامات کامل شوند.
تغییر شفافیت نشانگر
شما می توانید کدورت یک نشانگر را با خاصیت opacity
آن کنترل کنید. شما باید کدورت را به عنوان یک شناور بین 0.0 و 1.0 مشخص کنید، جایی که 0 کاملاً شفاف و 1 کاملاً مات است.
سویفت
marker.opacity = 0.6
هدف-C
marker.opacity = 0.6;
میتوانید تیرگی نشانگر را با [Core Animation] Core Animation با استفاده از GMSMarkerLayer
متحرک کنید.
صاف کردن یک نشانگر
نمادهای نشانگر معمولاً بهجای سطح نقشه در جهت روی صفحه دستگاه ترسیم میشوند، بنابراین چرخش، کج کردن یا بزرگنمایی نقشه لزوماً جهت نشانگر را تغییر نمیدهد.
می توانید جهت یک نشانگر را به صورت صاف در برابر زمین تنظیم کنید. نشانگرهای مسطح زمانی که نقشه می چرخد می چرخند و وقتی نقشه کج می شود چشم انداز را تغییر می دهند. مانند نشانگرهای معمولی، نشانگرهای مسطح هنگام بزرگنمایی یا کوچکنمایی نقشه، اندازه خود را حفظ می کنند.
برای تغییر جهت نشانگر، ویژگی flat
نشانگر را روی YES
یا true
تنظیم کنید.
سویفت
let positionLondon = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127) let londonMarker = GMSMarker(position: positionLondon) londonMarker.isFlat = true londonMarker.map = mapView
هدف-C
CLLocationCoordinate2D positionLondon = CLLocationCoordinate2DMake(51.5, -0.127); GMSMarker *londonMarker = [GMSMarker markerWithPosition:positionLondon]; londonMarker.flat = YES; londonMarker.map = mapView;
چرخاندن یک نشانگر
با تنظیم ویژگی rotation
، می توانید یک نشانگر را در اطراف نقطه لنگر آن بچرخانید. چرخش را بهعنوان یک نوع CLLocationDegrees
تعیین کنید، که در جهت عقربههای ساعت از موقعیت پیشفرض اندازهگیری میشود. هنگامی که نشانگر روی نقشه صاف است، موقعیت پیش فرض شمال است.
مثال زیر نشانگر را 90 درجه می چرخاند. تنظیم ویژگی groundAnchor
روی 0.5,0.5
باعث می شود که نشانگر به جای پایه خود به دور مرکز خود بچرخد.
سویفت
let degrees = 90.0 londonMarker.groundAnchor = CGPoint(x: 0.5, y: 0.5) londonMarker.rotation = degrees londonMarker.map = mapView
هدف-C
CLLocationDegrees degrees = 90; londonMarker.groundAnchor = CGPointMake(0.5, 0.5); londonMarker.rotation = degrees; londonMarker.map = mapView;
مدیریت رویدادها روی نشانگرها
می توانید به رویدادهایی که روی نقشه رخ می دهند گوش دهید، مانند زمانی که کاربر روی یک نشانگر ضربه می زند. برای گوش دادن به رویدادها، باید پروتکل GMSMapViewDelegate
را پیاده سازی کنید. برای یادگیری نحوه مدیریت رویدادهای نشانگر خاص ، رویدادها و حرکات نشانگر را ببینید. راهنمای رویدادها همچنین فهرستی از روشها را در GMSMapViewDelegate ارائه میکند. برای رویدادهای نمای خیابان، GMSPanoramaViewDelegate
ببینید.