शेप्स

iOS के लिए Maps SDK टूल में, आपको अपने मैप में आकार जोड़ने के कई तरीके मिलते हैं. निम्न आकार समर्थित हैं:

• पॉलीलाइन कनेक्टेड लाइन सेगमेंट की एक सीरीज़ होती है, जो आपकी पसंद का कोई भी आकार बना सकती है. साथ ही, इसका इस्तेमाल मैप पर पाथ और रास्तों को मार्क करने के लिए भी किया जा सकता है.
• पॉलीगॉन एक बंद आकार होता है जिसका इस्तेमाल मैप पर क्षेत्रों को चिह्नित करने के लिए किया जा सकता है.
• वृत्त, पृथ्वी की सतह पर वृत्त का भौगोलिक रूप से सटीक प्रोजेक्शन होता है.

आप हर आकार के रंग-रूप को कई तरीकों से बदल सकते हैं.

पॉलीलाइन

पॉलीलाइन की मदद से, मैप पर लाइनें बनाई जा सकती हैं. GMSPolyline ऑब्जेक्ट, जगहों का ऑर्डर किया हुआ क्रम दिखाता है. इसे लाइन सेगमेंट की सीरीज़ के तौर पर दिखाया जाता है. GMSStrokeStyle की मदद से, पॉलीलाइन का रंग सेट किया जा सकता है.

पॉलीलाइन बनाने के लिए, आपको दो या उससे ज़्यादा पॉइंट वाला मिलता-जुलता GMSMutablePath ऑब्जेक्ट बनाकर, इसका पाथ बताना होगा. हर CLLocationCoordinate2D, पृथ्वी की सतह पर एक बिंदु को दिखाता है. लाइन सेगमेंट, पॉइंट के बीच उसी क्रम में बनाए जाते हैं जिस क्रम में उन्हें पाथ में जोड़ा जाता है. addCoordinate: या addLatitude:longitude: तरीकों का इस्तेमाल करके, पाथ में पॉइंट जोड़े जा सकते हैं.

let path = GMSMutablePath()
path.add(CLLocationCoordinate2D(latitude: -33.85, longitude: 151.20))
path.add(CLLocationCoordinate2D(latitude: -33.70, longitude: 151.40))
path.add(CLLocationCoordinate2D(latitude: -33.73, longitude: 151.41))
let polyline = GMSPolyline(path: path)
      

GMSMutablePath *path = [GMSMutablePath path];
[path addCoordinate:CLLocationCoordinate2DMake(-33.85, 151.20)];
[path addCoordinate:CLLocationCoordinate2DMake(-33.70, 151.40)];
[path addCoordinate:CLLocationCoordinate2DMake(-33.73, 151.41)];
GMSPolyline *polyline = [GMSPolyline polylineWithPath:path];
      

पॉलीलाइन जोड़ना

1. कोई GMSMutablePath ऑब्जेक्ट बनाएं.
2. addCoordinate: या addLatitude:longitude: तरीकों का इस्तेमाल करके, पाथ में पॉइंट सेट करें.
3. आर्ग्युमेंट के तौर पर पाथ का इस्तेमाल करके, नया GMSPolyline ऑब्जेक्ट बनाएं.
4. ज़रूरत के हिसाब से strokeWidth और strokeColor जैसी अन्य प्रॉपर्टी सेट करें.
5. GMSPolyline की map प्रॉपर्टी सेट करें.
6. मैप पर पॉलीलाइन दिखने लगेगी.

यह कोड स्निपेट, मैप में एक रेक्टैंगल जोड़ता है:

let rectanglePath = GMSMutablePath()
rectanglePath.add(CLLocationCoordinate2D(latitude: 37.36, longitude: -122.0))
rectanglePath.add(CLLocationCoordinate2D(latitude: 37.45, longitude: -122.0))
rectanglePath.add(CLLocationCoordinate2D(latitude: 37.45, longitude: -122.2))
rectanglePath.add(CLLocationCoordinate2D(latitude: 37.36, longitude: -122.2))
rectanglePath.add(CLLocationCoordinate2D(latitude: 37.36, longitude: -122.0))

let rectangle = GMSPolyline(path: path)
rectangle.map = mapView
      

GMSMutablePath *rectanglePath = [GMSMutablePath path];
[rectanglePath addCoordinate:CLLocationCoordinate2DMake(37.36, -122.0)];
[rectanglePath addCoordinate:CLLocationCoordinate2DMake(37.45, -122.0)];
[rectanglePath addCoordinate:CLLocationCoordinate2DMake(37.45, -122.2)];
[rectanglePath addCoordinate:CLLocationCoordinate2DMake(37.36, -122.2)];
[rectanglePath addCoordinate:CLLocationCoordinate2DMake(37.36, -122.0)];

