Maps SDK for iOS では、さまざまな方法で地図にシェイプを追加できます。サポートされている図形は、以下のとおりです。
- ポリラインは、連結された一連の線分です。任意の形状を形成でき、地図上にパスやルートを示すために使用できます。
- ポリゴンは閉じたシェイプです。地図上の領域をマーキングするために使用できます。
- 円は、地表面上に円を地理的に正確に投影したものです。
各図形の外観は、さまざまな方法で変更できます。
ポリライン
ポリラインを使用すると、地図上に線を描画できます。GMSPolyline
オブジェクトは、順序付けされた一連の場所を表し、一連の線分として表示されます。ポリラインの色は GMSStrokeStyle
を使って設定できます。
ポリラインを作成するには、対応する GMSMutablePath
オブジェクトを作成して 2 つ以上の地点を設定し、そのパスを指定する必要があります。各 CLLocationCoordinate2D
は、地表面上の 1 点を表します。線分は、パスにポイントを追加した順序に従って、ポイント間に描画されます。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];
ポリラインを追加する
GMSMutablePath
オブジェクトを作成します。addCoordinate:
メソッドまたはaddLatitude:longitude:
メソッドを使用して、パス内にポイントを設定します。- パスを引数として使用して、新しい
GMSPolyline
オブジェクトをインスタンス化します。 - 必要に応じて、
strokeWidth
やstrokeColor
などの他のプロパティを設定します。 GMSPolyline
のmap
プロパティを設定します。- ポリラインが地図上に表示されます。
次のコード スニペットでは、マップに長方形を追加しています。
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
- : ポリラインの 1 つ以上の線分の色を指定するために使用します。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]];
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
プロパティを 1 つの 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]];
小数セグメント
セグメントは小数値で指定することもできます。これにより、そのスタイルが小数のセグメントに適用されるため、1 つのセグメントに分割される可能性があります。各 GMSStyleSpan
は前のセグメントの直後に始まります。以下の例では、灰色の色は 2 番目のセグメントの 1⁄2 から始まり、3 番目のセグメントの 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
メソッドは、繰り返しパターンを定義する 2 つの配列を受け入れます。1 つの配列では繰り返す必要があるスタイルを設定し、もう 1 つは繰り返しの間隔を定義します。これらを組み合わせて使用すると、ポリラインの長さや使用可能なセグメント数に関係なく、あらゆるポリラインに適用できるパターンを作成できます。
たとえば、以下のコード スニペットは、白黒の交互のパターンを持つポリラインを定義しています。型は 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]; 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
プロパティを使用してスタンプとして設定します。
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
プロパティは、地図固有の対象物をプログラマティックにチェックする機能を追加します。これは、特定の API を呼び出す前に、特定の地図 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
を実装して、機能の提供状況に関する最新情報を取得することもできます。
ポリゴン
ポリゴンは、指定された順序の一連の座標で構成されている点でポリラインと似ています。ただし、ポリゴンは終端部が開いておらず、閉じたループ内に塗りつぶされた領域として定義されます。ポリゴンは、Maps SDK for iOS で GMSPolygon
クラスによって定義されます。
GMSPolygon
は、GMSPolyline
を追加するのと同じ方法で地図に追加できます。まず、対応する GMSMutablePath
オブジェクトを作成し、そこにポイントを追加して、パスを指定します。これらのポイントにより、ポリゴンのアウトラインが形成されます。各 CLLocationCoordinate2D
は地表面上の 1 点を表します。線分は、パスにポイントを追加した順序に従って、ポイント間に描画されます。
ポリゴンを追加する
GMSMutablePath
オブジェクトを作成します。addCoordinate:
メソッドまたはaddLatitude:longitude:
メソッドを使用して、パス内にポイントを設定します。これらのポイントにより、ポリゴンのアウトラインが形成されます。- パスを引数として使用して、新しい
GMSPolygon
オブジェクトをインスタンス化します。 - 必要に応じて、
strokeWidth
、strokeColor
、fillColor
などの他のプロパティを設定します。 GMSPolygon.map
プロパティを設定して、ポリゴンをGMSMapView
オブジェクトに割り当てます。- 地図上にポリゴンが表示されます。
次のコード スニペットでは、地図に長方形を追加しています。
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
も含まれています。
円を作成するには、次の 2 つのプロパティを指定する必要があります。
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;
中が空洞のポリゴンを作成する
複数のパスを 1 つの GMSPolygon
オブジェクトにまとめて、塗りつぶしの輪やドーナツ(多角形の領域がポリゴン内に個別の図形として表示される)などの複雑なシェイプを作成できます。複雑なシェイプは、複数のパスで構成されています。
ポリゴンでカバーされる最大領域を指定するパスを使用して、ポリゴンを作成します。次に、ポリゴンの holes
プロパティを 1 つ以上の GMSPath
オブジェクトの配列として指定します。これにより、ポリゴン内の穴を定義します。
小さい方のパスが大きい方のパスで完全に囲まれている場合、ポリゴンの一部が削除されているかのように見えます。
次のコードサンプルは、2 つの穴を持つポリゴンを作成します。
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;