GMSAdvancedMarker クラス リファレンス

GMSAdvancedMarker クラス リファレンス

概要

高度なマーカーとは、地図上の特定の場所に配置されるアイコンです。

GMSMarker を継承します。

静的パブリック メンバー関数

(instancetype)+ markerWithPosition:
 デフォルトのマーカーのコンビニエンス コンストラクタ。
(UIImage *)+ markerImageWithColor:
 アイコンとして使用するデフォルトのマーカー画像に着色したバージョンを作成します。

プロパティ

GMSCollisionBehaviorcollisionBehavior
 マーカーが重なった場合の動作。地図上の他のマーカーやラベル付きコンテンツによって、マーカーの公開設定が影響を受けるかどうかを決定します。
CLLocationCoordinate2Dposition
 マーカーの位置。
NSString * スニペット
 スニペット テキスト。選択すると、情報ウィンドウのタイトルの下に表示されます。
UIImage * アイコン
 レンダリングするマーカー アイコン。
UIView * iconView
 レンダリングするマーカービュー。
BOOL tracksViewChanges
 このマーカーのアイコンをフレームごとに再描画するかどうかを制御します。
BOOL tracksInfoWindowChanges
 このマーカーの情報ウィンドウをフレームごとに再描画するかどうかを制御します。
CGPointgroundAnchor
 地面アンカーは、地表面上のマーカーの位置に固定されているアイコン画像内のポイントを指定します。
CGPointinfoWindowAnchor
 情報ウィンドウのアンカーは、アイコン画像内の情報ウィンドウを固定するポイントを指定します。このポイントは、このポイントのすぐ上に表示されます。
GMSMarkerAnimationappearAnimation
 このマーカーが GMSMapView に配置されたときに使用されるアニメーションを制御します(デフォルトは kGMSMarkerAnimationNone、アニメーションなし)。
BOOL ドラッグ可能
 このマーカーをインタラクティブにドラッグできるかどうかを制御します(デフォルトは NO)。
BOOL フラット
 このマーカーを地表面に対して平らにするか(はい)、ビルボードにカメラに向けて表示するか(いいえ、デフォルト)を指定します。
CLLocationDegreesローテーション
 マーカーのアンカー ポイントを軸とした時計回りの角度で、マーカーの回転を設定します。
float 不透明度
 マーカーの不透明度を 0(完全に透明)~ 1(デフォルト)の範囲で設定します。
GMSMarkerLayerレイヤ
 この GMSMarker の Core Animation レイヤを提供します。
GMSPanoramaViewpanoramaView
 panoramaView は、このマーカーの表示を試みるパノラマ ビューを指定します。
NSString * title
 タイトル、オーバーレイの簡単な説明。
GMSMapViewmap
 このオーバーレイが表示される地図。
BOOL タップ可能
 このオーバーレイによってタップ通知が発生するかどうか。
int zIndex
 zIndex 値が高いオーバーレイは、zIndex 値が低いタイルレイヤとオーバーレイの上に描画されます。
iduserData
 オーバーレイ データ。

メンバー関数のドキュメント

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D) position

デフォルトのマーカーのコンビニエンス コンストラクタ。

+ (UIImage *) markerImageWithColor: (nullable UIColor *) 

アイコンとして使用するデフォルトのマーカー画像に着色したバージョンを作成します。


プロパティのドキュメント

