GroundOverlay

地面オーバーレイは、地図に固定されている画像です。地面オーバーレイには次の特性があります。

位置

地面オーバーレイの位置を指定するには、次の 2 つの方法があります。

• 場所を使用する場合: 地面オーバーレイの画像、アンカーが固定される LatLng、オーバーレイの幅（メートル単位）を指定する必要があります。アンカーは、デフォルトでは画像の上から 50%、左から 50% の位置に配置されます。これは変更できます。必要に応じて、オーバーレイの高さ（メートル単位）を指定できます。オーバーレイの高さを指定しなかった場合は、画像のアスペクト比を保持するよう高さが自動的に計算されます。
• 境界の使用: 画像を格納する LatLngBounds を指定する必要があります。

地面オーバーレイの位置は、地図に追加する前に指定する必要があります。指定していないと、地面オーバーレイが地図に追加されたときに IllegalArgumentException がスローされます。また、GroundOverlayOptions オブジェクト内で位置を指定する際は、これらのメソッドのいずれか 1 つを使用する必要があります。そうしないと、2 つ目のメソッドを使用して位置を指定すると IllegalStateException がスローされます。

画像

このオーバーレイに使用する画像（BitmapDescriptor 形式）。画像は指定された位置に合わせて拡大縮小されます。地面オーバーレイを地図に追加する前に、画像を指定する必要があります。指定していない場合、地図に追加されたときに IllegalArgumentException がスローされます。

bearing

画像を時計回りに回転させる量。回転の中心が画像のアンカーになります。これは省略可能で、デフォルトの bearing は 0 です。つまり、画像は上が北になるように調整されます。

zIndex

この地面オーバーレイが他のオーバーレイに対して描画される順序（Polyline と TileOverlay を含むが、Marker は除く）。zIndex が大きいオーバーレイは、zIndex が小さいオーバーレイの上に描画されます。zIndex 値が同じオーバーレイの順序は任意です。これは省略可能で、デフォルトの zIndex は 0 です。

透明性

範囲 [0..1] における地面オーバーレイの透明度。0 はオーバーレイが不透明であることを示し、1 はオーバーレイが完全に透明であることを意味します。指定したビットマップがすでに部分的に透明になっている場合、それに応じて各ピクセルの透明度がスケーリングされます（たとえば、ビットマップのピクセルのアルファ値が 200 で、地面オーバーレイの透明度を 0.25 に指定した場合、ピクセルはアルファ値が 150 の画面上にレンダリングされます）。このプロパティの指定は任意であり、デフォルトの透明度は 0（不透明）です。

公開設定

地面オーバーレイを表示するか非表示にするか（つまり、地図上に描画されるかどうか）を指定します。非表示の地面オーバーレイは描画されませんが、他のすべてのプロパティを保持します。これは省略可能です。デフォルトの公開設定は true（表示可能）です。

クリックされやすさ

地面オーバーレイがクリックされたときに発生するイベントを処理する場合は、このプロパティを true に設定します。この値はいつでも変更できます。デフォルトは false です。このプロパティが true に設定されている場合、アプリは、setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) を通じて登録された GoogleMap.OnGroundOverlayClickListener に通知を受信します。

タグ

地面オーバーレイに関連付けられた Object。たとえば Object には、地面オーバーレイの内容に関するデータを含めることができます。この方法は、個別の Map<GroundOverlay, Object> を保存するよりも簡単です。別の例として、データセットの ID に対応する String ID を関連付けることができます。Google Maps SDK for Android は、このプロパティの読み取りも書き込みも行いません。

このクラスのメソッドは、Android UI スレッドで呼び出す必要があります。そうしないと、実行時に IllegalStateException がスローされます。

例

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));