GMSPolyline *rectangle = [GMSPolyline polylineWithPath:path];
rectangle.map = mapView;
      

पॉलीलाइन हटाना

GMSPolyline की map प्रॉपर्टी को nil पर सेट करके, मैप से पॉलीलाइन हटाई जा सकती है. इसके अलावा, GMSMapView clear तरीके का इस्तेमाल करके मैप से सभी ओवरले (जैसे, पॉलीलाइन और अन्य आकार) हटाए जा सकते हैं.

mapView.clear()
      

[mapView clear];
      

पॉलीलाइन को पसंद के मुताबिक बनाना

GMSPolyline ऑब्जेक्ट, लाइन की स्टाइल को कंट्रोल करने के लिए कई प्रॉपर्टी उपलब्ध कराता है. इसमें इन विकल्पों का इस्तेमाल किया जा सकता है:

strokeWidth

स्क्रीन पॉइंट में पूरी लाइन की चौड़ाई. डिफ़ॉल्ट तौर पर, यह वैल्यू 1 पर सेट होती है. मैप को ज़ूम करने पर चौड़ाई नहीं घटती.

geodesic

YES होने पर, इस पॉलीलाइन किनारे को जियोडेसिक के तौर पर रेंडर करें. जियोडेसिक सेगमेंट पृथ्वी की सतह के सबसे छोटे रास्ते के साथ-साथ चलते हैं. ये मैप पर मर्केटर प्रोजेक्शन के साथ घुमावदार लाइनों की तरह दिख सकते हैं. मैप पर, नॉन-जियोडेसिक यानी बिना भौगोलिक स्थिति वाले सेगमेंट, सीधी रेखाओं में बनाए जाते हैं. डिफ़ॉल्ट तौर पर, यह NO पर सेट होती है.

spans

का इस्तेमाल, पॉलीलाइन के एक या उससे ज़्यादा सेगमेंट के रंग की जानकारी देने के लिए किया जाता है. स्पैन प्रॉपर्टी, GMSStyleSpan ऑब्जेक्ट का कलेक्शन होती है. spans प्रॉपर्टी को सेट करना, पॉलीलाइन का रंग बदलने का पसंदीदा तरीका है.

strokeColor

UIColor ऑब्जेक्ट, जो पॉलीलाइन के रंग के बारे में बताता है. डिफ़ॉल्ट तौर पर, यह blueColor पर सेट होती है. अगर spans सेट है, तो strokeColor प्रॉपर्टी को अनदेखा किया जाता है.

नीचे दिया गया स्निपेट जियोडेसिक इंटरपोलेशन के साथ मेलबर्न से पर्थ तक एक मोटी पॉलीलाइन जोड़ता है.

let path = GMSMutablePath()
path.addLatitude(-37.81319, longitude: 144.96298)
path.addLatitude(-31.95285, longitude: 115.85734)
let polyline = GMSPolyline(path: path)
polyline.strokeWidth = 10.0
polyline.geodesic = true
polyline.map = mapView
      

GMSMutablePath *path = [GMSMutablePath path];
[path addLatitude:-37.81319 longitude:144.96298];
[path addLatitude:-31.95285 longitude:115.85734];
GMSPolyline *polyline = [GMSPolyline polylineWithPath:path];
polyline.strokeWidth = 10.f;
polyline.geodesic = YES;
polyline.map = mapView;
      

मैप में जोड़ने के बाद पॉलीलाइन में बदलाव करने के लिए, GMSPolyline ऑब्जेक्ट को दबाकर रखें.

polyline.strokeColor = .blue
      

polyline.strokeColor = [UIColor blueColor];
      

पॉलीलाइन का रंग बदलना

मैप पर अलग-अलग सेगमेंट की सीरीज़ के तौर पर पॉलीलाइन बनाई जाती हैं. spans प्रॉपर्टी की मदद से, अलग-अलग सेगमेंट या पूरी लाइन का रंग बदला जा सकता है. इस प्रॉपर्टी से आपको पॉलीलाइन के कलर पर पूरा कंट्रोल मिलता है. हालांकि, इसमें ऐसी कई सुविधाएं भी हैं जिनकी मदद से पूरी लाइन पर एक ही स्टाइल लागू किया जा सकता है.

नीचे दिया गया स्निपेट पूरी लाइन का रंग बदलकर लाल करने के लिए, spanWithColor: तरीके का इस्तेमाल करता है.

polyline.spans = [GMSStyleSpan(color: .red)]
      

polyline.spans = @[[GMSStyleSpan spanWithColor:[UIColor redColor]]];
      

इसके अलावा, अगर आपके पास पहले से ही GMSStrokeStyle ऑब्जेक्ट का ऐक्सेस है, तो spanWithStyle: तरीके का इस्तेमाल किया जा सकता है.