-(GMSCollisionBehaviorcollisionBehavior [read, write, assign]

マーカーが重なった場合の動作。地図上の他のマーカーやラベル付きコンテンツによって、マーカーの公開設定が影響を受けるかどうかを決定します。

- (CLLocationCoordinate2D) position [read, write, assign, inherited]

マーカーの位置。

アニメーション。

-(NSString*)snippet [read, write, copy, inherited]

スニペット テキスト。選択すると、情報ウィンドウのタイトルの下に表示されます。

- (UIImage*) icon [read, write, assign, inherited]

レンダリングするマーカー アイコン。

nil のままにすると、SDK のデフォルトの場所マーカーが使用されます。

アニメーション画像がサポートされていますが、各フレームは同じサイズである必要があります。そうでない場合は動作が未定義です。

AlignmentRectInsets を使用して、縮小されたタップ領域を指定できます。これにより、アンカーの指定方法も再定義されます。アニメーション画像の場合は、個々のフレームではなくアニメーションの値が使用されます。

-(UIView*)iconView [read, write, assign, inherited]

レンダリングするマーカービュー。

nil のままにすると、代わりに icon プロパティにフォールバックします。

framecenter を除く、UIView のすべてのアニメーション化可能なプロパティのアニメーションをサポートします。これらのプロパティや対応する CALayer バージョン(position など)の変更はサポートされていません。

ビューは、実際の値に関係なく、clipsToBounds が YES に設定されているかのように動作します。

- (BOOL)tracksViewChanges [read, write, assign, inherited]

このマーカーのアイコンをフレームごとに再描画するかどうかを制御します。

なお、これが NO から YES に変わった場合、アイコンは次のフレームで再描画されることが保証されます。

デフォルトは YES です。iconView が nil の場合、影響はありません。

- (BOOL)tracksInfoWindowChanges [read, write, assign, inherited]

このマーカーの情報ウィンドウをフレームごとに再描画するかどうかを制御します。

なお、これが NO から YES に変わった場合、情報ウィンドウは次のフレームで再描画されることが保証されます。

デフォルトは NO です。

-(CGPoint)groundAnchor [read, write, assign, inherited]

地面アンカーは、地表面上のマーカーの位置に固定されているアイコン画像内のポイントを指定します。

この点は、連続した空間 [0.0, 1.0] x [0.0, 1.0] 内に指定します。ここで、(0,0) は画像の左上隅、(1,1) は画像の右下隅です。

画像に 0 以外の AlignmentRectInsets がある場合、上記の左上と右下は画像のインセット セクションを表します。

-(CGPoint)infoWindowAnchor [read, write, assign, inherited]

情報ウィンドウのアンカーは、アイコン画像内の情報ウィンドウを固定するポイントを指定します。このポイントは、このポイントのすぐ上に表示されます。

このポイントは、groundAnchor と同じ空間内で指定されます。

- (GMSMarkerAnimationappearAnimation [read, write, assign, inherited]

このマーカーが GMSMapView に配置されたときに使用されるアニメーションを制御します(デフォルトは kGMSMarkerAnimationNone、アニメーションなし)。

-(BOOL)ドラッグ可能 [read, write, assign, inherited]

このマーカーをインタラクティブにドラッグできるかどうかを制御します(デフォルトは NO)。

-(BOOL)フラット [read, write, assign, inherited]

このマーカーを地表面に対して平らにするか(はい)、ビルボードにカメラに向けて表示するか(いいえ、デフォルト)を指定します。

- (CLLocationDegrees) rotation [read, write, assign, inherited]

マーカーのアンカー ポイントを軸とした時計回りの角度で、マーカーの回転を設定します。

回転軸はマーカーに対して垂直です。回転 0 はマーカーのデフォルト位置に対応します。アニメーション。

地図上のマーカーがフラットな場合、デフォルトの位置は北に揃えられ、マーカーが常に地図上でフラットな状態で回転します。マーカーがビルボードの場合、デフォルトの位置は上向きとなり、マーカーは常にカメラの方を向いて回転します。

-(浮動小数点数)opacity [read, write, assign, inherited]

マーカーの不透明度を 0(完全に透明)~ 1(デフォルト)の範囲で設定します。

- (GMSMarkerLayer*)レイヤ [read, assign, inherited]

この GMSMarker の Core Animation レイヤを提供します。

- (GMSPanoramaView*) panoramaView [read, write, assign, inherited]

panoramaView は、このマーカーの表示を試みるパノラマ ビューを指定します。

マーカーの positionpanoramaView の現在のパノラマ位置から遠すぎると、小さすぎるため表示されません。

nil に設定すると、マーカーがアタッチされている現在のパノラマビューからマーカーを削除できます。

マーカーは、パノラマと地図の両方に同時に表示できます。

- (NSString*) title [read, write, copy, inherited]

タイトル、オーバーレイの簡単な説明。

マーカーなどのオーバーレイでは、タイトルが地図上に表示されます。タイトルはデフォルトのユーザー補助テキストでもあります。

- (GMSMapView*) map [read, write, assign, inherited]

このオーバーレイが表示される地図。

このプロパティを設定すると、地図にオーバーレイが追加されます。nil に設定すると、このオーバーレイが地図から削除されます。オーバーレイは、一度に 1 つの地図でのみアクティブにできます。

-(BOOL)タップ可能 [read, write, assign, inherited]

このオーバーレイによってタップ通知が発生するかどうか。

マーカーなどの一部のオーバーレイは、デフォルトでタップ可能になっています。

-(整数)zIndex [read, write, assign, inherited]

zIndex 値が高いオーバーレイは、zIndex 値が低いタイルレイヤとオーバーレイの上に描画されます。

同じ値を指定すると、描画の順序は定義されません。ただし例外として、マーカーは zIndex に関係なく、常にタイルレイヤやその他のマーカー以外のオーバーレイの上に描画されます。つまり、マーカーは他のオーバーレイとは異なる Z-Index グループに属していると見なされます。

-(ID)userData [read, write, assign, inherited]

オーバーレイ データ。

このプロパティを使用すると、任意のオブジェクトをこのオーバーレイに関連付けることができます。Google Maps SDK for iOS では、このプロパティの読み取りも書き込みも行いません。

userData が Maps オブジェクトへの強力な参照を保持しないようにしてください。保持すると、保持サイクルが作成され、オブジェクトが解放されなくなる可能性があります。