รูปทรง

เลือกแพลตฟอร์ม: Android iOS JavaScript

Maps SDK สำหรับ iOS มีวิธีต่างๆ ในการเพิ่มรูปร่างลงในแผนที่ ระบบรองรับรูปร่างต่อไปนี้

  • เส้นประกอบคือชุดของส่วนของเส้นตรงที่เชื่อมต่อกันซึ่งสามารถสร้างเป็นรูปร่างใดก็ได้ตามต้องการ และใช้เพื่อทำเครื่องหมายเส้นทางและเส้นทางบนแผนที่ได้
  • รูปหลายเหลี่ยมคือรูปร่างปิดที่ใช้ทำเครื่องหมายพื้นที่บนแผนที่ได้
  • วงกลมคือการฉายภาพวงกลมที่ถูกต้องตามภูมิศาสตร์บนพื้นผิวโลก

คุณสามารถปรับเปลี่ยนลักษณะที่ปรากฏของแต่ละรูปร่างได้หลายวิธี

เส้นประกอบ

เส้นประกอบช่วยให้คุณวาดเส้นบนแผนที่ได้ ออบเจ็กต์ GMSPolyline แสดงลำดับของสถานที่ที่เรียงลำดับแล้ว โดยแสดงเป็นชุดของส่วนของเส้นตรง คุณตั้งค่าสีของเส้นประกอบได้ด้วย GMSStrokeStyle

หากต้องการสร้างเส้นประกอบ คุณจะต้องระบุเส้นทางโดยสร้างออบเจ็กต์ GMSMutablePath ที่สอดคล้องกันซึ่งมีจุดอย่างน้อย 2 จุด 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. ตั้งค่าพร็อพเพอร์ตี้ map ของ GMSPolyline
  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;

เส้นประกอบสี่เหลี่ยมผืนผ้า

การนำเส้นประกอบออก

คุณนำเส้นประกอบออกจากแผนที่ได้โดยตั้งค่าพร็อพเพอร์ตี้ map ของ GMSPolyline เป็น nil หรือจะนำการวางซ้อนทั้งหมด (รวมถึงเส้นประกอบและรูปร่างอื่นๆ) บนแผนที่ออกโดยเรียกใช้เมธอด GMSMapView clear ก็ได้

Swift

mapView.clear()

Objective-C

[mapView clear];

การปรับแต่งเส้นประกอบ

ออบเจ็กต์ GMSPolyline มีพร็อพเพอร์ตี้หลายรายการเพื่อควบคุมลักษณะที่ปรากฏของเส้น โดยรองรับตัวเลือกต่อไปนี้

strokeWidth
ความกว้างของทั้งเส้นในหน่วยจุดบนหน้าจอ ค่าเริ่มต้นคือ 1 ความกว้างจะไม่ปรับขนาดเมื่อซูมแผนที่
geodesic
เมื่อ YES ให้แสดงผลขอบเส้นประกอบนี้เป็นเส้นจีโอเดสิก ส่วน Geodesic จะเป็นไปตามเส้นทางที่สั้นที่สุดตามพื้นผิวโลก และอาจปรากฏเป็นเส้นโค้งบนแผนที่ที่มีการฉายภาพแบบเมอร์เคเตอร์ ส่วนที่ไม่ใช่เส้นโค้งจะวาดเป็นเส้นตรงบนแผนที่ ค่าเริ่มต้นคือ NO
spans
ใช้เพื่อระบุสีของส่วนอย่างน้อย 1 ส่วนของเส้นประกอบ พร็อพเพอร์ตี้ spans เป็นอาร์เรย์ของออบเจ็กต์ GMSStyleSpan การตั้งค่าพร็อพเพอร์ตี้ spans เป็นวิธีที่แนะนำในการเปลี่ยนสีของเส้นประกอบ
strokeColor
ออบเจ็กต์ UIColor ที่ระบุสีของเส้นประกอบ ค่าเริ่มต้นคือ blueColor ระบบจะไม่สนใจพร็อพเพอร์ตี้ strokeColor หากตั้งค่า spans ไว้

ข้อมูลโค้ดต่อไปนี้จะเพิ่มเส้นประกอบหนาจากเมลเบิร์นไปยังเพิร์ท โดยมีการประมาณค่าในช่วงทางภูมิศาสตร์

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]];