let solidRed = GMSStrokeStyle.solidColor(.red)
polyline.spans = [GMSStyleSpan(style: solidRed)]
      

GMSStrokeStyle *solidRed = [GMSStrokeStyle solidColor:[UIColor redColor]];
polyline.spans = @[[GMSStyleSpan spanWithStyle:solidRed]];
      

iOS के लिए Maps SDK के वर्शन 1.7 से पहले, सिर्फ़ एक प्रॉपर्टी strokeColor ही GMSPolyline के पूरे कलर को सेट करने के लिए उपलब्ध थी. spans प्रॉपर्टी को strokeColor प्रॉपर्टी के मुकाबले प्राथमिकता दी जाती है.

polyline.strokeColor = .red
      

polyline.strokeColor = [UIColor redColor];
      

स्टाइल

अगर आपके ऐप्लिकेशन में एक ही स्ट्रोक के रंग को कई बार लागू किया जाता है, तो आपको फिर से इस्तेमाल की जा सकने वाली स्टाइल तय करने में मदद मिल सकती है. पॉलीलाइन स्टाइल की जानकारी, GMSStrokeStyle ऑब्जेक्ट का इस्तेमाल करके दी जाती है. स्ट्रोक शैली में गहरा रंग हो सकता है या एक रंग से दूसरे रंग का ग्रेडिएंट हो सकता है. स्टाइल बनाने के बाद, उसे spanWithStyle: तरीके का इस्तेमाल करके GMSStyleSpan पर लागू किया जा सकता है.

// Create two styles: one that is solid blue, and one that is a gradient from red to yellow
let solidBlue = GMSStrokeStyle.solidColor(.blue)
let solidBlueSpan = GMSStyleSpan(style: solidBlue)
let redYellow = GMSStrokeStyle.gradient(from: .red, to: .yellow)
let redYellowSpan = GMSStyleSpan(style: redYellow)
      

// Create two styles: one that is solid blue, and one that is a gradient from red to yellow
GMSStrokeStyle *solidBlue = [GMSStrokeStyle solidColor:[UIColor blueColor]];
GMSStyleSpan *solidBlueSpan = [GMSStyleSpan spanWithStyle:solidBlue];
GMSStrokeStyle *redYellow =
    [GMSStrokeStyle gradientFromColor:[UIColor redColor] toColor:[UIColor yellowColor]];
GMSStyleSpan *redYellowSpan = [GMSStyleSpan spanWithStyle:redYellow];
      

span की स्टाइल, पॉलीलाइन के आखिर तक या नई स्टाइल सेट होने तक जारी रहेगी. पॉलीलाइन की spans प्रॉपर्टी को एक GMSStyleSpan पर सेट करके, पूरी लाइन का रंग बदला जा सकता है. इस उदाहरण में, पॉलीलाइन की पूरी लंबाई पर ग्रेडिएंट लागू करने का तरीका बताया गया है.

polyline.spans = [GMSStyleSpan(style: redYellow)]
      

polyline.spans = @[[GMSStyleSpan spanWithStyle:redYellow]];
      

अलग-अलग लाइन सेगमेंट का रंग बदलना

अगर आपको पॉलीलाइन के हर सेगमेंट को अलग-अलग स्टाइल करना है, तो GMSStyleSpan ऑब्जेक्ट का कलेक्शन बनाएं और इसे spans प्रॉपर्टी में पास करें. डिफ़ॉल्ट रूप से, अरे में मौजूद हर आइटम, उससे जुड़े लाइन सेगमेंट का रंग सेट करता है. अगर अरे में, लाइन में मौजूद सेगमेंट की तुलना में ज़्यादा एलिमेंट हैं, तो अतिरिक्त एलिमेंट को अनदेखा कर दिया जाएगा. अगर अरे में कम एलिमेंट हैं, तो फ़ाइनल GMSStyleSpan, बाकी लाइन के रंग के बारे में बताता है.

अपनी पॉलीलाइन के साथ ऊंचाई या गति जैसे बदलावों को दिखाने के लिए, कलर और/या ग्रेडिएंट पॉलीलाइन के ब्लॉक का इस्तेमाल किया जा सकता है. नीचे दिया गया स्निपेट पॉलीलाइन के पहले दो सेगमेंट का रंग लाल पर सेट करता है और बाकी की लाइन लाल से पीले रंग में धीरे-धीरे सेट होती है.

polyline.spans = [
  GMSStyleSpan(style: solidRed),
  GMSStyleSpan(style: solidRed),
  GMSStyleSpan(style: redYellow)
]
      

polyline.spans = @[[GMSStyleSpan spanWithStyle:solidRed],
                   [GMSStyleSpan spanWithStyle:solidRed],
                   [GMSStyleSpan spanWithStyle:redYellow]];
      

