GroundOverlayOptions

public final class GroundOverlayOptions extended Object
validate Parcelable

地面オーバーレイのオプションを定義します。

定数の概要

float NO_DIMENSION 高さのディメンションが指定されていない場合。

継承された定数の概要

パブリック コンストラクタの概要

GroundOverlayOptions()
地面オーバーレイの新しいオプション セットを作成します。

パブリック メソッドの概要

GroundOverlayOptions
anchor(float u, float v)
アンカーを指定します。
GroundOverlayOptions
bearing(フロート ベアリング)
地面オーバーレイの向きを、北からの時計回りの度数で指定します。
GroundOverlayOptions
clickable(boolean clickable)
地面オーバーレイがクリック可能かどうかを指定します。
浮動小数点数
getAnchorU()
水平方向の相対アンカー。0.01.0 は、それぞれ左端と右端を表します。
浮動小数点数
getAnchorV()
垂直方向の相対アンカー。0.01.0 は、それぞれ上端と下端を示します。
浮動小数点数
getBearing()
この GroundOverlayOptions オブジェクトのベアリング セットを取得します。
LatLngBounds
getBounds()
この GroundOverlayOptions オブジェクトに設定された境界を取得します。
浮動小数点数
getHeight()
この GroundOverlayOptions オブジェクトに設定された高さを取得します。
BitmapDescriptor
getImage()
この GroundOverlayOptions オブジェクトに設定された画像記述子を取得します。
LatLng
getLocation()
この GroundOverlayOptions オブジェクトに設定されたロケーションを取得します。
浮動小数点数
getTransparency()
この GroundOverlayOptions オブジェクトに設定されている透明度を取得します。
浮動小数点数
getWidth()
この GroundOverlayOptions オブジェクトに設定された幅を取得します。
浮動小数点数
getZIndex()
この GroundOverlayOptions オブジェクトに設定された zIndex を取得します。
GroundOverlayOptions
imageBitmapDescriptor imageDescriptor)
この地面オーバーレイの画像を指定します。
ブール値
isClickable()
この GroundOverlayOptions オブジェクトのクリック可能性設定を取得します。
ブール値
isVisible()
この GroundOverlayOptions オブジェクトの公開設定を取得します。
GroundOverlayOptions
positionLatLng の位置、浮動小数点数の幅)
アンカー ポイント(LatLng)と幅(メートル単位)を使用して、この地面オーバーレイの位置を指定します。
GroundOverlayOptions
positionLatLng の位置、浮動小数点数の幅、浮動小数点数の高さ)
アンカー ポイント(LatLng)、幅、高さ(どちらもメートル単位)を使用して、この地面オーバーレイの位置を指定します。
GroundOverlayOptions
positionFromBoundsLatLngBounds 境界)
この地面オーバーレイの位置を指定します。
GroundOverlayOptions
transparency(浮動小数点透明度)
地面オーバーレイの透明度を指定します。
GroundOverlayOptions
visible(ブール値を表示)
地面オーバーレイの可視性を指定します。
GroundOverlayOptions
zIndex(float zIndex)
地面オーバーレイの zIndex、つまり描画順序を指定します。

継承されたメソッドの概要

定数

public static final float NO_DIMENSION

高さのディメンションが指定されていない場合。

定数値: -1.0

パブリック コンストラクタ

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 座標
戻り値

public GroundOverlayOptions bearing (float bearing)

地面オーバーレイの向きを、北からの時計回りの度数で指定します。回転は、アンカー ポイントを中心として実行されます。指定しない場合のデフォルトは 0 です(つまり、画像上は北を指しています)。

緯度と経度の範囲は回転前に適用されます。

パラメータ
bearing 角度で表します。範囲 [0, 360)外の値は正規化されます。
戻り値

public GroundOverlayOptions clickable (boolean clickable)

地面オーバーレイがクリック可能かどうかを指定します。デフォルトのクリック可否は false です。

パラメータ
クリックできます クリックの許可に関する新しい設定。
戻り値

public float getAnchorU ()

水平方向の相対アンカー。0.01.0 は、それぞれ左端と右端を表します。他のアンカー値は適宜補間されます。

戻り値
  • 水平方向のエッジに対するアンカー位置。

public float getAnchorV ()

垂直相対アンカー。0.01.0 は、それぞれ上端と下端を示します。 他のアンカー値は適宜補間されます。

戻り値
  • 垂直方向のエッジを基準としたアンカー位置。

public float getBearing ()

