GroundOverlay

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

位置

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

• 位置情報を使用: 地面オーバーレイの画像、アンカーを固定する LatLng、オーバーレイの幅（メートル単位）を指定する必要があります。アンカーはデフォルトで、画像の上部から 50%、画像の左側から 50% です。この設定は変更できます。オーバーレイの高さをメートル単位で指定することもできます。オーバーレイの高さを指定しない場合は、画像の割合が維持されるように自動的に計算されます。
• 境界を使用する: 画像を含む LatLngBounds を指定する必要があります。

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

画像

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

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));