आकृतियां

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

iOS के लिए Maps SDK, आपको अपने मैप में अलग-अलग तरह के आकार जोड़ने की सुविधा देता है. इन शेप का इस्तेमाल किया जा सकता है:

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

हर शेप के दिखने के तरीके में कई तरह से बदलाव किया जा सकता है.

पॉलीलाइन

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

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

Swift

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)
      

Objective-C

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. मैप पर पॉलीलाइन दिखती है.

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

Swift

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
      

Objective-C

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 तरीके को कॉल करके, मैप पर मौजूद सभी ओवरले (पॉलीलाइन और अन्य आकृतियों के साथ) हटाए जा सकते हैं.

Swift

mapView.clear()
      

Objective-C

[mapView clear];
      

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

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

strokeWidth
स्क्रीन पॉइंट में, पूरी लाइन की चौड़ाई. डिफ़ॉल्ट वैल्यू 1 होती है. मैप को ज़ूम करने पर, चौड़ाई स्केल नहीं होती.
geodesic
YES होने पर, इस पॉलीलाइन के किनारे को जियोडेसिक के तौर पर रेंडर करें. जियोडेसिक सेगमेंट, धरती की सतह पर सबसे छोटे रास्ते को दिखाते हैं. साथ ही, मर्केटर प्रोजेक्शन वाले मैप पर, ये घुमावदार लाइनों के तौर पर दिख सकते हैं. नॉन-जियोडेसिक सेगमेंट, मैप पर सीधी लाइनों के तौर पर बनाए जाते हैं. डिफ़ॉल्ट रूप से, यह NO पर सेट होता है.
spans
इसका इस्तेमाल, पॉलीलाइन के एक या उससे ज़्यादा सेगमेंट का रंग तय करने के लिए किया जाता है. स्पैन प्रॉपर्टी, GMSStyleSpan ऑब्जेक्ट का एक कलेक्शन है. पॉलीलाइन का रंग बदलने के लिए, spans प्रॉपर्टी को सेट करना सबसे सही तरीका है.
strokeColor
UIColor ऑब्जेक्ट, जो पॉलीलाइन का रंग तय करता है. डिफ़ॉल्ट रूप से, यह blueColor पर सेट होता है. अगर spans सेट है, तो strokeColor प्रॉपर्टी को अनदेखा कर दिया जाता है.

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

Swift

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
      

Objective-C

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 ऑब्जेक्ट को दबाकर रखें.

Swift

polyline.strokeColor = .blue
      

Objective-C

polyline.strokeColor = [UIColor blueColor];
      

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

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

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

Swift

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

Objective-C

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

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

Swift

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

Objective-C

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

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

Swift

polyline.strokeColor = .red
      

Objective-C

polyline.strokeColor = [UIColor redColor];
      

स्टाइल

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

Swift

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

Objective-C

// 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 पर सेट करके, पूरी लाइन का रंग बदला जा सकता है. इस उदाहरण में, पॉलीलाइन की पूरी लंबाई में ग्रेडिएंट लागू करने का तरीका बताया गया है.

Swift

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

Objective-C

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

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

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

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

Swift

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

Objective-C

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

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

Swift

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

Objective-C

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

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

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

Swift

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

Objective-C

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 के तौर पर तय किया जाता है.

Swift

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

Objective-C

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 प्रॉपर्टी का इस्तेमाल करके, स्टैंप के तौर पर सेट करें.

Swift

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
      

Objective-C

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;

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 प्रॉपर्टी का इस्तेमाल करके, इसे स्टैंप के तौर पर सेट करें.

Swift

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
      

Objective-C

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 उपलब्ध हैं या नहीं. इस क्वेरी से यह तय होता है कि मैप व्यू, स्प्राइट स्टैंप वाली पॉलीलाइन के साथ काम करता है या नहीं.

Swift

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
      

Objective-C

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. मैप पर पॉलीगॉन दिखता है.

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

Swift

// 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
      

Objective-C

// 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 को उसके पैरंट से अलग करें.

Swift

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

Objective-C

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

सर्कल्स

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

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

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

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

सर्कल जोड़ना

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

Swift

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

Objective-C

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 होती है. मैप को ज़ूम करने पर, मोटाई का स्केल नहीं बदलता.

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

Swift

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

Objective-C

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

हॉलो पॉलीगॉन बनाना

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

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

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

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

Swift

let hydeParkLocation = CLLocationCoordinate2D(latitude: -33.87344, longitude: 151.21135)
let camera = GMSCameraPosition.camera(withTarget: hydeParkLocation, zoom: 16)
let options = GMSMapViewOptions()
options.camera = camera
let mapView = GMSMapView(options: options)
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
      

Objective-C

CLLocationCoordinate2D hydeParkLocation = CLLocationCoordinate2DMake(-33.87344, 151.21135);
GMSCameraPosition *camera = [GMSCameraPosition cameraWithTarget:hydeParkLocation
                                                           zoom:16];
GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = camera;
mapView = [[GMSMapView alloc] initWithOptions:options];

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;