ก่อน Maps SDK สำหรับ iOS เวอร์ชัน 1.7 พร็อพเพอร์ตี้ strokeColor เดียวจะพร้อมใช้งานเพื่อตั้งค่าสีทั้งหมดของ GMSPolyline พร็อพเพอร์ตี้ spans จะมีความสำคัญเหนือ strokeColor

Swift

polyline.strokeColor = .red

Objective-C

polyline.strokeColor = [UIColor redColor];

รูปแบบ

หากแอปใช้สีเส้นเดียวกันหลายครั้ง คุณอาจพบว่าการกำหนดสไตล์ที่นำมาใช้ซ้ำได้นั้นมีประโยชน์ รูปแบบเส้นประกอบจะระบุโดยใช้ออบเจ็กต์ GMSStrokeStyle รูปแบบเส้นอาจเป็นสีทึบหรือการไล่ระดับสีจากสีหนึ่งไปยังอีกสีหนึ่งก็ได้ เมื่อสร้างสไตล์แล้ว คุณจะนำไปใช้กับ GMSStyleSpan ได้ด้วยเมธอด spanWithStyle:

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 สุดท้ายจะอธิบายสีสำหรับส่วนที่เหลือของเส้น

คุณสามารถใช้บล็อกสีและ/หรือเส้นประกอบแบบไล่ระดับสีเพื่อระบุการเปลี่ยนแปลงตามเส้นประกอบ เช่น ระดับความสูงหรือความเร็ว ข้อมูลโค้ดด้านล่างจะตั้งค่าสีของเส้นประกอบ 2 ส่วนแรกเป็นสีแดง และส่วนที่เหลือของเส้นเป็นการไล่สีจากสีแดงเป็นสีเหลือง

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 แต่ละรายการจะเริ่มทันทีหลังจากรายการก่อนหน้า เช่น ในตัวอย่างด้านล่าง สีเทาจะเริ่มจากครึ่งหนึ่งของส่วนที่ 2 และต่อเนื่องไปจนถึงครึ่งหนึ่งของส่วนที่ 3

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]];

การเพิ่มรูปแบบสีที่ซ้ำกันลงในเส้นประกอบ

หากต้องการเพิ่มรูปแบบลงในเส้นประกอบ คุณสามารถใช้เมธอด GMSStyleSpans ใน GMSGeometryUtils เมธอด GMSStyleSpans จะยอมรับอาร์เรย์ 2 รายการที่กำหนดรูปแบบการทำซ้ำ อาร์เรย์หนึ่งจะกำหนดสไตล์ที่ควรทำซ้ำ และอีกอาร์เรย์หนึ่งจะกำหนดช่วงเวลาของการทำซ้ำ เมื่อใช้ร่วมกัน คุณจะสร้างรูปแบบที่ใช้กับเส้นประกอบใดก็ได้ ไม่ว่าเส้นประกอบนั้นจะมีความยาวเท่าใดหรือมีจำนวนส่วนเท่าใดก็ตาม

ตัวอย่างเช่น ข้อมูลโค้ดด้านล่างกำหนดเส้นประกอบที่มีรูปแบบสลับสีดำและสีขาว ความยาวจะถือเป็นเมตรตามเส้นรอมบ์ (ใน Mercator จะเป็นเส้นตรง) เนื่องจากมีการระบุประเภทเป็น 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 และตั้งค่าเป็นตรายางโดยใช้พร็อพเพอร์ตี้ stampStyle ของ GMSStrokeStyle

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 และตั้งค่าเป็นตราประทับโดยใช้พร็อพเพอร์ตี้ stampStyle ของ GMSStrokeStyle

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;

ความสามารถของแผนที่

พร็อพเพอร์ตี้ mapCapabilities ใน GMSMapView จะเพิ่มการตรวจสอบแบบเป็นโปรแกรมสำหรับฟีเจอร์เฉพาะแผนที่ ซึ่งจะมีประโยชน์เมื่อต้องการทราบว่าcapabilitiesของแผนที่บางรายการพร้อมใช้งานหรือไม่ก่อนที่จะเรียกใช้ API ที่เฉพาะเจาะจง การค้นหานี้จะระบุว่ามุมมองแผนที่รองรับเส้นประกอบที่ประทับสไปรท์หรือไม่

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;

