मार्कर मैप पर एक जगह दिखाते हैं.
डिफ़ॉल्ट रूप से, मार्कर एक मानक आइकॉन का इस्तेमाल करते हैं, जिसमें Google Maps का रंग-रूप एक जैसा होता है. अगर आप अपने मार्कर को पसंद के मुताबिक बनाना चाहते हैं, तो आप डिफ़ॉल्ट मार्कर का रंग बदल सकते हैं या मार्कर की इमेज को पसंद के मुताबिक आइकॉन से बदल सकते हैं. इसके अलावा, मार्कर की अन्य प्रॉपर्टी भी बदल सकते हैं.
मार्कर पर हुए क्लिक इवेंट के जवाब में, आपके पास जानकारी विंडो खोलने का विकल्प होता है. एक जानकारी विंडो मार्कर के ऊपर एक डायलॉग विंडो में टेक्स्ट या इमेज दिखाती है. टेक्स्ट दिखाने के लिए, डिफ़ॉल्ट जानकारी विंडो का इस्तेमाल किया जा सकता है. इसके अलावा, कॉन्टेंट को पूरी तरह से कंट्रोल करने के लिए, अपनी पसंद के मुताबिक जानकारी विंडो बनाई जा सकती है.
मार्कर जोड़ना
मार्कर जोड़ने के लिए, ऐसा GMSMarker
ऑब्जेक्ट बनाएं जिसमें position
और title
शामिल हों. साथ ही, उसका map
सेट करें.
इस उदाहरण में, किसी मौजूदा GMSMapView
ऑब्जेक्ट में मार्कर जोड़ने का तरीका बताया गया है. मार्कर 10,10
निर्देशांक पर बनाया जाता है और
क्लिक किए जाने पर जानकारी विंडो में "नमस्ते दुनिया" दिखाता है.
Swift
let position = CLLocationCoordinate2D(latitude: 10, longitude: 10) let marker = GMSMarker(position: position) marker.title = "Hello World" marker.map = mapView
Objective-C
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10); GMSMarker *marker = [GMSMarker markerWithPosition:position]; marker.title = @"Hello World"; marker.map = mapView;
marker.appearAnimation
प्रॉपर्टी को इस पर सेट करके, मैप में जोड़े गए नए मार्कर को ऐनिमेट किया जा सकता है:
kGMSMarkerAnimationPop
मार्कर को जोड़े जाने पर उसकेgroundAnchor
से पॉप आउट करने के लिए.- जोड़े जाने पर मार्कर फ़ेड इन हो जाए, इसके लिए
kGMSMarkerAnimationFadeIn
.
मार्कर को हटाया जा रहा है
GMSMarker
की map
प्रॉपर्टी को nil
पर सेट करके, मैप से कोई मार्कर हटाया जा सकता है. इसके अलावा, मैप पर मौजूद सभी ओवरले (इसमें मार्कर भी शामिल हैं) को हटाया जा सकता है. इसके लिए, GMSMapView
clear
तरीके का इस्तेमाल करें.
Swift
let camera = GMSCameraPosition.camera( withLatitude: -33.8683, longitude: 151.2086, zoom: 6 ) let mapView = GMSMapView.map(withFrame: .zero, camera: camera) // ... mapView.clear()
Objective-C
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.8683 longitude:151.2086 zoom:6]; mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera]; // ... [mapView clear];
अगर किसी मार्कर को मैप में जोड़ने के बाद उसमें बदलाव करना है, तो पक्का करें कि GMSMarker
ऑब्जेक्ट को होल्ड पर रखा जाए. इस ऑब्जेक्ट में बदलाव करके, मार्कर में बाद में बदलाव किया जा सकता है.
Swift
let position = CLLocationCoordinate2D(latitude: 10, longitude: 10) let marker = GMSMarker(position: position) marker.map = mapView // ... marker.map = nil
Objective-C
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10); GMSMarker *marker = [GMSMarker markerWithPosition:position]; marker.map = mapView; // ... marker.map = nil;
मार्कर का रंग बदलना
markerImageWithColor:
की मदद से डिफ़ॉल्ट आइकॉन के टिंट किए गए वर्शन का अनुरोध करके और नतीजे वाली इमेज को GMSMarker
की आइकॉन प्रॉपर्टी में पास करके, डिफ़ॉल्ट मार्कर इमेज के रंग को पसंद के मुताबिक बनाया जा सकता है.
Swift
marker.icon = GMSMarker.markerImage(with: .black)
Objective-C
marker.icon = [GMSMarker markerImageWithColor:[UIColor blackColor]];
मार्कर चित्र को कस्टमाइज़ करना
अगर आप डिफ़ॉल्ट मार्कर इमेज को बदलना चाहते हैं, तो मार्कर की icon
या iconView
प्रॉपर्टी का इस्तेमाल करके
पसंद के मुताबिक आइकॉन सेट करें. अगर iconView
सेट है, तो एपीआई icon
प्रॉपर्टी को अनदेखा कर देता है.
मार्कर की icon
प्रॉपर्टी का इस्तेमाल करें
यह स्निपेट, icon
प्रॉपर्टी में UIImage
के तौर पर दिए गए कस्टम आइकॉन के साथ एक मार्कर बनाता है. यह आइकॉन लंदन के इंग्लैंड में है. स्निपेट मानता है कि आपके ऐप्लिकेशन में "house.png" नाम की इमेज है.
Swift
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
Objective-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" नाम की इमेज है.
Swift
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 }) } }
Objective-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
को स्वीकार करता है. इसलिए, आपके पास मार्कर तय करने वाले स्टैंडर्ड यूज़र इंटरफ़ेस (यूआई) कंट्रोल की हैरारकी हो सकती है. हर व्यू में, ऐनिमेशन की क्षमता का स्टैंडर्ड सेट होता है. आपके पास मार्कर के साइज़, रंग, और ऐल्फ़ा लेवल में बदलाव शामिल करने के साथ-साथ, आर्बिट्रेरी ट्रांसफ़ॉर्मेशन को लागू करने का विकल्प भी होता है. iconView
प्रॉपर्टी में, frame
और center
को छोड़कर, UIView
की सभी ऐनिमेट की जा सकने वाली प्रॉपर्टी के ऐनिमेशन काम करते हैं.
iconView
का इस्तेमाल करते समय कृपया इन बातों का ध्यान रखें:
- जब
tracksViewChanges
कोYES
पर सेट किया जाता है, तोUIView
में संसाधनों की ज़रूरत पड़ती है. इसकी वजह से बैटरी खर्च बढ़ सकता है. इसके मुकाबले, एक फ़्रेमUIImage
स्टैटिक होता है और इसे फिर से रेंडर करने की ज़रूरत नहीं होती. - अगर आपके स्क्रीन पर कई मार्कर हैं और हर मार्कर का अपना
UIView
है और सभी मार्कर एक ही समय पर बदलावों को ट्रैक कर रहे हैं, तो कुछ डिवाइसों को मैप को रेंडर करने में समस्या आ सकती है. iconView
, उपयोगकर्ता के इंटरैक्शन पर जवाब नहीं देता, क्योंकि यह व्यू का स्नैपशॉट है.- व्यू इस तरह काम करता है जैसे
clipsToBounds
कोYES
पर सेट किया गया हो, भले ही उसकी असल वैल्यू कुछ भी हो. ऐसे ट्रांसफ़ॉर्म को लागू किया जा सकता है जो सीमाओं से बाहर काम करते हों, लेकिन ऑब्जेक्ट को ऑब्जेक्ट के अंदर होना चाहिए. सभी ट्रांसफ़ॉर्म/शिफ़्ट की निगरानी की जाती है और उन्हें लागू किया जाता है. कम शब्दों में: सबव्यू, व्यू में शामिल होने चाहिए.
यह तय करने के लिए कि tracksViewChanges
प्रॉपर्टी को कब सेट करना है, आपको मार्कर को अपने-आप फिर से ड्रॉ करने से होने वाले फ़ायदों के बजाय, परफ़ॉर्मेंस से जुड़ी ज़रूरी बातों को ध्यान में रखना चाहिए. उदाहरण के लिए:
- अगर आपको कई बदलाव करने हैं, तो प्रॉपर्टी को
YES
में और फिर वापसNO
में बदलें. - जब कोई ऐनिमेशन चल रहा हो या कॉन्टेंट एसिंक्रोनस तरीके से लोड हो रहा हो, तो आपको प्रॉपर्टी को
YES
पर सेट रखना चाहिए. ऐसा तब तक करना चाहिए, जब तक कार्रवाइयां पूरी नहीं हो जातीं.
मार्कर की ओपैसिटी बदलना
किसी मार्कर की opacity
प्रॉपर्टी की मदद से, उसकी ओपैसिटी को कंट्रोल किया जा सकता है. आपको ओपैसिटी को 0.0 और 1.0 के बीच फ़्लोट के रूप में बताना चाहिए, जहां 0 पूरी तरह पारदर्शी है और 1 पूरी तरह से ओपेक है.
Swift
marker.opacity = 0.6
Objective-C
marker.opacity = 0.6;
GMSMarkerLayer
का इस्तेमाल करके, [Coreऐनिमेशन]कोर ऐनिमेशन के साथ मार्कर की ओपैसिटी को ऐनिमेट किया जा सकता है.
मार्कर को फ़्लैट करना
मार्कर आइकॉन आम तौर पर मैप की सतह के बजाय डिवाइस की स्क्रीन के हिसाब से बनाए जाते हैं, इसलिए ज़रूरी नहीं है कि मैप को घुमाने, झुकाने या ज़ूम करने से मार्कर की दिशा बदल जाए.
आप मार्कर के ओरिएंटेशन को पृथ्वी के सामने सपाट होने के लिए सेट कर सकते हैं. मैप घुमाए जाने पर, फ़्लैट मार्कर घुमते हैं और मैप को झुकाने पर ऐंगल बदल जाते हैं. नियमित मार्कर की तरह, मैप को ज़ूम इन या ज़ूम आउट करने पर सपाट मार्कर अपना आकार बनाए रखते हैं.
मार्कर का ओरिएंटेशन बदलने के लिए, मार्कर की flat
प्रॉपर्टी को
YES
या true
पर सेट करें.
Swift
let positionLondon = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127) let londonMarker = GMSMarker(position: positionLondon) londonMarker.isFlat = true londonMarker.map = mapView
Objective-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
पर सेट करने से, मार्कर को बेस के बजाय, उसके बीच में घुमाया जाता है.
Swift
let degrees = 90.0 londonMarker.groundAnchor = CGPoint(x: 0.5, y: 0.5) londonMarker.rotation = degrees londonMarker.map = mapView
Objective-C
CLLocationDegrees degrees = 90; londonMarker.groundAnchor = CGPointMake(0.5, 0.5); londonMarker.rotation = degrees; londonMarker.map = mapView;
मार्कर पर इवेंट मैनेज करना
मैप पर होने वाले इवेंट सुने जा सकते हैं, जैसे कि जब कोई उपयोगकर्ता किसी मार्कर पर टैप करता है. इवेंट सुनने के लिए, आपको
GMSMapViewDelegate
प्रोटोकॉल लागू करना होगा. किसी खास मार्कर इवेंट को मैनेज करने का तरीका जानने के लिए, मार्कर इवेंट और हाथ के जेस्चर देखें. इवेंट के लिए गाइड में GMSMapViewDelegate पर तरीकों की सूची भी दी गई है. Street View इवेंट के लिए, GMSPanoramaViewDelegate
देखें.