GroundOverlay

パブリック ファイナル クラス GroundOverlay オブジェクト
を拡張

地面オーバーレイは、地図に固定されている画像です。地面オーバーレイの特徴は次のとおりです。 プロパティ:

位置
地面オーバーレイの位置を指定するには、次の 2 つの方法があります。 <ph type="x-smartling-placeholder">
    </ph>
  • 位置情報を使用する: 地面オーバーレイの画像（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（visible）です。
クリックされやすさ
ユーザーが地面オーバーレイをクリックしたときに起動されるイベントを処理する場合は、 プロパティを 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));

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

boolean
equals（オブジェクト その他）
この GroundOverlay が別の値と等しいかどうかをテストします。
float
getBearing()
地面オーバーレイの bearing を北からの時計回りの度数で取得します。
LatLngBounds
getBounds()
地面オーバーレイの境界を取得します。
float
getHeight()
地面オーバーレイの高さを取得します。
文字列
getId()
この地面オーバーレイの ID を取得します。
LatLng
getPosition()
アンカー ポイントの位置を取得します。
オブジェクト
getTag()
円のタグを取得します。
float
getTransparency()
この地面オーバーレイの透明度を取得します。
float
getWidth()
地面オーバーレイの幅を取得します。
float
getZIndex()
この地面オーバーレイの zIndex を取得します。
int
hashCode()
boolean
isClickable()
地面オーバーレイのクリック可能性を取得します。
boolean
isVisible()
この地面オーバーレイの可視性を取得します。
void
remove()
地図からこの地面オーバーレイを削除します。
void
setBearing（float bearing）
地面オーバーレイの bearing（地面の垂直軸の方向）を設定します （オーバーレイ ポイント）の角度で表します。
void
setClickable（ブール値のクリック可能）
地面オーバーレイのクリック可能性を設定します。
void
setDimensions（浮動小数点数の幅, 浮動小数点数の高さ）
地面オーバーレイのサイズを設定します。
void
setDimensions（浮動小数点数の幅）
地面オーバーレイの幅を設定します。
void
setImage(BitmapDescriptor imageDescriptor)
地面オーバーレイの画像を設定します。
void
setPosition(LatLng latLng)
アンカー ポイントの位置を変更して、地面オーバーレイの位置を設定します。
void
setPositionFromBounds(LatLngBounds bounds)
指定された LatLngBounds に合わせて地面オーバーレイの位置を設定します。
void
setTag（オブジェクト タグ）
地面オーバーレイのタグを設定します。
void
setTransparency（浮動小数点の透明度）
この地面オーバーレイの透明度を設定します。
void
setVisible(boolean visible)
この地面オーバーレイの表示 / 非表示を設定します。
void
setZIndex（浮動小数点 zIndex）
この地面オーバーレイの zIndex を設定します。

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

パブリック メソッド

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 等しい （オブジェクト その他）

この GroundOverlay が別の値と等しいかどうかをテストします。

パラメータ
その他 Object。
戻り値
  • 両方のオブジェクトが同じオブジェクトの場合、つまり、これは「== other」の場合は true を返します。

<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getBearing ()

地面オーバーレイの bearing を北からの時計回りの度数で取得します。

戻り値
  • 地面オーバーレイの bearing を設定するだけです。

<ph type="x-smartling-placeholder"></ph> 一般公開 LatLngBounds をご覧ください。 getBounds ()

地面オーバーレイの境界を取得します。これにより、地面オーバーレイの回転が無視されます。

戻り値
  • 地面オーバーレイを含む LatLngBounds（回転は無視されます）。

<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getHeight ()

地面オーバーレイの高さを取得します。

戻り値
  • 地面オーバーレイの高さ（メートル単位）。

<ph type="x-smartling-placeholder"></ph> 一般公開 文字列 getId ()

この地面オーバーレイの ID を取得します。この ID は、地図上のすべての GroundOverlay の中で一意になります。

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

<ph type="x-smartling-placeholder"></ph> 一般公開 LatLng をご覧ください。 getPosition ()

アンカー ポイントの位置を取得します。

戻り値
  • 地図上の位置（LatLng）。

<ph type="x-smartling-placeholder"></ph> 一般公開 オブジェクト getTag ()

円のタグを取得します。

戻り値
  • タグが setTag に設定されている場合は、タグ。タグが設定されていない場合は null。

<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getTransparency ()

この地面オーバーレイの透明度を取得します。

戻り値
  • オーバーレイの透明度を指定します。

<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getWidth ()

地面オーバーレイの幅を取得します。

