概要
マーカーは、マップ上の特定のポイントに配置されるアイコンです。
マーカーのアイコンは、地図の表面ではなく、デバイスの画面の向きに合わせて描画されます。つまり、地図の回転、傾斜、ズームによって、必ずしも向きが変わるわけではありません。
GMSOverlay を継承します。
GMSAdvancedMarker によって継承されます。
静的パブリック メンバー関数 | |
(instancetype) | + markerWithPosition: |
デフォルト マーカー用のコンビニエンス コンストラクタ。 | |
(UIImage *) | + markerImageWithColor: |
アイコンとして使用するデフォルトのマーカー画像の色合い調整したバージョンを作成します。 | |
プロパティ | |
CLLocationCoordinate2D | position |
マーカーの位置。 | |
NSString * | スニペット |
スニペット テキスト。選択すると、情報ウィンドウのタイトルの下に表示されます。 | |
UIImage * | アイコン |
レンダリングするマーカー アイコン。 | |
UIView * | iconView |
レンダリングするマーカービュー。 | |
BOOL | tracksViewChanges |
このマーカーのアイコンをフレームごとに再描画するかどうかを制御します。 | |
BOOL | tracksInfoWindowChanges |
このマーカーの情報ウィンドウをフレームごとに再描画するかどうかを制御します。 | |
CGPoint | groundAnchor |
地面アンカーは、地表面上のマーカーの位置に固定されるアイコン画像内の点を指定します。 | |
CGPoint | infoWindowAnchor |
情報ウィンドウのアンカーは、情報ウィンドウを固定するアイコン画像内の点を指定します。この点のすぐ上に表示されます。 | |
GMSMarkerAnimation | appearAnimation |
このマーカーが GMSMapView 上に配置されたときに使用されるアニメーションを制御します(デフォルトは kGMSMarkerAnimationNone で、アニメーションは実行しません)。 | |
BOOL | ドラッグ可能 |
このマーカーをインタラクティブにドラッグできるかどうかを制御します(デフォルトは NO)。 | |
BOOL | フラット |
このマーカーを地表面に対して平らにするか(はい)、看板をカメラの方面に置くか(いいえ、デフォルト)を指定します。 | |
CLLocationDegrees | 回転 |
マーカーのアンカー ポイントを中心として時計回りの角度でマーカーの回転を設定します。 | |
float | 不透明度 |
マーカーの不透明度を 0(完全に透明)~ 1(デフォルト)の範囲で設定します。 | |
GMSMarkerLayer * | レイヤ |
この GMSMarker の Core Animation レイヤを提供します。 | |
GMSPanoramaView * | panoramaView |
panoramaView は、このマーカーの表示を試みるパノラマビューを指定します。 | |
NSString * | title |
タイトル、オーバーレイの簡単な説明。 | |
GMSMapView * | map |
このオーバーレイが表示される地図。 | |
BOOL | タップ可能 |
このオーバーレイでタップ通知を発生させるか | |
int | zIndex |
zIndex 値が高いオーバーレイは、zIndex 値が小さいタイルレイヤとオーバーレイの上に描画されます。 | |
id | userData |
オーバーレイ データ |
メンバー関数のドキュメント
+ (instancetype) markerWithPosition: | (CLLocationCoordinate2D) | position |
デフォルト マーカー用のコンビニエンス コンストラクタ。
+(UIImage *)markerImageWithColor: | (nullable UIColor *) | 色 |
アイコンとして使用するデフォルトのマーカー画像の色合い調整したバージョンを作成します。
プロパティのドキュメント
- (CLLocationCoordinate2D) position [read, write, assign] |
マーカーの位置。
アニメーション化。
-(NSString*)スニペット [read, write, copy] |
スニペット テキスト。選択すると、情報ウィンドウのタイトルの下に表示されます。
-(UIImage*)アイコン [read, write, assign] |
レンダリングするマーカー アイコン。
nil のままにすると、デフォルトの SDK 場所マーカーが使用されます。
アニメーション画像がサポートされますが、各フレームは同じサイズである必要があります。そうでない場合、動作が定義されません。
AlignmentRectInsets を使用してタップ領域を縮小できます。また、アンカーの指定方法も再定義されます。アニメーション画像の場合、個々のフレームではなくアニメーションの値が使用されます。
- (UIView*)iconView [read, write, assign] |
レンダリングするマーカービュー。
nil のままにすると、代わりに icon
プロパティにフォールバックします。
frame
と center
を除く、UIView のすべてのアニメーション化可能なプロパティのアニメーションをサポートします。これらのプロパティまたはそれに対応する CALayer バージョン(position
を含む)は変更できません。
実際の値に関係なく、clipsToBounds
が YES に設定されているかのようにビューは動作します。
- (BOOL)tracksViewChanges [read, write, assign] |
このマーカーのアイコンをフレームごとに再描画するかどうかを制御します。
なお、これが NO から YES に変わった場合は、アイコンは次のフレームで再描画されることが保証されます。
デフォルトは YES です。iconView
が nil の場合、影響はありません。
- (BOOL)tracksInfoWindowChanges [read, write, assign] |
このマーカーの情報ウィンドウをフレームごとに再描画するかどうかを制御します。
なお、これが NO から YES に変わった場合は、情報ウィンドウが次のフレームで再描画されることが保証されます。
デフォルトは NO です。
-(CGPoint)groundAnchor [read, write, assign] |
地面アンカーは、地表面上のマーカーの位置に固定されるアイコン画像内の点を指定します。
このポイントは、連続した空間 [0.0, 1.0] x [0.0, 1.0] 内で指定します。ここで、(0,0) は画像の左上隅、(1,1) は画像の右下隅です。
画像にゼロ以外の AlignmentRectInsets がある場合、上記の左上と右下は画像のインセット セクションを指します。
-(CGPoint)infoWindowAnchor [read, write, assign] |
情報ウィンドウのアンカーは、情報ウィンドウを固定するアイコン画像内の点を指定します。この点のすぐ上に表示されます。
このポイントは、groundAnchor と同じスペース内で指定されます。
- (GMSMarkerAnimation)appearAnimation [read, write, assign] |
このマーカーが GMSMapView 上に配置されたときに使用されるアニメーションを制御します(デフォルトは kGMSMarkerAnimationNone で、アニメーションは実行しません)。
-(BOOL)draggable [read, write, assign] |
このマーカーをインタラクティブにドラッグできるかどうかを制御します(デフォルトは NO)。
-(BOOL)フラット [read, write, assign] |
このマーカーを地表面に対して平らにするか(はい)、看板をカメラの方面に置くか(いいえ、デフォルト)を指定します。
- (CLLocationDegrees) 回転 [read, write, assign] |
マーカーのアンカー ポイントを中心として時計回りの角度でマーカーの回転を設定します。
回転軸はマーカーに対して垂直です。0 の回転はマーカーのデフォルト位置に対応します。アニメーション化。
地図上のマーカーがフラットな場合、デフォルトの位置は北方向に揃えられ、地図上のマーカーは常にフラットになるように回転されます。マーカーがビルボードの場合、デフォルトの位置は上向きとなり、マーカーは常にカメラの方を向いて回転します。
-(浮動小数点数)不透明度 [read, write, assign] |
マーカーの不透明度を 0(完全に透明)~ 1(デフォルト)の範囲で設定します。
- (GMSMarkerLayer*) layer [read, assign] |
この GMSMarker の Core Animation レイヤを提供します。
- (GMSPanoramaView*)panoramaView [read, write, assign] |
panoramaView
は、このマーカーの表示を試みるパノラマビューを指定します。
マーカーの position
が panoramaView
の現在のパノラマ位置から遠すぎると、小さすぎるため表示されません。
nil に設定すると、マーカーが添付されている現在のパノラマビューからマーカーを削除できます。
マーカーは、パノラマと地図の両方に同時に表示できます。
- (NSString*) title [read, write, copy, inherited] |
タイトル、オーバーレイの簡単な説明。
マーカーなどのオーバーレイでは、地図上にタイトルが表示されます。タイトルはデフォルトのユーザー補助テキストでもあります。
- (GMSMapView*) map [read, write, assign, inherited] |
このオーバーレイが表示される地図。
このプロパティを設定すると、オーバーレイが地図に追加されます。nil に設定すると、このオーバーレイが地図から削除されます。オーバーレイは、一度に 1 つの地図で有効にできます。
- (BOOL)タップ可能 [read, write, assign, inherited] |
このオーバーレイでタップ通知を発生させるか
マーカーなどの一部のオーバーレイは、デフォルトでタップ可能に設定されています。
-(int)zIndexzIndex [read, write, assign, inherited] |
zIndex
値が高いオーバーレイは、zIndex
値が小さいタイルレイヤとオーバーレイの上に描画されます。
同じ値を指定すると、描画順序は定義されません。マーカーは例外で、zIndex
に関係なく常にタイルレイヤおよびその他のマーカー以外のオーバーレイの上に描画されます。事実上、他のオーバーレイとは異なる Z-Index グループに属していると見なされます。
- (id)userData [read, write, assign, inherited] |
オーバーレイ データ
このプロパティを使用して、任意のオブジェクトをこのオーバーレイに関連付けることができます。Google Maps SDK for iOS では、このプロパティの読み取りも書き込みも行いません。
userData がマップ オブジェクトへの強力な参照を保持しないように注意してください。保持サイクルが作成され、オブジェクトが解放されなくなる可能性があります。