एक साथ कई सेगमेंट की स्टाइल सेट करने के लिए, spanWithStyle:segments: तरीके का इस्तेमाल किया जा सकता है. उदाहरण के लिए, यह कोड ऊपर दिए गए कोड के बराबर है. आखिरी GMSStyleSpan के सेगमेंट की लंबाई को हमेशा अनदेखा किया जाता है, क्योंकि स्टाइल का इस्तेमाल लाइन के बाकी हिस्से के बारे में बताने के लिए किया जाता है.

polyline.spans = [
  GMSStyleSpan(style: solidRed, segments:2),
  GMSStyleSpan(style: redYellow, segments:10)
]
      

polyline.spans = @[[GMSStyleSpan spanWithStyle:solidRed segments:2],
                   [GMSStyleSpan spanWithStyle:redYellow segments:10]];
      

फ़्रैक्शनल सेगमेंट

खंडों को भिन्नात्मक मान के रूप में भी दर्ज किया जा सकता है. इससे स्टाइल, सेगमेंट के फ़्रैक्शनल नंबर पर लागू हो जाएगी. इससे एक सेगमेंट बंटा होगा. हर GMSStyleSpan, पिछले सेगमेंट के तुरंत बाद शुरू हो जाता है: नीचे दिए गए उदाहरण में, स्लेटी रंग 1⁄2 से दूसरे सेगमेंट से शुरू होता है और तीसरे सेगमेंट से 1⁄2 तक जारी रहता है.

polyline.spans = [
  GMSStyleSpan(style: solidRed, segments: 2.5),
  GMSStyleSpan(color: .gray),
  GMSStyleSpan(color: .purple, segments: 0.75),
  GMSStyleSpan(style: redYellow)
]
      

polyline.spans = @[[GMSStyleSpan spanWithStyle:solidRed segments:2.5],
                   [GMSStyleSpan spanWithColor:[UIColor grayColor]],
                   [GMSStyleSpan spanWithColor:[UIColor purpleColor] segments:0.75],
                   [GMSStyleSpan spanWithStyle:redYellow]];
      

पॉलीलाइन में दोहराए जाने वाले रंग का पैटर्न जोड़ना

अगर आपको पॉलीलाइन पर कोई पैटर्न जोड़ना है, तो GMSGeometryUtils में GMSStyleSpans सुविधा का इस्तेमाल करें. GMSStyleSpans वाले तरीके में, दोहराए जाने वाले पैटर्न को तय करने वाले दो कलेक्शन स्वीकार किए जाते हैं. एक अरे उन स्टाइल को सेट करता है जिन्हें दोहराया जाना चाहिए और दूसरी अरे दोहराव के इंटरवल के बारे में बताती है. साथ में इस्तेमाल करके, ऐसा पैटर्न बनाया जा सकता है जिसे किसी भी पॉलीलाइन पर लगाया जा सकता है. भले ही, उसकी लंबाई या कितने भी सेगमेंट उपलब्ध हों.

उदाहरण के लिए, नीचे दिया गया कोड स्निपेट एक पॉलीलाइन को काले और सफ़ेद वैकल्पिक पैटर्न के साथ परिभाषित करता है. इसकी लंबाई को रब लाइन के साथ मीटर के रूप में दिखाया जाता है (मर्केटर में, यह एक सीधी लाइन होती है). इसकी वजह यह है कि इस तरह के टाइप को kGMSLengthRhumb बताया गया है.

let styles = [
  GMSStrokeStyle.solidColor(.white),
  GMSStrokeStyle.solidColor(.black)
]
let lengths: [NSNumber] = [100000, 50000]
polyline.spans = GMSStyleSpans(
  polyline.path!,
  styles,
  lengths,
  GMSLengthKind.rhumb
)
      

NSArray *styles = @[[GMSStrokeStyle solidColor:[UIColor whiteColor]],
                    [GMSStrokeStyle solidColor:[UIColor blackColor]]];
NSArray *lengths = @[@100000, @50000];
polyline.spans = GMSStyleSpans(polyline.path, styles, lengths, kGMSLengthRhumb);
      

स्प्राइट स्टैंपेड पॉलीलाइन

स्प्राइट स्टैंपेड पॉलीलाइन की मदद से, अपनी पसंद के दोहराए जाने वाले बिटमैप इमेज का इस्तेमाल करके, पॉलीलाइन बनाई जा सकती है. शेप को बैकग्राउंड में साफ़ तौर पर स्ट्रोक के साथ दिखाया जाता है, लेकिन स्टैंप के चारों ओर लाइन के कोनों के हिसाब से काट-छांट नहीं की जाती है. इससे, पैदल चलने के दिशा-निर्देशों को समझाने में मदद करने वाले डॉट जैसी स्थितियों के लिए, इन्हें इस्तेमाल करने में मदद मिलती है.

