形狀

透過集合功能整理內容 你可以依據偏好儲存及分類內容。
選取平台: Android iOS JavaScript

Maps SDK for iOS 提供了一些在地圖中加入形狀的簡單做法。下面的圖形支持:

  • 折線是連續線段,可構成您想要的任何形狀,並可用來標記地圖上的路徑和路線。
  • 多邊形是一個封閉的形狀,可用於在地圖上標記的區域。
  • 圓形是地球表面圓形的精確投影。

你可以修改每個形狀的多種方式的外觀。

折線

折線讓你在地圖上繪製線條。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. 視需要設定其他屬性,例如 strokeWidthstrokeColor
  5. 設定 GMSPolylinemap 屬性。
  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;
      

矩形多段線

移除折線

你可以將 GMSPolylinemap 屬性設為 nil,從地圖中移除折線。或者,您也可以呼叫 GMSMapView clear 方法,移除地圖上的所有疊加層 (包括折線和其他形狀)。

Swift

mapView.clear()
      

Objective-C

[mapView clear];
      

自訂折線

GMSPolyline 物件提供多個屬性來控制線條的外觀。它支持下面的選項:

strokeWidth
整條行的寬度和螢幕點。默認為1。縮放地圖時,寬度的尺寸不會改變。
geodesic
YES 中,將這個折線邊緣顯示為測地線。測地線段依照地球表面的最短路徑,在麥卡托投影地圖中可能會顯示為曲線。非測地線段在地圖上繪製成直線。這個變數預設為 NO
spans
用於指定折線的一或多個線段的顏色。Span 屬性是 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]];
      

在 Maps SDK for iOS 1.7 版之前,您可以使用單一屬性 strokeColor 來設定 GMSPolyline 的整個顏色。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 都會從前一個片段開始後開始。在以下範例中,灰色的顏色從 1⁄2 到第二個片段開始,一直到 1⁄2 到第三個片段。

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 方法可接受兩個定義重複模式的陣列。其中一個陣列會設定應重複的樣式,另一個陣列則定義重複的間隔。搭配使用時,您可以建立模式,並套用至任何折線,不論長度或可用區隔數量為何。

舉例來說,下列程式碼片段定義了採用黑白替代模式的折線。類型以 rhumb 線為單位處理 (公尺),這是直線),當類型指定為 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);
      

多邊形

多邊形與折線類似,都是由一系列座標依序組成。不過,多邊形並不是開放的線段,而是用來定義封閉環中的固體區域。GMSPolygon 類別是由 Maps SDK for iOS 定義的多邊形。

在地圖中新增 GMSPolygon 的做法與加入 GMSPolyline 的方式相同。首先,請建立對應的 GMSMutablePath 物件並新增路徑點來指定路徑。這些點會構成多邊形的外框。每個 CLLocationCoordinate2D 都代表地球表面上的一個點。根據您在路徑中新增路徑的順序,系統會在點與點之間繪製線段。

加入多邊形

  1. 建立 GMSMutablePath 物件。
  2. 使用 addCoordinate:addLatitude:longitude: 方法設定路徑中的路徑點。這些點會構成多邊形的外框。
  3. 使用路徑做為引數,將新的 GMSPolygon 物件執行個體化。
  4. 視需要設定其他屬性,例如 strokeWidthstrokeColorfillColor
  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 類別之外,Maps SDK for iOS 也包含 GMSCircle,方便您在地球表面上繪製圓形。

如要建構圓形,您必須指定以下兩個屬性:

  • CLLocationCoordinate2D 格式指定的 position
  • 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 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
      

Objective-C

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;