戻り値
  • 地面オーバーレイの幅（メートル単位）。

<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getZIndex ()

この地面オーバーレイの zIndex を取得します。

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

<ph type="x-smartling-placeholder"></ph> 一般公開 整数 hashCode ()

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isClickable ()

地面オーバーレイのクリック可能性を取得します。地面オーバーレイがクリック可能な場合、アプリは GoogleMap.OnGroundOverlayClickListener への通知を受信したときに、 地面オーバーレイをクリックします。イベント リスナーは setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) を通じて登録されます。

戻り値
  • 地面オーバーレイがクリック可能な場合は true。それ以外の場合は false を返します。

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isVisible ()

この地面オーバーレイの可視性を取得します。このメソッドは、地面に地面が移動しているかどうかを オーバーレイは実際には画面上にありますが、カメラの境界内に含まれている場合は描画されるかどうか、 表示されなくなります。

戻り値
  • 表示設定を調整できます。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 削除 ()

地図からこの地面オーバーレイを削除します。地面オーバーレイを除去すると、地面オーバーレイの動作は そのすべてのメソッドが未定義です。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setBearing （浮動小数点方位）

地面オーバーレイの bearing（地面の垂直軸の方向）を設定します （オーバーレイ ポイント）の角度で表します。回転はアンカーを中心に行われる あります

パラメータ
bearing 北からの時計回り方向の角度

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setClickable （クリック可能ブール値）

地面オーバーレイのクリック可能性を設定します。地面オーバーレイがクリック可能な場合、アプリは GoogleMap.OnGroundOverlayClickListener への通知を受信したときに、 地面オーバーレイをクリックします。イベント リスナーは setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) を通じて登録されます。

パラメータ
クリック可能 地面オーバーレイのクリック可能性に関する新しい設定。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setDimensions （浮動小数点数の幅, 浮動小数点数の高さ）

地面オーバーレイのサイズを設定します。画像はサイズに合わせて引き伸ばされます。

パラメータ
幅 幅（メートル単位）
height 身長（メートル）

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setDimensions （浮動小数点数の幅）

地面オーバーレイの幅を設定します。地面オーバーレイの高さは調整され、 アスペクト比を維持する必要があります。

パラメータ
幅 幅（メートル単位）

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setImage （BitmapDescriptor imageDescriptor）

地面オーバーレイの画像を設定します。新しい画像は古い画像と同じ境界になります 説明します。

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

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setPosition （LatLng latLng）

アンカー ポイントの位置を変更して、地面オーバーレイの位置を設定します。保存 その他すべてのプロパティを指定します。

パラメータ
latLng アンカー ポイントを配置する新しい場所である LatLng。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setPositionFromBounds （LatLngBounds 境界）

指定された LatLngBounds に合わせて地面オーバーレイの位置を設定します。この メソッドでは、地面オーバーレイの配置時にその回転（方向指定）は無視されますが、 bearing は描画時に引き続き使用されます。

パラメータ
bounds 地面オーバーレイを配置する LatLngBounds

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setTag （オブジェクト タグ）

地面オーバーレイのタグを設定します。

このプロパティを使用して、任意の Object をこの地面オーバーレイに関連付けることができます。 たとえば Object には、地面オーバーレイが表す内容に関するデータを含めることができます。この 個別の Map<GroundOverlay, Object> を保存するよりも簡単です。別の例として、 データセットの ID に対応する String ID を関連付けることができます。Google Maps SDK for Android では、このプロパティの読み取りも書き込みも行いません。アプリのメモリリークを防ぐため、不要になった場合は setTag(null) を呼び出してタグを消去する必要があります。

パラメータ
タグ null の場合、タグはクリアされます。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setTransparency （浮動小数点数）

この地面オーバーレイの透明度を設定します。このクラスの冒頭のドキュメントをご覧ください。 をご覧ください。

パラメータ
透明性 [0..1] の範囲内の浮動小数点数。0 は地面を示します。 オーバーレイは不透明で、1 は地面オーバーレイが透明であることを表します。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setVisible （ブール値表示）

この地面オーバーレイの表示 / 非表示を設定します。表示されない場合、地面オーバーレイは描画されません。 他のすべてのプロパティは保持されます。

パラメータ
表示 true の場合、地面オーバーレイが表示されます。false の場合、

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setZIndex （浮動小数点数 zIndex）

この地面オーバーレイの zIndex を設定します。詳細については、このクラスの冒頭のドキュメントをご覧ください。 情報です。

パラメータ
zIndex この地面オーバーレイの zIndex