इस सुविधा का इस्तेमाल करने के लिए, GMSSpriteStyle का इस्तेमाल करें और GMSStrokeStyle की stampStyle प्रॉपर्टी का इस्तेमाल करके, इसे स्टैंप के तौर पर सेट करें.

let path = GMSMutablePath()
path.addLatitude(-37.81319, longitude: 144.96298)
path.addLatitude(-31.95285, longitude: 115.85734)
let polyline = GMSPolyline(path: path)
polyline.strokeWidth = 20
let image = UIImage(named: "imageFromBundleOrAsset")! // Image could be from anywhere
let stampStyle = GMSSpriteStyle(image: image)
let transparentStampStroke = GMSStrokeStyle.transparentStroke(withStamp: stampStyle)
let span = GMSStyleSpan(style: transparentStampStroke)
polyline.spans = [span]
polyline.map = mapView
      

GMSMutablePath *path = [GMSMutablePath path];
[path addLatitude:-37.81319 longitude:144.96298];
[path addLatitude:-31.95285 longitude:115.85734];
polyline.strokeWidth = 20;
GMSPolyline *polyline = [GMSPolyline polylineWithPath:path];

UIImage *image = [UIImage imageNamed:@"imageFromBundleOrAsset"];
GMSStrokeStyle *transparentStampStroke = [GMSStrokeStyle transparentStrokeWithStampStyle:[GMSSpriteStyle spriteStyleWithImage:image]];

GMSStyleSpan *span = [GMSStyleSpan spanWithStyle:transparentStampStroke];
polyline.spans = @[span];
polyline.map = _mapView;
      

टेक्सचर स्टैंप्ड पॉलीलाइन

टेक्सचर स्टैंप वाली पॉलीलाइन से, अपनी पसंद की दोहराई गई टेक्सचर का इस्तेमाल करके पॉलीलाइन बनाई जा सकती है. आकृतियों को साफ़, ठोस रंग या ग्रेडिएंट बैकग्राउंड स्ट्रोक के साथ दिखाया जा सकता है. ज़ूम लेवल बदलने पर, टेक्सचर का साइज़ भी बदल जाता है. कुछ ज़ूम लेवल पर, पाथ के आखिर या शुरुआत की इमेज या पाथ पॉइंट में काट-छांट की जाती है.

इस सुविधा का इस्तेमाल करने के लिए, GMSTextureStyle का इस्तेमाल करें और GMSStrokeStyle की stampStyle प्रॉपर्टी का इस्तेमाल करके, इसे स्टैंप के तौर पर सेट करें.

let path = GMSMutablePath()
path.addLatitude(-37.81319, longitude: 144.96298)
path.addLatitude(-31.95285, longitude: 115.85734)
let polyline = GMSPolyline(path: path)
polyline.strokeWidth = 20
let redWithStamp = GMSStrokeStyle.solidColor(.red)
let image = UIImage(named: "imageFromBundleOrAsset")! // Image could be from anywhere
redWithStamp.stampStyle = GMSTextureStyle(image: image)
let span = GMSStyleSpan(style: redWithStamp)
polyline.spans = [span]
polyline.map = mapView
      

GMSMutablePath *path = [GMSMutablePath path];
[path addLatitude:-37.81319 longitude:144.96298];
[path addLatitude:-31.95285 longitude:115.85734];
GMSPolyline *polyline = [GMSPolyline polylineWithPath:path];
polyline.strokeWidth = 20;
GMSStrokeStyle *redWithStamp = [GMSStrokeStyle solidColor:[UIColor redColor]];

UIImage *image = [UIImage imageNamed:@"imageFromBundleOrAsset"]; // Image could be from anywhere
redWithStamp.stampStyle = [GMSTextureStyle textureStyleWithImage:image];

GMSStyleSpan *span = [GMSStyleSpan spanWithStyle:redWithStamp];
polyline.spans = @[span];
polyline.map = _mapView;
      

मैप की क्षमताएं

GMSMapView पर मौजूद mapCapabilities प्रॉपर्टी, मैप से जुड़ी खास सुविधाओं के लिए प्रोग्राम की मदद से जांच करने की सुविधा जोड़ती है. यह तब काम आता है, जब किसी एपीआई को कॉल करने से पहले यह जानना हो कि कुछ मैप capabilities उपलब्ध हैं या नहीं. इस क्वेरी से यह तय होता है कि मैप व्यू, स्प्राइट स्टैंपेड पॉलीलाइन के साथ काम करता है या नहीं.

