マーカーのカスタマイズ

プラットフォームを選択: Android iOS JavaScript

さまざまなカスタム マーカーのスクリーンショット

高度なマーカーは 2 つのクラスを使用してマーカーを定義します。デフォルトのマーカー機能を提供する GMSAdvancedMarker クラスと、さらにカスタマイズするためのオプションを含む GMSPinImageOptionsこのページでは、マーカーを次のようにカスタマイズする方法について説明します。

  • 背景色を変更する
  • 輪郭線の色を変更する
  • グリフの色を変更する
  • グリフテキストを変更する
  • iconView プロパティを使用してカスタムビューとアニメーションをサポートする
高度なマーカーの構成要素
図 1: 高度なマーカーのパーツ

背景色を変更する

マーカーの背景色を変更するには、GMSPinImageOptions.backgroundColor オプションを使用します。

Swift

//...

let options = GMSPinImageOptions()
options.backgroundColor = .blue

let pinImage = GMSPinImage(options: options)
advancedMarker.icon = pinImage

advancedMarker.map = mapView

Objective-C

//...

GMSPinImageOptions *options = [[GMSPinImageOptions alloc] init];
options.backgroundColor = [UIColor blueColor];

GMSPinImage *pin = [GMSPinImage pinImageWithOptions:options];
customTextMarker.icon = pin;

customTextMarker.map = mapView;

輪郭線の色を変更する

マーカーの背景色を変更するには、GMSPinImageOptions.borderColor オプションを使用します。

Swift

//...

let options = GMSPinImageOptions()
options.borderColor = .blue

let pinImage = GMSPinImage(options: options)
advancedMarker.icon = pinImage

advancedMarker.map = mapView

Objective-C

//...

GMSPinImageOptions *options = [[GMSPinImageOptions alloc] init];
options.backgroundColor = [UIColor blueColor];

GMSPinImage *pin = [GMSPinImage pinImageWithOptions:options];
advancedMarker.icon = pin;

advancedMarker.map = mapView;

グリフの色を変更する

マーカーの背景色を変更するには、GMSPinImageGlyph.glyphColor を使用します。

Swift

//...

let options = GMSPinImageOptions()

let glyph = GMSPinImageGlyph(glyphColor: .yellow)
options.glyph = glyph

let glyphColor = GMSPinImage(options: options)

advancedMarker.icon = glyphColor
advancedMarker.map = mapView

Objective-C

//...

GMSPinImageOptions *options = [[GMSPinImageOptions alloc] init];

options.glyph = [[GMSPinImageGlyph alloc] initWithGlyphColor:[UIColor yellowColor]];
GMSPinImage *glyphColor = [GMSPinImage pinImageWithOptions:options];

advancedMarker.icon = glyphColor;
advancedMarker.map = mapView;

グリフテキストを変更する

マーカーのグリフテキストを変更するには、GMSPinImageGlyph を使用します。

Swift

//...

let options = GMSPinImageOptions()

let glyph = GMSPinImageGlyph(text: "ABC", textColor: .white)
options.glyph = glyph

let pinImage = GMSPinImage(options: options)

advancedMarker.icon = pinImage
advancedMarker.map = mapView

Objective-C

//...

GMSPinImageOptions *options = [[GMSPinImageOptions alloc] init];

options.glyph = [[GMSPinImageGlyph alloc] initWithText:@"ABC" textColor:[UIColor whiteColor]];
GMSPinImage *pin = [GMSPinImage pinImageWithOptions:options];

customTextMarker.icon = pin;
customTextMarker.map = mapView;

iconView プロパティを使用してカスタムビューとアニメーションをサポートする

GMSMarker と同様に、GMSAdvancedMarker も iconView を使用するマーカーをサポートしています。iconView プロパティは、UIView のアニメーション化可能なすべてのプロパティのアニメーションをサポートします（frame と center を除く）。iconViews と icons を同じ地図に表示するマーカーはサポートされていません。

Swift

//...

let advancedMarker = GMSAdvancedMarker(position: coordinate)
advancedMarker.iconView = customView()
advancedMarker.map = mapView

func customView() -> UIView {
// return your custom UIView.
}

Objective-C

//...

GMSAdvancedMarker *advancedMarker = [GMSAdvancedMarker markerWithPosition:kCoordinate];
advancedMarker.iconView = [self customView];
advancedMarker.map = self.mapView;

-   (UIView *)customView {
  // return custom view
}

レイアウトの制約

GMSAdvancedMarker は、iconView のレイアウト制約を直接サポートしていません。ただし、iconView 内でユーザー インターフェース要素のレイアウト制約を設定できます。ビューを作成する際に、オブジェクト frame または size をマーカーに渡す必要があります。

Swift

//do not set advancedMarker.iconView.translatesAutoresizingMaskIntoConstraints = false

let advancedMarker = GMSAdvancedMarker(position: coordinate)
let customView = customView()

//set frame
customView.frame = CGRect(0, 0, width, height)

advancedMarker.iconView = customView

Objective-C

//do not set advancedMarker.iconView.translatesAutoresizingMaskIntoConstraints = NO;

GMSAdvancedMarker *advancedMarker = [GMSAdvancedMarker markerWithPosition:kCoordinate];

CustomView *customView = [self customView];

//set frame
customView.frame = CGRectMake(0, 0, width, height);

advancedMarker.iconView = customView;