この GroundOverlayOptions オブジェクトのベアリング セットを取得します。

戻り値
  • 地面オーバーレイの方向指定。

public LatLngBounds getBounds ()

この GroundOverlayOptions オブジェクトに設定された境界を取得します。

戻り値

public float getHeight ()

この GroundOverlayOptions オブジェクトに設定された高さを取得します。

戻り値
  • 地面オーバーレイの高さ。

public BitmapDescriptor getImage ()

この GroundOverlayOptions オブジェクトに設定された画像記述子を取得します。

戻り値

public LatLng getLocation ()

この GroundOverlayOptions オブジェクトに設定されたロケーションを取得します。

戻り値
  • 地面オーバーレイのアンカーを配置する場所。positionFromBounds(LatLngBounds) を使用して位置が設定された場合、null になります。

public float getTransparency ()

この GroundOverlayOptions オブジェクトに設定されている透明度を取得します。

戻り値
  • 地面オーバーレイの透明度

public float getWidth ()

この GroundOverlayOptions オブジェクトに設定された幅を取得します。

戻り値
  • 地面オーバーレイの幅。

public float getZIndex ()

この GroundOverlayOptions オブジェクトに設定された zIndex を取得します。

戻り値
  • 地面オーバーレイの zIndex。

public GroundOverlayOptions image BitmapDescriptor imageDescriptor)

この地面オーバーレイの画像を指定します。

画像をテクスチャ(マップ上に画像を描画する)として読み込むには、辺が 2 のべき乗の画像に変換する必要があります。これは、さまざまなズームレベルでテクスチャをレンダリングする mipmap を作成できるようにするためです。詳しくは、Mipmap(Wikipedia)をご覧ください。したがって、この変換を回避してメモリを節約するには、画像の寸法を 2 のべき乗にすることをおすすめします。

パラメータ
imageDescriptor この地面オーバーレイに使用する BitmapDescriptor
戻り値

public boolean isClickable ()

この GroundOverlayOptions オブジェクトのクリック可能性設定を取得します。

戻り値
  • 地面オーバーレイがクリック可能な場合は true、そうでない場合は false

public boolean isVisible ()

この GroundOverlayOptions オブジェクトの公開設定を取得します。

戻り値
  • この地面オーバーレイが表示される場合は true、そうでない場合は false

public GroundOverlayOptions position LatLng location, float 幅)

アンカー ポイント(LatLng)と幅(メートル単位)を使用して、この地面オーバーレイの位置を指定します。高さは、アスペクト比を維持するように調整されます。

パラメータ
ロケーション LatLng 上の指定された画像のアンカー ポイントが固定される地図上の位置。変形(setDimensions、setBearing など)が適用されても、アンカーは地面の位置に固定されたままになります。
width オーバーレイの幅(メートル単位)。高さは、画像のアスペクト比に基づいて自動的に決定されます。
戻り値
例外
IllegalArgumentException アンカーが null の場合
IllegalArgumentException 幅が負の場合
IllegalStateException positionFromBounds(LatLngBounds) を使用して位置がすでに設定されている場合

public GroundOverlayOptions position LatLng の位置、浮動小数点の幅、浮動小数点の高さ)

アンカー ポイント(LatLng)、幅、高さ(どちらもメートル単位)を使用して、この地面オーバーレイの位置を指定します。レンダリングされると、画像は指定されたサイズに合わせて拡大縮小されます。

パラメータ
ロケーション LatLng 上の指定された画像のアンカー ポイントが固定される地図上の位置。変形(setDimensions、setBearing など)が適用されても、アンカーは地面の位置に固定されたままになります。
width オーバーレイの幅(メートル単位)
height オーバーレイの高さ(メートル単位)
戻り値
例外
IllegalArgumentException アンカーが null の場合
IllegalArgumentException 幅と高さが負の値の場合
IllegalStateException positionFromBounds(LatLngBounds) を使用して位置がすでに設定されている場合

public GroundOverlayOptions positionFromBounds LatLngBounds 境界)

この地面オーバーレイの位置を指定します。

パラメータ
bounds 地面オーバーレイを配置する LatLngBounds
戻り値
例外
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)

地面オーバーレイの可視性を指定します。デフォルトの公開設定は true です。

パラメータ
表示
戻り値

public GroundOverlayOptions zIndex (float zIndex)

地面オーバーレイの zIndex、つまり描画順序を指定します。zIndex の詳細については、このクラスの先頭のドキュメントをご覧ください。

パラメータ
zIndex
戻り値