let path = GMSMutablePath()
path.addLatitude(-37.81319, longitude: 144.96298)
path.addLatitude(-31.95285, longitude: 115.85734)
let polyline = GMSPolyline(path: path)
polyline.strokeWidth = 20
let image = UIImage(named: "imageFromBundleOrAsset")! // Image could be from anywhere
let spans: [GMSStyleSpan]
if (mapView.mapCapabilities.contains(.spritePolylines)) {
  let spriteStyle = GMSSpriteStyle(image: image)
  let stroke = GMSStrokeStyle.transparentStroke(withStamp: spriteStyle)
  spans = [ GMSStyleSpan(style: stroke) ]
} else {
  let stroke = GMSStrokeStyle.solidColor(.clear)
  stroke.stampStyle = GMSTextureStyle(image: image)
  spans = [ GMSStyleSpan(style: stroke) ]
}
polyline.spans = spans
polyline.map = mapView
      

GMSMutablePath *path = [GMSMutablePath path];
[path addLatitude:-37.81319 longitude:144.96298];
[path addLatitude:-31.95285 longitude:115.85734];

UIImage *_Nonnull image = [UIImage imageNamed:@"imageFromBundleOrAsset"]; // Image could be from anywhere

NSArray<GMSStyleSpan *> * spans;
if (_mapView.mapCapabilities & GMSMapCapabilityFlagsSpritePolylines) {
  GMSSpriteStyle *spriteStyle = [GMSSpriteStyle spriteStyleWithImage:image];
  GMSStrokeStyle *stroke = [GMSStrokeStyle transparentStrokeWithStampStyle:spriteStyle];
  spans = @[ [GMSStyleSpan spanWithStyle:stroke] ];
} else {
  GMSStrokeStyle *stroke = [GMSStrokeStyle solidColor:UIColor.clearColor];
  stroke.stampStyle = [GMSTextureStyle textureStyleWithImage:image];
  spans = @[ [GMSStyleSpan spanWithStyle:stroke] ];
}

GMSPolyline *polyline = [GMSPolyline polylineWithPath:path];
polyline.strokeWidth = 20;
polyline.spans = spans;
polyline.map = _mapView;
      

इस पैटर्न की मदद से, बदलावों के लिए सदस्यता ली जा सकती है. साथ ही, मैप व्यू की स्थिति के हिसाब से, अपडेट पर प्रतिक्रिया दी जा सकती है. सुविधा की उपलब्धता के बारे में अपडेट पाने के लिए, GMSMapViewDelegate को didChangeMapCapabilities भी लागू किया जा सकता है.

पॉलीगॉन

पॉलीगॉन, पॉलीलाइन की तरह होते हैं. इनमें कई निर्देशांक होते हैं, जो किसी क्रम में होते हैं. हालांकि, ओपन-एंडेड होने के बजाय, पॉलीगॉन किसी क्लोज़्ड लूप के अंदर ठोस क्षेत्रों को परिभाषित करने के लिए डिज़ाइन किए जाते हैं. iOS के लिए, Maps SDK टूल में पॉलीगॉन को GMSPolygon क्लास के हिसाब से तय किया जाता है.

मैप में GMSPolygon को ठीक वैसे ही जोड़ा जा सकता है जैसे GMSPolyline को जोड़ा जाता है. सबसे पहले, इससे मिलता-जुलता GMSMutablePath ऑब्जेक्ट बनाकर और उसमें पॉइंट जोड़कर, इसके पाथ की जानकारी दें. ये बिंदु पॉलीगॉन की आउटलाइन बनाते हैं. हर CLLocationCoordinate2D, पृथ्वी की सतह पर एक बिंदु को दिखाता है. लाइन सेगमेंट, पॉइंट के बीच उसी क्रम में बनाए जाते हैं जिस क्रम में उन्हें पाथ में जोड़ा जाता है.

कोई पॉलीगॉन जोड़ें

1. कोई GMSMutablePath ऑब्जेक्ट बनाएं.
2. addCoordinate: या addLatitude:longitude: तरीकों का इस्तेमाल करके, पाथ में पॉइंट सेट करें. ये बिंदु पॉलीगॉन की आउटलाइन बनाते हैं.
3. आर्ग्युमेंट के तौर पर पाथ का इस्तेमाल करके, नया GMSPolygon ऑब्जेक्ट बनाएं.
4. अपने हिसाब से, strokeWidth, strokeColor, और fillColor जैसी अन्य प्रॉपर्टी सेट करें.
5. GMSPolygon.map प्रॉपर्टी सेट करके, पॉलीगॉन को GMSMapView ऑब्जेक्ट को असाइन करें.
6. पॉलीगॉन मैप पर दिखाई देता है.

नीचे दिया गया कोड स्निपेट, मैप में एक रेक्टैंगल जोड़ता है.