รูปแบบนี้ช่วยให้คุณสมัครรับการเปลี่ยนแปลงและตอบสนองต่อการอัปเดตด้วยสถานะมุมมองแผนที่ได้ นอกจากนี้ คุณยังใช้ didChangeMapCapabilities ใน GMSMapViewDelegate เพื่อรับข้อมูลอัปเดตเกี่ยวกับความพร้อมใช้งานของฟีเจอร์ได้ด้วย

รูปหลายเหลี่ยม

รูปหลายเหลี่ยมคล้ายกับเส้นประกอบตรงที่ประกอบด้วยชุดพิกัดตามลำดับ อย่างไรก็ตาม แทนที่จะเป็นแบบปลายเปิด รูปหลายเหลี่ยมได้รับการออกแบบมาเพื่อกำหนดพื้นที่ทึบภายในลูปปิด รูปหลายเหลี่ยมจะกำหนดไว้ใน Maps SDK สำหรับ iOS โดยคลาส GMSPolygon

คุณเพิ่ม GMSPolygon ลงในแผนที่ได้ด้วยวิธีเดียวกับการเพิ่ม GMSPolyline ก่อนอื่น ให้ระบุเส้นทางโดยสร้างออบเจ็กต์ GMSMutablePath ที่เกี่ยวข้องและเพิ่มจุดลงในออบเจ็กต์ จุดเหล่านี้จะสร้างโครงร่างของรูปหลายเหลี่ยม CLLocationCoordinate2D แต่ละรายการแสดงถึงจุดบนพื้นผิวโลก ระบบจะวาดส่วนของเส้นตรงระหว่างจุดต่างๆ ตามลำดับที่คุณเพิ่มลงในเส้นทาง

เพิ่มรูปหลายเหลี่ยม

  1. สร้างออบเจ็กต์ GMSMutablePath
  2. กำหนดจุดในเส้นทางด้วยเมธอด addCoordinate: หรือ addLatitude:longitude: จุดเหล่านี้จะสร้างโครงร่างของรูปหลายเหลี่ยม
  3. สร้างอินสแตนซ์ออบเจ็กต์ GMSPolygon ใหม่โดยใช้เส้นทางเป็นอาร์กิวเมนต์
  4. ตั้งค่าพร็อพเพอร์ตี้อื่นๆ เช่น strokeWidth, strokeColor และ fillColor ตามต้องการ
  5. กำหนดรูปหลายเหลี่ยมให้กับออบเจ็กต์ GMSMapView โดยตั้งค่าพร็อพเพอร์ตี้ GMSPolygon.map
  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;

คุณสามารถปรับแต่งลักษณะที่ปรากฏของรูปหลายเหลี่ยมได้ทั้งก่อนและหลังจากเพิ่มลงในแผนที่

การนำรูปหลายเหลี่ยมออก

นำ Polygon ออกโดยตั้งค่าพร็อพเพอร์ตี้ GMSPolygon.map เป็น nil และแยก layer ออกจากระดับบนสุด

Swift

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

Objective-C

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

วงกลม

นอกจากคลาส GMSPolygon ทั่วไปแล้ว Maps SDK สำหรับ iOS ยังมี GMSCircle ซึ่งช่วยให้คุณวาดวงกลมบนพื้นผิวโลกได้ด้วย

หากต้องการสร้างวงกลม คุณต้องระบุพร็อพเพอร์ตี้ 2 รายการต่อไปนี้

  • 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 อย่างน้อย 1 รายการ ซึ่งกำหนดรูภายในรูปหลายเหลี่ยม

หากเส้นทางที่เล็กกว่าถูกล้อมรอบด้วยเส้นทางที่ใหญ่กว่าอย่างสมบูรณ์ จะปรากฏเหมือนกับว่ามีการนำส่วนหนึ่งของรูปหลายเหลี่ยมออก

ตัวอย่างโค้ดต่อไปนี้จะสร้างรูปหลายเหลี่ยมที่มีรู 2 รู

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;