概要
GMSGroundOverlay は、地表面上に存在する地面オーバーレイで利用可能なオプションを指定します。
マーカーとは異なり、地面オーバーレイの位置は明示的に指定され、カメラには向きません。
GMSOverlay を継承します。
静的パブリック メンバー関数 | |
(instancetype) | + groundOverlayWithBounds:icon: |
特定の bounds と icon に対する GMSGroundOverlay のコンビニエンス コンストラクタ。 | |
(instancetype) | + groundOverlayWithPosition:icon:zoomLevel: |
画像の実際のサイズが zoomLevel のカメラ ピクセルと一致する場合のように、指定された icon を position にレンダリングする GMSGroundOverlay を作成します。 | |
プロパティ | |
CLLocationCoordinate2D | position |
この GMSGroundOverlay の位置、より具体的にはアンカーの物理的な位置です。 | |
CGPoint | アンカー |
アンカーは、この GMSGroundOverlay が、bounds を基準として地球に固定される場所を指定します。 | |
UIImage * | アイコン |
Earth の bounds 内にレンダリングするアイコン。 | |
float | 不透明度 |
地面オーバーレイの不透明度を 0(完全に透明)~ 1(デフォルト)の範囲で設定します。 | |
CLLocationDirection | bearing |
この地面オーバーレイの向き(度数)。 | |
GMSCoordinateBounds * | 境界 |
icon が描画される地球上の 2D 境界。 | |
NSString * | title |
タイトル、オーバーレイの簡単な説明。 | |
GMSMapView * | map |
このオーバーレイが表示される地図。 | |
BOOL | タップ可能 |
このオーバーレイでタップ通知を発生させるか | |
int | zIndex |
zIndex 値が高いオーバーレイは、zIndex 値が小さいタイルレイヤとオーバーレイの上に描画されます。 | |
id | userData |
オーバーレイ データ |
メンバー関数のドキュメント
+ (instancetype) groundOverlayWithBounds: | (null 許容の GMSCoordinateBounds *) | 境界 | |
アイコン: | (nullable UIImage *) | アイコン | |
特定の bounds
と icon
に対する GMSGroundOverlay のコンビニエンス コンストラクタ。
それに応じて position
を設定します。
+ (instancetype) groundOverlayWithPosition: | (CLLocationCoordinate2D) | position | |
アイコン: | (nullable UIImage *) | アイコン | |
zoomLevel: | (CGFloat) | zoomLevel | |
画像の実際のサイズが zoomLevel
のカメラ ピクセルと一致する場合のように、指定された icon
を position
にレンダリングする GMSGroundOverlay を作成します。
プロパティのドキュメント
- (CLLocationCoordinate2D) position [read, write, assign] |
この GMSGroundOverlay の位置、より具体的にはアンカーの物理的な位置です。
この変更を行うと、bounds
は新しい位置を中心に移動します。
-(CGPoint)アンカー [read, write, assign] |
アンカーは、この GMSGroundOverlay が、bounds
を基準として地球に固定される場所を指定します。
これを変更すると、position
は bounds
内の対応する新しい位置に設定されます。
-(UIImage*)アイコン [read, write, assign] |
Earth の bounds
内にレンダリングするアイコン。
nil にすると、オーバーレイは表示されません(デフォルトの画像がある GMSMarker とは異なります)。
-(浮動小数点数)不透明度 [read, write, assign] |
地面オーバーレイの不透明度を 0(完全に透明)~ 1(デフォルト)の範囲で設定します。
- (CLLocationDirection) bearing [read, write, assign] |
この地面オーバーレイの向き(度数)。
デフォルト値の 0 は、地面オーバーレイが地球の法線 Y 軸に沿って上下することを示します。
- (GMSCoordinateBounds*) 境界 [read, write, assign] |
icon
が描画される地球上の 2D 境界。
この値を変更すると、それに応じて position
が調整されます。
- (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 がマップ オブジェクトへの強力な参照を保持しないように注意してください。保持サイクルが作成され、オブジェクトが解放されなくなる可能性があります。