// Create a rectangular path
let rect = GMSMutablePath()
rect.add(CLLocationCoordinate2D(latitude: 37.36, longitude: -122.0))
rect.add(CLLocationCoordinate2D(latitude: 37.45, longitude: -122.0))
rect.add(CLLocationCoordinate2D(latitude: 37.45, longitude: -122.2))
rect.add(CLLocationCoordinate2D(latitude: 37.36, longitude: -122.2))

// Create the polygon, and assign it to the map.
let polygon = GMSPolygon(path: rect)
polygon.fillColor = UIColor(red: 0.25, green: 0, blue: 0, alpha: 0.05);
polygon.strokeColor = .black
polygon.strokeWidth = 2
polygon.map = mapView
      

// Create a rectangular path
GMSMutablePath *rect = [GMSMutablePath path];
[rect addCoordinate:CLLocationCoordinate2DMake(37.36, -122.0)];
[rect addCoordinate:CLLocationCoordinate2DMake(37.45, -122.0)];
[rect addCoordinate:CLLocationCoordinate2DMake(37.45, -122.2)];
[rect addCoordinate:CLLocationCoordinate2DMake(37.36, -122.2)];

// Create the polygon, and assign it to the map.
GMSPolygon *polygon = [GMSPolygon polygonWithPath:rect];
polygon.fillColor = [UIColor colorWithRed:0.25 green:0 blue:0 alpha:0.05];
polygon.strokeColor = [UIColor blackColor];
polygon.strokeWidth = 2;
polygon.map = mapView;
      

पॉलीगॉन को मैप पर जोड़ने से पहले और मैप में जोड़ने के बाद, दोनों ही तरीकों से उसकी स्टाइल को पसंद के मुताबिक बनाया जा सकता है.

पॉलीगॉन हटाना

किसी पॉलीगॉन की GMSPolygon.map प्रॉपर्टी को nil पर सेट करें और layer को उसके पैरंट से अलग करें.

 polygon.map = nil
 polygon.layer.removeFromSuperLayer()

 polygon.map = nil;
 [polygon.layer removeFromSuperlayer];
 

सर्कल्स

जेनरिक GMSPolygon क्लास के अलावा, iOS के लिए Maps के SDK टूल में GMSCircle भी शामिल है. इससे पृथ्वी की सतह पर सर्कल बनाए जा सकते हैं.

एक सर्कल बनाने के लिए, आपको नीचे दी गई दो प्रॉपर्टी देनी होगी:

• CLLocationCoordinate2D के तौर पर position.
• मीटर में radius.

इसके बाद, सर्कल को पृथ्वी की सतह पर मौजूद सभी बिंदुओं का सेट माना जाता है, जो दिए गए center से radius मीटर की दूरी पर है. Maps API में इस्तेमाल किए जाने वाले मर्केटर प्रोजेक्शन से सपाट सतह पर स्केयर कैसे रेंडर होता है. जब यह भूमध्य रेखा के पास होता है, तो मैप पर यह बिलकुल सटीक वृत्त के तौर पर दिखता है. यह वृत्त भूमध्य रेखा से दूर जाने पर तेज़ी से गैर-गोलाकार (स्क्रीन पर) दिखता है.

एक मंडली जोड़ना

नीचे दिया गया कोड स्निपेट, मैप पर एक सर्कल जोड़ता है:

let circleCenter = CLLocationCoordinate2D(latitude: 37.35, longitude: -122.0)
let circle = GMSCircle(position: circleCenter, radius: 1000)
circle.map = mapView
      

CLLocationCoordinate2D circleCenter = CLLocationCoordinate2DMake(37.35, -122.0);
GMSCircle *circle = [GMSCircle circleWithPosition:circleCenter
                                         radius:1000];
circle.map = mapView;
      

सर्कल को मैप पर जोड़ने से पहले और मैप पर जोड़ने के बाद, दोनों ही स्थितियों में, अपनी पसंद के मुताबिक रंग-रूप चुना जा सकता है.

मंडली कस्टमाइज़ करना

GMSCircle की प्रॉपर्टी में बदलाव करके, पसंद के मुताबिक रंग और स्ट्रोक की चौड़ाई तय की जा सकती है. इसमें इन विकल्पों का इस्तेमाल किया जा सकता है:

fillColor

एक UIColor ऑब्जेक्ट, जो सर्कल के अंदर के रंग को बताता है. डिफ़ॉल्ट रूप से, इसे पारदर्शी के तौर पर सेट किया जाता है.

strokeColor

एक UIColor ऑब्जेक्ट, जो सर्कल की आउटलाइन का रंग बताता है. डिफ़ॉल्ट तौर पर, यह blackColor पर सेट होती है.

strokeWidth

