मार्कर

मार्कर मैप पर एक जगह दिखाते हैं.

डिफ़ॉल्ट रूप से, मार्कर एक मानक आइकॉन का इस्तेमाल करते हैं, जिसमें Google Maps का रंग-रूप एक जैसा होता है. अगर आप अपने मार्कर को पसंद के मुताबिक बनाना चाहते हैं, तो आप डिफ़ॉल्ट मार्कर का रंग बदल सकते हैं या मार्कर की इमेज को पसंद के मुताबिक आइकॉन से बदल सकते हैं. इसके अलावा, मार्कर की अन्य प्रॉपर्टी भी बदल सकते हैं.

मार्कर पर हुए क्लिक इवेंट के जवाब में, आपके पास जानकारी विंडो खोलने का विकल्प होता है. एक जानकारी विंडो मार्कर के ऊपर एक डायलॉग विंडो में टेक्स्ट या इमेज दिखाती है. टेक्स्ट दिखाने के लिए, डिफ़ॉल्ट जानकारी विंडो का इस्तेमाल किया जा सकता है. इसके अलावा, कॉन्टेंट को पूरी तरह से कंट्रोल करने के लिए, अपनी पसंद के मुताबिक जानकारी विंडो बनाई जा सकती है.

मार्कर जोड़ना

मार्कर जोड़ने के लिए, ऐसा GMSMarker ऑब्जेक्ट बनाएं जिसमें position और title शामिल हों. साथ ही, उसका map सेट करें.

इस उदाहरण में, किसी मौजूदा GMSMapView ऑब्जेक्ट में मार्कर जोड़ने का तरीका बताया गया है. मार्कर 10,10 निर्देशांक पर बनाया जाता है और क्लिक किए जाने पर जानकारी विंडो में "नमस्ते दुनिया" दिखाता है.

let position = CLLocationCoordinate2D(latitude: 10, longitude: 10)
let marker = GMSMarker(position: position)
marker.title = "Hello World"
marker.map = mapView
      

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 तरीके का इस्तेमाल करें.

let camera = GMSCameraPosition.camera(
  withLatitude: -33.8683,
  longitude: 151.2086,
  zoom: 6
)
let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
// ...
mapView.clear()
      

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
      

CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10);
GMSMarker *marker = [GMSMarker markerWithPosition:position];
marker.map = mapView;
// ...
marker.map = nil;
      

मार्कर का रंग बदलना

markerImageWithColor: की मदद से डिफ़ॉल्ट आइकॉन के टिंट किए गए वर्शन का अनुरोध करके और नतीजे वाली इमेज को GMSMarker की आइकॉन प्रॉपर्टी में पास करके, डिफ़ॉल्ट मार्कर इमेज के रंग को पसंद के मुताबिक बनाया जा सकता है.

marker.icon = GMSMarker.markerImage(with: .black)
      

marker.icon = [GMSMarker markerImageWithColor:[UIColor blackColor]];
      

मार्कर चित्र को कस्टमाइज़ करना

अगर आप डिफ़ॉल्ट मार्कर इमेज को बदलना चाहते हैं, तो मार्कर की icon या iconView प्रॉपर्टी का इस्तेमाल करके पसंद के मुताबिक आइकॉन सेट करें. अगर iconView सेट है, तो एपीआई icon प्रॉपर्टी को अनदेखा कर देता है.

मार्कर की icon प्रॉपर्टी का इस्तेमाल करें

यह स्निपेट, icon प्रॉपर्टी में UIImage के तौर पर दिए गए कस्टम आइकॉन के साथ एक मार्कर बनाता है. यह आइकॉन लंदन के इंग्लैंड में है. स्निपेट मानता है कि आपके ऐप्लिकेशन में "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
      

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
    })
  }
}
      

@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 पूरी तरह से ओपेक है.

marker.opacity = 0.6
      

marker.opacity = 0.6;
      

GMSMarkerLayer का इस्तेमाल करके, [Coreऐनिमेशन]कोर ऐनिमेशन के साथ मार्कर की ओपैसिटी को ऐनिमेट किया जा सकता है.

मार्कर को फ़्लैट करना

मार्कर आइकॉन आम तौर पर मैप की सतह के बजाय डिवाइस की स्क्रीन के हिसाब से बनाए जाते हैं, इसलिए ज़रूरी नहीं है कि मैप को घुमाने, झुकाने या ज़ूम करने से मार्कर की दिशा बदल जाए.

आप मार्कर के ओरिएंटेशन को पृथ्वी के सामने सपाट होने के लिए सेट कर सकते हैं. मैप घुमाए जाने पर, फ़्लैट मार्कर घुमते हैं और मैप को झुकाने पर ऐंगल बदल जाते हैं. नियमित मार्कर की तरह, मैप को ज़ूम इन या ज़ूम आउट करने पर सपाट मार्कर अपना आकार बनाए रखते हैं.

मार्कर का ओरिएंटेशन बदलने के लिए, मार्कर की flat प्रॉपर्टी को YES या true पर सेट करें.

let positionLondon = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127)
let londonMarker = GMSMarker(position: positionLondon)
londonMarker.isFlat = true
londonMarker.map = mapView
      

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
      

CLLocationDegrees degrees = 90;
londonMarker.groundAnchor = CGPointMake(0.5, 0.5);
londonMarker.rotation = degrees;
londonMarker.map = mapView;
      

मार्कर पर इवेंट मैनेज करना

मैप पर होने वाले इवेंट सुने जा सकते हैं, जैसे कि जब कोई उपयोगकर्ता किसी मार्कर पर टैप करता है. इवेंट सुनने के लिए, आपको GMSMapViewDelegate प्रोटोकॉल लागू करना होगा. किसी खास मार्कर इवेंट को मैनेज करने का तरीका जानने के लिए, मार्कर इवेंट और हाथ के जेस्चर देखें. इवेंट के लिए गाइड में GMSMapViewDelegate पर तरीकों की सूची भी दी गई है. Street View इवेंट के लिए, GMSPanoramaViewDelegate देखें.