validate Parcelable
地面オーバーレイのオプションを定義します。
定数の概要
float | NO_DIMENSION | 高さのディメンションが指定されていない場合。 |
継承された定数の概要
パブリック コンストラクタの概要
GroundOverlayOptions()
地面オーバーレイの新しいオプション セットを作成します。
|
パブリック メソッドの概要
GroundOverlayOptions |
anchor(float u, float v)
アンカーを指定します。
|
GroundOverlayOptions |
bearing(フロート ベアリング)
地面オーバーレイの向きを、北からの時計回りの度数で指定します。
|
GroundOverlayOptions |
clickable(boolean clickable)
地面オーバーレイがクリック可能かどうかを指定します。
|
浮動小数点数 |
getAnchorU()
水平方向の相対アンカー。
0.0 と 1.0 は、それぞれ左端と右端を表します。 |
浮動小数点数 |
getAnchorV()
垂直方向の相対アンカー。
0.0 と 1.0 は、それぞれ上端と下端を示します。 |
浮動小数点数 |
getBearing()
この
GroundOverlayOptions オブジェクトのベアリング セットを取得します。 |
LatLngBounds |
getBounds()
この
GroundOverlayOptions オブジェクトに設定された境界を取得します。 |
浮動小数点数 |
getHeight()
この
GroundOverlayOptions オブジェクトに設定された高さを取得します。 |
BitmapDescriptor |
getImage()
この
GroundOverlayOptions オブジェクトに設定された画像記述子を取得します。 |
LatLng |
getLocation()
この
GroundOverlayOptions オブジェクトに設定されたロケーションを取得します。 |
浮動小数点数 |
getTransparency()
この
GroundOverlayOptions オブジェクトに設定されている透明度を取得します。 |
浮動小数点数 |
getWidth()
この
GroundOverlayOptions オブジェクトに設定された幅を取得します。 |
浮動小数点数 |
getZIndex()
この
GroundOverlayOptions オブジェクトに設定された zIndex を取得します。 |
GroundOverlayOptions | |
ブール値 |
isClickable()
この
GroundOverlayOptions オブジェクトのクリック可能性設定を取得します。 |
ブール値 |
isVisible()
この
GroundOverlayOptions オブジェクトの公開設定を取得します。 |
GroundOverlayOptions | |
GroundOverlayOptions | |
GroundOverlayOptions | |
GroundOverlayOptions |
transparency(浮動小数点透明度)
地面オーバーレイの透明度を指定します。
|
GroundOverlayOptions |
visible(ブール値を表示)
地面オーバーレイの可視性を指定します。
|
GroundOverlayOptions |
zIndex(float zIndex)
地面オーバーレイの zIndex、つまり描画順序を指定します。
|
継承されたメソッドの概要
定数
public static final float NO_DIMENSION
高さのディメンションが指定されていない場合。
パブリック コンストラクタ
public GroundOverlayOptions ()
地面オーバーレイの新しいオプション セットを作成します。
パブリック メソッド
public GroundOverlayOptions anchor (float u, float v)
アンカーを指定します。
アンカーは地面オーバーレイの位置に位置します。
アンカー ポイントは、2 次元の連続空間で指定します。ここで、(0,0)、(1,0)、(0,1)、(1,1) はそれぞれ左上、右上、左下、右下を表します。
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----*
パラメータ
u | アンカーの U 座標 |
---|---|
v | アンカーの V 座標 |
戻り値
- 新しいアンカー セットが設定された
GroundOverlayOptions
オブジェクト。
public GroundOverlayOptions bearing (float bearing)
地面オーバーレイの向きを、北からの時計回りの度数で指定します。回転は、アンカー ポイントを中心として実行されます。指定しない場合のデフォルトは 0 です(つまり、画像上は北を指しています)。
緯度と経度の範囲は回転前に適用されます。
パラメータ
bearing | 角度で表します。範囲 [0, 360)外の値は正規化されます。 |
---|
戻り値
- 新しいベアリング セットが設定された
GroundOverlayOptions
オブジェクト。
public GroundOverlayOptions clickable (boolean clickable)
地面オーバーレイがクリック可能かどうかを指定します。デフォルトのクリック可否は false
です。
パラメータ
クリックできます | クリックの許可に関する新しい設定。 |
---|
戻り値
- クリックの許可設定を新しくした
GroundOverlayOptions
オブジェクトです。
public float getAnchorU ()
水平方向の相対アンカー。0.0
と 1.0
は、それぞれ左端と右端を表します。他のアンカー値は適宜補間されます。
戻り値
- 水平方向のエッジに対するアンカー位置。
public float getAnchorV ()
垂直相対アンカー。0.0
と 1.0
は、それぞれ上端と下端を示します。
他のアンカー値は適宜補間されます。
戻り値
- 垂直方向のエッジを基準としたアンカー位置。
public LatLngBounds getBounds ()
この GroundOverlayOptions
オブジェクトに設定された境界を取得します。
戻り値
- 地面オーバーレイの境界
position(LatLng, float)
またはposition(LatLng, float, float)
を使用して位置を設定した場合は、null
になります。
public BitmapDescriptor getImage ()
この GroundOverlayOptions
オブジェクトに設定された画像記述子を取得します。
戻り値
- 地面オーバーレイの画像を表す
BitmapDescriptor
。
public LatLng getLocation ()
この GroundOverlayOptions
オブジェクトに設定されたロケーションを取得します。
戻り値
- 地面オーバーレイのアンカーを配置する場所。
positionFromBounds(LatLngBounds)
を使用して位置が設定された場合、null
になります。
public GroundOverlayOptions image (BitmapDescriptor imageDescriptor)
この地面オーバーレイの画像を指定します。
画像をテクスチャ(マップ上に画像を描画する)として読み込むには、辺が 2 のべき乗の画像に変換する必要があります。これは、さまざまなズームレベルでテクスチャをレンダリングする mipmap を作成できるようにするためです。詳しくは、Mipmap(Wikipedia)をご覧ください。したがって、この変換を回避してメモリを節約するには、画像の寸法を 2 のべき乗にすることをおすすめします。
パラメータ
imageDescriptor | この地面オーバーレイに使用する BitmapDescriptor |
---|
戻り値
- 新しい画像セットを含むこの
GroundOverlayOptions
オブジェクト。
public boolean isClickable ()
この GroundOverlayOptions
オブジェクトのクリック可能性設定を取得します。
戻り値
- 地面オーバーレイがクリック可能な場合は
true
、そうでない場合はfalse
。
public boolean isVisible ()
この GroundOverlayOptions
オブジェクトの公開設定を取得します。
戻り値
- この地面オーバーレイが表示される場合は
true
、そうでない場合はfalse
。
public GroundOverlayOptions position (LatLng location, float 幅)
アンカー ポイント(LatLng
)と幅(メートル単位)を使用して、この地面オーバーレイの位置を指定します。高さは、アスペクト比を維持するように調整されます。
パラメータ
ロケーション | LatLng 上の指定された画像のアンカー ポイントが固定される地図上の位置。変形(setDimensions、setBearing など)が適用されても、アンカーは地面の位置に固定されたままになります。 |
---|---|
width | オーバーレイの幅(メートル単位)。高さは、画像のアスペクト比に基づいて自動的に決定されます。 |
戻り値
- 新しい位置が設定された
GroundOverlayOptions
オブジェクトです。
例外
IllegalArgumentException | アンカーが null の場合 |
---|---|
IllegalArgumentException | 幅が負の場合 |
IllegalStateException | positionFromBounds(LatLngBounds) を使用して位置がすでに設定されている場合
|
public GroundOverlayOptions position (LatLng の位置、浮動小数点の幅、浮動小数点の高さ)
アンカー ポイント(LatLng
)、幅、高さ(どちらもメートル単位)を使用して、この地面オーバーレイの位置を指定します。レンダリングされると、画像は指定されたサイズに合わせて拡大縮小されます。
パラメータ
ロケーション | LatLng 上の指定された画像のアンカー ポイントが固定される地図上の位置。変形(setDimensions、setBearing など)が適用されても、アンカーは地面の位置に固定されたままになります。 |
---|---|
width | オーバーレイの幅(メートル単位) |
height | オーバーレイの高さ(メートル単位) |
戻り値
- 新しい位置が設定された
GroundOverlayOptions
オブジェクトです。
例外
IllegalArgumentException | アンカーが null の場合 |
---|---|
IllegalArgumentException | 幅と高さが負の値の場合 |
IllegalStateException | positionFromBounds(LatLngBounds) を使用して位置がすでに設定されている場合
|
public GroundOverlayOptions positionFromBounds (LatLngBounds 境界)
この地面オーバーレイの位置を指定します。
パラメータ
bounds | 地面オーバーレイを配置する LatLngBounds |
---|
戻り値
- 新しい位置が設定された
GroundOverlayOptions
オブジェクトです。
例外
IllegalStateException | position(LatLng, float) または position(LatLng, float, float) で位置がすでに設定されている場合
|
---|
public GroundOverlayOptions transparency (float transparency)
地面オーバーレイの透明度を指定します。デフォルトの透明度は 0
(不透明)です。
パラメータ
透明性 | [0..1] の範囲の浮動小数点数。0 は地面オーバーレイが不透明であることを示し、1 は地面オーバーレイが透明であることを意味します。 |
---|
戻り値
- 新しい透過性設定を使用して、この
GroundOverlayOptions
オブジェクトを選択します。
例外
IllegalArgumentException | 透明度が [0..1] の範囲外にある場合。 |
---|
public GroundOverlayOptions visible (boolean visible)
public GroundOverlayOptions zIndex (float zIndex)
地面オーバーレイの zIndex、つまり描画順序を指定します。zIndex の詳細については、このクラスの先頭のドキュメントをご覧ください。
パラメータ
zIndex |
---|
戻り値
- 新しい zIndex が設定されたこの
GroundOverlayOptions
オブジェクト。