स्क्रीन पॉइंट में, सर्कल की आउटलाइन की मोटाई. डिफ़ॉल्ट तौर पर, यह वैल्यू 1 पर सेट होती है. मैप ज़ूम किए जाने पर मोटाई नहीं मापी जाती.

नीचे दिया गया स्निपेट आधा-पारदर्शी लाल रंग के अंदरूनी हिस्से के साथ एक मोटा लाल गोला जोड़ता है.

circle.fillColor = UIColor(red: 0.35, green: 0, blue: 0, alpha: 0.05)
circle.strokeColor = .red
circle.strokeWidth = 5
      

circle.fillColor = [UIColor colorWithRed:0.25 green:0 blue:0 alpha:0.05];
circle.strokeColor = [UIColor redColor];
circle.strokeWidth = 5;
      

खोखला बहुभुज बनाना

किसी एक GMSPolygon ऑब्जेक्ट में कई पाथ को जोड़ा जा सकता है. इससे, भरे हुए सर्कल या डोनट जैसे कॉम्प्लेक्स शेप बनाए जा सकते हैं. पॉलीगॉन के अंदर, अलग-अलग शेप दिख सकते हैं. जटिल आकार कई पाथ से मिलकर बने होते हैं.

ऐसे पाथ वाला पॉलीगॉन बनाएं जो पॉलीगॉन से कवर किए गए सबसे बड़े क्षेत्रफल के बारे में बताता हो. इसके बाद, पॉलीगॉन की holes प्रॉपर्टी को एक या उससे ज़्यादा GMSPath ऑब्जेक्ट के कलेक्शन के तौर पर बताएं. इससे पॉलीगॉन में छेदों के बारे में पता चलता है.

यदि एक छोटे पथ को पूरी तरह से बड़े पथ के साथ बंद किया गया है, तो ऐसा लगता है जैसे पॉलीगॉन का कोई टुकड़ा हटा दिया गया है.

नीचे दिया गया कोड सैंपल, दो छेदों वाला पॉलीगॉन बनाता है:

let hydeParkLocation = CLLocationCoordinate2D(latitude: -33.87344, longitude: 151.21135)
let camera = GMSCameraPosition.camera(withTarget: hydeParkLocation, zoom: 16)
let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
mapView.animate(to: camera)

let hydePark = "tpwmEkd|y[QVe@Pk@BsHe@mGc@iNaAKMaBIYIq@qAMo@Eo@@[Fe@DoALu@HUb@c@XUZS^ELGxOhAd@@ZB`@J^BhFRlBN\\BZ@`AFrATAJAR?rAE\\C~BIpD"
let archibaldFountain = "tlvmEqq|y[NNCXSJQOB[TI"
let reflectionPool = "bewmEwk|y[Dm@zAPEj@{AO"

let hollowPolygon = GMSPolygon()
hollowPolygon.path = GMSPath(fromEncodedPath: hydePark)
hollowPolygon.holes = [GMSPath(fromEncodedPath: archibaldFountain)!, GMSPath(fromEncodedPath: reflectionPool)!]
hollowPolygon.fillColor = UIColor(red: 1.0, green: 0.0, blue: 0.0, alpha: 0.2)
hollowPolygon.strokeColor = UIColor(red: 1.0, green: 0.0, blue: 0.0, alpha: 1.0)
hollowPolygon.strokeWidth = 2
hollowPolygon.map = mapView
      

CLLocationCoordinate2D hydeParkLocation = CLLocationCoordinate2DMake(-33.87344, 151.21135);
GMSCameraPosition *camera = [GMSCameraPosition cameraWithTarget:hydeParkLocation
                                                           zoom:16];
mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];

NSString *hydePark = @"tpwmEkd|y[QVe@Pk@BsHe@mGc@iNaAKMaBIYIq@qAMo@Eo@@[Fe@DoALu@HUb@c@XUZS^ELGxOhAd@@ZB`@J^BhFRlBN\\BZ@`AFrATAJAR?rAE\\C~BIpD";
NSString *archibaldFountain = @"tlvmEqq|y[NNCXSJQOB[TI";
NSString *reflectionPool = @"bewmEwk|y[Dm@zAPEj@{AO";

GMSPolygon *hollowPolygon = [[GMSPolygon alloc] init];
hollowPolygon.path = [GMSPath pathFromEncodedPath:hydePark];
hollowPolygon.holes = @[[GMSPath pathFromEncodedPath:archibaldFountain],
                  [GMSPath pathFromEncodedPath:reflectionPool]];
hollowPolygon.fillColor = [UIColor colorWithRed:1.0 green:0.0 blue:0.0 alpha:0.2];
hollowPolygon.strokeColor = [UIColor colorWithRed:1.0 green:0.0 blue:0.0 alpha:1.0];
hollowPolygon.strokeWidth = 2;
hollowPolygon.map = mapView;